PyHP

PYHP互换

PYHP是一个程序包，可让您将Python代码（如PHP代码）嵌入HTML和其他文本文件中。通过Web服务器的配置或Shebang调用脚本，并通过WSGI与Web服务器进行通信。

特征：

• 解析器嵌入HTML中的Python代码
• Python实现的一堆PHP功能
• 模块化结构以允许使用解释器之外的功能
• 自动代码对齐，以提高可读性
• 缓存

它的工作原理：

句法

• 像php一样，python代码包含在<?pyhp和?>标签中
• 允许代码部分具有起始凹痕，以使其内部（例如）HTML文件更高的可读性
• 与PHP不同，代码的每个代码部分都必须具有自己的有效语法
  • 如果仪表或循环无法跨越多个代码部分

运行时

• 设置了模块级常数，如果后端支持它，则可以进行内省
• exit和sys.exit终止脚本，而不是整个服务器
• atexit注册功能直到在WSGI模式下服务器关闭直到服务器关闭
• 由于尝试语句不能跨越多个代码部分的清理操作，应由register_shutdown_function执行

用法

• 可用于
• 带有pyhp-cli命令的CLI脚本
• 使用pyhp-cgi命令使用CGI脚本
• WSGI服务器使用pyhp.wsgi.apps subpodule
• 如果没有给出名称，则该程序是从stdin读取的，否则它使用该名称从配置的后端加载代码

应用

• 执行代码并捕获其输出
• 为代码提供接口
• 可用于单线和多线程环境
• 可以由pyhp.wsgi.util subpoule中的工厂构建

接口

• 充当WSGI网关和脚本之间的接口
• 可作为薄WSGI包装纸或PHP式接口可用

PHP接口

• 可用以下PHP功能：
  • $_SERVER作为SERVER
  • $_REQUEST作为REQUEST
  • $_GET as GET
  • $_POST作为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命令与

安装

本节向您展示了如何在计算机上安装PYHP。如果您想通过CGI在网站上使用PYHP脚本，则必须在Web服务器中启用CGI。

就像Python包装

1. 使用python3 setup.py bdist_wheel构建PYHP核Python软件包
2. 完毕！现在，您可以使用PIP安装在DIST目录中包含的车轮

• 可选：设置PYHPCONFIG Environ变量或将pyhp.toml复制到配置文件位置之一以使用CLI命令

Debian包

1. 在项目的根目录中执行debian/build_deb.sh 。
2. 完毕！现在，您可以使用sudo dpkg -i python3-pyhp-core_{version}-1_all.deb安装debian软件包-i python3-pyhp-core_

• 可选：检查推荐的包装python3-toml和python3-werkzeug是否已安装以使用CLI命令
• 重要的是： pyhp-backend clear将在卸载或升级上执行，如果后端是缓存，请在使用包含~的文件缓存的路径时请记住这一点

手动

1. 安装PYHP核Python软件包
2. 将PYHPCONFIG ENVOREN变量设置或将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 ()