PyHP

Pyhp-interprendedor

PYHP es un paquete que le permite incrustar el código de Python como el código PHP en HTML y otros archivos de texto. La configuración del servidor web o un shebang o se comunica con el servidor web a través del servidor web a través de WSGI.

Características:

• Parser para incrustar el código Python en HTML
• Un montón de características de PHP implementadas en Python
• Estructura modular para permitir el uso de características fuera del intérprete
• Alineación de código automático para una mejor legibilidad
• almacenamiento en caché

Cómo funciona:

Sintaxis

• Al igual que PHP, el código Python está contenido dentro de las etiquetas <?pyhp y ?>
• Las secciones de código pueden tener una sangría inicial para una mejor legibilidad en el interior (por ejemplo) archivos HTML
• A diferencia de PHP, cada sección de código de código debe tener una sintaxis válida propia
  • Si las declaraciones o bucles no pueden abarcar múltiples secciones de código

Tiempo de ejecución

• Las constantes de nivel de módulo se establecen y permiten la introspección de origen si el backend lo admite
• exit y sys.exit termina el script, no todo el servidor
• Las funciones registradas de atexit no se llaman hasta el cierre del servidor en modo WSGI
• Dado que las declaraciones de prueba no pueden abarcar múltiples secciones de código, las acciones de limpieza deben ejecutarse mediante register_shutdown_function

Uso

• se puede usar para
• Scripts de CLI con el comando pyhp-cli
• Scripts CGI utilizando el comando pyhp-cgi
• Servidores WSGI utilizando el submódulo pyhp.wsgi.apps
• Si no se da nombre, el programa está leyendo desde Stdin, de lo contrario, está utilizando el nombre para cargar código desde el backend configurado

Aplicaciones

• ejecutar código y capturar su salida
• Proporcionar el código una interfaz
• están disponibles para entornos individuales y múltiples
• puede ser construido por fábricas contenidas en el submódulo pyhp.wsgi.util

Interfaces

• actuar como una interfaz entre la puerta de enlace de WSGI y el guión
• están disponibles como envoltorios WSGI delgados o interfaces de estilo PHP

Interfaz PHP

• Las siguientes funciones de PHP están disponibles:
  • $_SERVER como SERVER
  • $_REQUEST como REQUEST
  • $_GET como GET
  • $_POST como POST
  • $_COOKIE como COOKIE
  • $_FILES como FILES
  • http_response_code
  • header
  • headers_list
  • header_remove
  • headers_sent
  • header_register_callback con un argumento de palabras clave replace adicional para registrar múltiples devoluciones de llamada
  • setcookie con un argumento de palabras clave samesite adicional
  • setrawcookie también con un argumento adicional de palabras clave samesite
  • register_shutdown_function con la orden de ejecución de devolución de llamada invertida (LIFO)
  • opcache_compile_file que plantea excepciones en lugar de devolver False cuando falla la compilación
  • opcache_invalidate
  • opcache_is_script_cached
  • opcache_reset

Archivo de configuración

• es válido
• se busca en estas ubicaciones (no se realiza la fusión, el primer archivo gana):
  • La ruta dada por el argumento -c o --config cli
  • La ruta apuntada por la variable de entorno PYHPCONFIG
  • ~/.config/pyhp.toml
  • /etc/pyhp.toml
• eleva un RuntimeError si no se encuentra

Backends

• Implementar la recuperación del código o decorar otros backends para agregar el almacenamiento en caché de IA
• Actuar como contenedores para CodeSources
• formar una jerarquía configurada en pyhp.toml
• están contenidos dentro de pyhp.backends
• se puede interactuar con los comandos CLI pyhp-backend o python3 -m pyhp.backends

Instalación

Esta sección le muestra cómo instalar PYHP en su computadora. Si desea utilizar scripts PYHP en su sitio web por CGI, debe habilitar adicionalmente CGI en su servidor web.

Así como el paquete de python

1. Construya el paquete Pyhp-Core Python con python3 setup.py bdist_wheel
2. ¡Hecho! Ahora puede instalar la rueda contenida en el directorio DIST con PIP

• Opcional: configure la variable PYHPCONFIG Environ o copie pyhp.toml en una de las ubicaciones de archivos de configuración para usar los comandos CLI

Paquete Debian

1. Ejecutar debian/build_deb.sh en el directorio raíz del proyecto.
2. ¡Hecho! Ahora puede instalar el paquete Debian con sudo dpkg -i python3-pyhp-core_{version}-1_all.deb

• Opcional: verifique si los paquetes recomendados se instalan python3-toml y python3-werkzeug para usar los comandos CLI
• IMPORTANTE: pyhp-backend clear se ejecutará en desinstalación o actualización Si el backend es un caché, recuerde esto cuando use rutas que contienen ~ para el caché del archivo

A mano

1. Instale el paquete Pyhp-Core Python
2. Establezca la variable PYHPCONFIG Environ o copie pyhp.toml en una de las ubicaciones de archivos de configuración
3. ¡Hecho! Ahora puedes usar los comandos pyhp-*

Ejemplo de WSGI

A mano

    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 ()

Desde un archivo de configuración

  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 ()