PyHP

Pyhp-Interpreter

PYHP adalah paket yang memungkinkan Anda untuk menyematkan kode Python seperti kode PHP ke dalam HTML dan file teks lainnya. Skrip dipanggil oleh konfigurasi server web atau shebang dan berkomunikasi dengan server web melalui WSGI.

Fitur:

• Parser untuk menyematkan kode python dalam html
• Sekelompok fitur PHP yang diimplementasikan dalam Python
• Struktur modular untuk memungkinkan penggunaan fitur di luar penerjemah
• Penyelarasan Kode Otomatis untuk Keterbacaan yang lebih baik
• caching

Cara kerjanya:

Sintaksis

• Seperti PHP, kode Python terkandung dalam tag <?pyhp dan ?>
• Bagian kode diizinkan untuk memiliki indentasi awal untuk keterbacaan yang lebih baik di dalam (misalnya) file html
• Tidak seperti PHP, setiap bagian kode kode harus memiliki sintaks yang valid sendiri
  • jika pernyataan atau loop tidak dapat menjangkau beberapa bagian kode

Runtime

• konstanta level modul diatur dan memungkinkan introspeksi sumber jika backend mendukungnya
• exit dan sys.exit Akhiri skrip, bukan seluruh server
• atexit Fungsi terdaftar tidak dipanggil sampai server shutdown dalam mode WSGI
• Karena pernyataan coba tidak dapat menjangkau beberapa bagian kode tindakan pembersihan harus dieksekusi dengan register_shutdown_function

Penggunaan

• bisa digunakan untuk
• Skrip CLI dengan perintah pyhp-cli
• Skrip CGI dengan menggunakan perintah pyhp-cgi
• Server WSGI dengan menggunakan submodule pyhp.wsgi.apps
• Jika tidak ada nama yang diberikan, program ini dibaca dari stdin, kalau tidak ia menggunakan nama untuk memuat kode dari backend yang dikonfigurasi

Aplikasi

• menjalankan kode dan menangkap outputnya
• Berikan kode dengan antarmuka
• tersedia untuk lingkungan tunggal dan multi-utara
• dapat dibangun oleh pabrik yang terkandung dalam submodule pyhp.wsgi.util

Antarmuka

• bertindak sebagai antarmuka antara gateway WSGI dan skrip
• tersedia sebagai pembungkus WSGI tipis atau antarmuka gaya PHP

Antarmuka PHP

• Fitur PHP berikut tersedia:
  • $_SERVER sebagai SERVER
  • $_REQUEST sebagai REQUEST
  • $_GET as GET
  • $_POST sebagai POST
  • $_COOKIE sebagai COOKIE
  • $_FILES sebagai FILES
  • http_response_code
  • header
  • headers_list
  • header_remove
  • headers_sent
  • header_register_callback dengan tambahan argumen replace kunci untuk mendaftarkan beberapa panggilan balik
  • setcookie dengan argumen kata kunci samesite tambahan
  • setrawcookie juga dengan argumen kata kunci samesite tambahan
  • register_shutdown_function dengan pesanan eksekusi panggilan balik terbalik (LIFO)
  • opcache_compile_file yang meningkatkan pengecualian alih -alih mengembalikan False saat kompilasi gagal
  • opcache_invalidate
  • opcache_is_script_cached
  • opcache_reset

File konfigurasi

• adalah toml yang valid
• dicari di lokasi -lokasi ini (tidak ada penggabungan yang terjadi, file pertama menang):
  • jalan yang diberikan oleh argumen -c atau --config CLI
  • jalur yang ditunjuk oleh variabel lingkungan PYHPCONFIG
  • ~/.config/pyhp.toml
  • /etc/pyhp.toml
• meningkatkan RuntimeError jika tidak ditemukan

Backend

• mengimplementasikan pengambilan kode atau menghias backend lainnya untuk menambahkan caching IA
• bertindak sebagai wadah untuk sumber kode
• Bentuk hierarki yang dikonfigurasi di pyhp.toml
• terkandung di dalam pyhp.backends
• dapat berinteraksi dengan melalui pyhp-backend atau python3 -m pyhp.backends perintah cli

Instalasi

Bagian ini menunjukkan kepada Anda cara menginstal PYHP di komputer Anda. Jika Anda ingin menggunakan skrip PYHP di situs web Anda oleh CGI, Anda juga harus mengaktifkan CGI di server web Anda.

Sama seperti paket Python

1. Bangun paket python pyhp-core dengan python3 setup.py bdist_wheel
2. Selesai! Anda sekarang dapat memasang roda yang terkandung di direktori dist dengan pip

• Opsional: Atur variabel lingkungan PYHPCONFIG atau salin pyhp.toml ke salah satu lokasi file konfigurasi untuk menggunakan perintah cli

Paket Debian

1. Jalankan debian/build_deb.sh di direktori root proyek.
2. Selesai! Anda sekarang dapat menginstal paket Debian dengan sudo dpkg -i python3-pyhp-core_{version}-1_all.deb

• Opsional: Periksa apakah paket yang disarankan python3-toml dan python3-werkzeug diinstal untuk menggunakan perintah CLI
• Penting: pyhp-backend clear akan dieksekusi pada uninstall atau upgrade jika backend adalah cache, ingat ini saat menggunakan jalur yang berisi ~ untuk cache file

Secara manual

1. Instal paket PyHP-Core Python
2. Atur variabel lingkungan PYHPCONFIG atau salin pyhp.toml ke salah satu lokasi file konfigurasi
3. Selesai! Anda sekarang dapat menggunakan perintah pyhp-*

Contoh WSGI

Secara manual

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

Dari file konfigurasi

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