PyHP

pyhp-interpreter

PYHPは、PHPコードなどのPythonコードを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スクリプト
• pyhp.wsgi.appsサブモジュールを使用して、WSGIサーバー
• 名前が指定されていない場合、プログラムはstdinから読み取りされています。

アプリ

• コードを実行し、その出力をキャプチャします
• インターフェイスをコードに提供します
• 単一およびマルチスレッド環境で利用できます
• pyhp.wsgi.utilサブモジュールに含まれる工場で構築できます

インターフェイス

• WSGIゲートウェイとスクリプトの間のインターフェイスとして機能する
• 薄いWSGIラッパーまたはPHPスタイルのインターフェイスとして利用できます

PHPインターフェイス

• 次のPHP機能が利用可能です。
  • SERVERとしての$_SERVER
  • $_REQUEST as REQUEST
  • $_GET as 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キャッシュを追加します
• CodeSourcesのコンテナとして機能します
• pyhp.tomlで構成された階層を形成します
• pyhp.backends内に含まれています
• pyhp-backendまたはpython3 -m pyhp.backends cliコマンドを介してやり取りすることができます

インストール

このセクションでは、コンピューターにPYHPをインストールする方法を示します。 CGIのWebサイトでPYHPスクリプトを使用する場合は、WebサーバーでさらにCGIを有効にする必要があります。

Pythonパッケージとして

1. python3 setup.py bdist_wheelでpyhp-core pythonパッケージを構築します
2. 終わり！これで、PIPでDistディレクトリに含まれるホイールをインストールできます

• オプション： PYHPCONFIG環境変数を設定するか、 pyhp.tomlを構成ファイルの場所のいずれかにコピーして、CLIコマンドを使用します

Debianパッケージ

1. プロジェクトのルートディレクトリでdebian/build_deb.shを実行します。
2. 終わり！ sudo dpkg -i python3-pyhp-core_{version}-1_all.debでDebianパッケージをインストールできるようになりました

• オプション：推奨されるパッケージpython3-tomlおよびpython3-werkzeugがCLIコマンドを使用するかどうかを確認します
• 重要： pyhp-backend clearアンインストールまたはアップグレード時に実行されます~

手動で

1. PYHP-Core Pythonパッケージをインストールします
2. 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 ()