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