PyHP

Pyhp-Interpreter

O PYHP é um pacote que permite incorporar o código Python, como o código PHP no HTML e outros arquivos de texto. Um script é chamado pela configuração do servidor da web ou por um shebang e se comunica com o servidor da Web via WSGI.

Características:

• Analisador para incorporar código Python em html
• Um monte de recursos PHP implementados no Python
• estrutura modular para permitir o uso de recursos fora do intérprete
• Alinhamento de código automático para melhorar a legibilidade
• cache

Como funciona:

Sintaxe

• Como o PHP, o código Python está contido nas tags <?pyhp e ?>
• As seções de código podem ter um recuo inicial para melhor legibilidade dentro (por exemplo) arquivos HTML
• Ao contrário do PHP, cada seção de código do código deve ter uma sintaxe válida
  • Se-states ou loops não podem abranger várias seções de código

Tempo de execução

• As constantes de nível de módulo são definidas e permitem a introspecção da fonte se o back -end o suportar
• exit e sys.exit encerrar o script, não todo o servidor
• As funções registradas atexit não são chamadas até o desligamento do servidor no modo WSGI
• Como as declarações de tentativa não podem abranger várias seções de código que as ações de limpeza devem ser executadas pelo register_shutdown_function

Uso

• pode ser usado para
• Scripts da CLI com o comando pyhp-cli
• Scripts CGI usando o comando pyhp-cgi
• Servidores WSGI usando o submódulo pyhp.wsgi.apps
• Se nenhum nome for dado, o programa está lendo a partir de stdin, caso contrário, ele está usando o nome para carregar o código do back -end configurado

Aplicativos

• executar o código e capturar sua saída
• Forneça o código com uma interface
• estão disponíveis para ambientes únicos e multithread
• pode ser construído por fábricas contidas no submódulo pyhp.wsgi.util

Interfaces

• Atuar como uma interface entre o gateway WSGI e o script
• estão disponíveis como embalagens finas de WSGI ou interfaces no estilo PHP

Interface PHP

• Os seguintes recursos do PHP estão disponíveis:
  • $_SERVER como SERVER
  • $_REQUEST como REQUEST
  • $_GET AS GET
  • $_POST como POST
  • $_COOKIE como COOKIE
  • $_FILES como FILES
  • http_response_code
  • header
  • headers_list
  • header_remove
  • headers_sent
  • header_register_callback com um argumento de palavra -chave replace adicional para registrar vários retornos de chamada
  • setcookie com um argumento de palavra -chave samesite adicional
  • setrawcookie também com um argumento adicional de palavras -chave samesite
  • register_shutdown_function com ordem de execução de retorno de chamada reversa (LIFO)
  • opcache_compile_file que levanta exceções em vez de retornar False quando a compilação falha
  • opcache_invalidate
  • opcache_is_script_cached
  • opcache_reset

Arquivo de configuração

• é válido Toml
• é procurado nesses locais (não ocorre a fusão, o primeiro arquivo vence):
  • O caminho dado pelo argumento -c ou --config cli
  • O caminho apontado pela variável de ambiente PYHPCONFIG
  • ~/.config/pyhp.toml
  • /etc/pyhp.toml
• levanta um RuntimeError se não for encontrado

Back -end

• Implementar a recuperação do código ou decorar outros back -end para adicionar cache de IA
• agir como recipientes para o código
• forma uma hierarquia configurada em pyhp.toml
• estão contidos dentro de pyhp.backends
• pode ser interagido por meio do pyhp-backend ou python3 -m pyhp.backends CLI Comandos

Instalação

Esta seção mostra como instalar o PYHP no seu computador. Se você deseja usar scripts PYHP em seu site pelo CGI, também deve ativar o CGI no seu servidor da web.

Assim como o pacote Python

1. Construa o pacote python pyhp-core com python3 setup.py bdist_wheel
2. Feito! Agora você pode instalar a roda contida no diretório Dist com PIP

• Opcional: defina a variável PYHPCONFIG ambient ou copie pyhp.toml como um dos locais de arquivo de configuração para usar os comandos da CLI

Pacote Debian

1. Execute debian/build_deb.sh no diretório raiz do projeto.
2. Feito! Agora você pode instalar o pacote Debian com sudo dpkg -i python3-pyhp-core_{version}-1_all.deb

• Opcional: verifique se os pacotes recomendados python3-toml e python3-werkzeug estão instalados para usar os comandos da CLI
• IMPORTANTE: pyhp-backend clear será executado em desinstalação ou atualização se o back-end for um cache, lembre-se disso ao usar caminhos contendo ~ para o cache do arquivo

Manualmente

1. Instale o pacote python pyhp-core
2. Defina a variável Environ PYHPCONFIG ou copie Pyhp.toml como um dos locais de arquivo de configuração
3. Feito! Agora você pode usar os comandos pyhp-*

Exemplo WSGI

Manualmente

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

De um arquivo de configuração

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