PyHP

PYHP-Interpreter

PYHP - это пакет, который позволяет вам встраивать код Python, например, PHP -код в HTML и другие текстовые файлы. Сценарий называется либо конфигурацией веб -сервера, либо в Shebang, и общается с веб -сервером через WSGI.

Функции:

• Счастчик для встраивания кода Python в HTML
• куча функций PHP, реализованного в Python
• модульная структура, позволяющая использовать функции за пределами интерпретатора
• Автоматическое выравнивание кода для улучшения читаемости
• кэширование

Как это работает:

Синтаксис

• Как PHP, код Python содержится в тегах <?pyhp и ?>
• Разделам кода разрешено иметь начальное вдавливание для лучшей читаемости внутри (например) HTML -файлов
• В отличие от PHP, каждый раздел кода должен иметь свой собственный синтаксис
  • Если Statements или Cyples не могут охватывать несколько разделов кода

Время выполнения

• Константы уровня модуля устанавливаются и позволяют исходному самоанализу, если бэкэнд поддерживает его
• exit и sys.exit прекращает сценарий, а не весь сервер
• Зарегистрированные функции atexit не вызываются до выключения сервера в режиме WSGI
• Поскольку операторы TRY не могут охватывать несколько разделов кода Действия очистки должны быть выполнены с помощью register_shutdown_function

Использование

• может быть использован для
• Сценарии CLI с командой pyhp-cli
• Сценарии CGI с использованием команды pyhp-cgi
• Серверы WSGI с использованием pyhp.wsgi.apps Submodule
• Если имя не указано, программа читает из Stdin, иначе она использует имя для загрузки кода из настроенного бэкэнда

Приложения

• выполнить код и захватить его вывод
• предоставить код интерфейс
• доступны для одиночных и многопоточных средств
• может быть построен фабриками, содержащимися в pyhp.wsgi.util

Интерфейсы

• действовать как интерфейс между шлюзом WSGI и сценарием
• доступны как тонкие обертки WSGI или интерфейсы в стиле PHP

Интерфейс PHP

• Доступны следующие функции PHP:
  • $_SERVER как SERVER
  • $_REQUEST как REQUEST
  • $_GET как GET
  • $_POST As POST
  • $_COOKIE как COOKIE
  • $_FILES как FILES
  • http_response_code
  • header
  • headers_list
  • header_remove
  • headers_sent
  • header_register_callback с дополнительным аргументом replace ключевого слова для регистрации нескольких обратных вызовов
  • setcookie с дополнительным аргументом ключевого слова samesite
  • setrawcookie также с дополнительным аргументом ключевого слова samesite
  • register_shutdown_function с обратным порядком выполнения обратного вызова (LIFO)
  • opcache_compile_file , который повышает исключения вместо возврата False , когда компиляция не сбои
  • opcache_invalidate
  • opcache_is_script_cached
  • opcache_reset

Файл конфигурации

• является действительным Toml
• ищет в этих местах (слияние не происходит, первый файл выигрывает):
  • Путь, данное аргументом -c или --config cli
  • Путь, на который указан переменная среды PYHPCONFIG
  • ~/.config/pyhp.toml
  • /etc/pyhp.toml
• поднимает RuntimeError , если не найдено

Бэкэнды

• реализовать поиск кода или украсить другие бэкэнды, чтобы добавить кэширование IA
• действовать как контейнеры для кодов
• образуйте иерархию, настроенную в pyhp.toml
• содержатся внутри pyhp.backends
• можно взаимодействовать с помощью pyhp-backend или python3 -m pyhp.backends cli Commands

Установка

В этом разделе показано, как установить PYHP на ваш компьютер. Если вы хотите использовать сценарии PYHP на своем веб -сайте CGI, вы должны дополнительно включить CGI в свой веб -сервер.

Как и пакет Python

1. Создайте пакет PYHP-Core Python с python3 setup.py bdist_wheel
2. Сделанный! Теперь вы можете установить колесо, содержащееся в дистанционном каталоге с PIP

• Необязательно: Установите переменную Environ Environment PYHPCONFIG или копировать pyhp.toml в одно из местоположений файлов конфигурации, чтобы использовать команды CLI

Debian Package

1. Выполнить debian/build_deb.sh в корневом каталоге проекта.
2. Сделанный! Теперь вы можете установить пакет Debian с sudo dpkg -i python3-pyhp-core_{version}-1_all.deb

• Необязательно: проверьте, установлены ли рекомендуемые пакеты python3-toml и python3-werkzeug для использования команд CLI
• ВАЖНО: pyhp-backend clear будет выполняться при удалении или обновлении, если бэкэнд является кэшем, помните об этом при использовании путей, содержащих ~ для кеша файла

Вручную

1. Установите пакет PYHP-Core Python
2. Установите переменную Environ Environment PYHPCONFIG или копировать pyhp.toml в одно из местоположений файла конфигурации
3. Сделанный! Теперь вы можете использовать команды pyhp-*

Пример WSGI

Вручную

    import sys
    import re
    import tempfile
    from wsgiref . simple_server import make_server
    from pyhp . compiler import parsers , util , generic
    from pyhp . backends . files import Directory
    from pyhp . wsgi . apps import ConcurrentWSGIApp
    from pyhp . wsgi . proxys import LocalStackProxy
    from pyhp . wsgi . interfaces . php import PHPWSGIInterfaceFactory
    from pyhp . wsgi . interfaces . phputils import UploadStreamFactory


    compiler = util . Compiler (
        parsers . RegexParser (
            re . compile ( r"<?pyhps" ),
            re . compile ( r"s?>" )
        ),
        util . Dedenter (
            generic . GenericCodeBuilder ( - 1 )
        )
    )

    interface_factory = PHPWSGIInterfaceFactory (
        200 ,
        [( "Content-type" , "text/html; charset= " UTF-8 " " )],
        None ,
        ( "GET" , "POST" , "COOKIE" ),
        8000000 ,
        UploadStreamFactory (
            tempfile . gettempdir (),
            20
        )
    )

    sys . stdout = proxy = LocalStackProxy ( sys . stdout )

    with Directory ( "." , compiler ) as backend :
        with ConcurrentWSGIApp ( "tests/embedding/syntax.pyhp" , backend , proxy , interface_factory ) as app :
            with make_server ( "" , 8000 , app ) as httpd :
                httpd . serve_forever ()

Из файла конфигурации

  from wsgiref . simple_server import make_server
  import toml
  from pyhp . wsgi . util import ConcurrentWSGIAppFactory


  config = toml . load ( "pyhp.toml" )

  with ConcurrentWSGIAppFactory . from_config ( config ) as factory :
      with factory . app ( "tests/embedding/syntax.pyhp" ) as app :
          with make_server ( "" , 8000 , app ) as httpd :
              httpd . serve_forever ()