PyHP

PYHP-Interpreter

PYHP هي حزمة تتيح لك تضمين رمز Python مثل رمز PHP في HTML والملفات النصية الأخرى. يتم استدعاء البرنامج النصي إما عن طريق تكوين خادم الويب أو shebang ويتواصل مع خادم الويب عبر WSGI.

سمات:

• محلل لتضمين كود بيثون في HTML
• مجموعة من ميزات PHP التي تم تنفيذها في بيثون
• بنية معيارية للسماح باستخدام الميزات خارج المترجم
• محاذاة رمز تلقائي لتحسين القراءة
• التخزين المؤقت

كيف تعمل:

بناء الجملة

• مثل PHP ، يوجد رمز Python ضمن علامات <?pyhp و ?>
• يُسمح لأقسام الرموز أن يكون لها مسافة بادئة لبدء لتحسين قابلية القراءة داخل (على سبيل المثال) ملفات HTML
• على عكس PHP ، يجب أن يكون لكل قسم من كود الرمز بناء جملة صالح خاص به
  • لا يمكن أن تتمكن الاختبارات أو الحلقات

وقت التشغيل

• يتم تعيين ثوابت مستوى الوحدة النمطية وتسمح بتأمل المصدر إذا كانت الواجهة الخلفية تدعمها
• exit و sys.exit إنهاء البرنامج النصي ، وليس الخادم بأكمله
• لا يتم استدعاء وظائف atexit المسجلة حتى إيقاف تشغيل الخادم في وضع WSGI
• نظرًا لأن عبارات المحاولة لا يمكن أن تمتد على أقسام رمز متعددة ، يجب تنفيذ إجراءات التنظيف بواسطة register_shutdown_function

الاستخدام

• يمكن استخدامه ل
• البرامج النصية CLI مع أمر pyhp-cli
• البرامج النصية CGI باستخدام أمر pyhp-cgi
• خوادم WSGI باستخدام الجهاز الفرعي pyhp.wsgi.apps
• إذا لم يتم تقديم اسم ، فإن البرنامج يقرأ من stdin ، وإلا فهو يستخدم الاسم لتحميل رمز من الواجهة الخلفية المكوّنة

التطبيقات

• تنفيذ الكود والتقاط إخراجه
• توفير الرمز بواجهة
• متوفرة لبيئات واحدة ومتعددة الخيوط
• يمكن أن يتم بناؤها بواسطة المصانع الواردة في pyhp.wsgi.util submodule

واجهات

• تعمل كواجهة بين بوابة WSGI والسيناريو
• متوفرة كأغلفة WSGI رقيقة أو واجهات على غرار PHP

واجهة PHP

• تتوفر ميزات PHP التالية:
  • $_SERVER SERVER
  • $_REQUEST REQUEST
  • $_GET كما 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

ملف التكوين

• هو تومل صالح
• يتم البحث عنه في هذه المواقع (لا يوجد دمج ، يفوز الملف الأول):
  • المسار الذي قدمه حجة -c أو --config cli
  • يشير المسار إلى متغير بيئة PYHPCONFIG
  • ~/.config/pyhp.toml
  • /etc/pyhp.toml
• يرفع RuntimeError إذا لم يتم العثور عليه

الخلفية

• قم بتنفيذ استرداد الرمز أو تزيين الخلفية الأخرى لإضافة التخزين المؤقت
• تعمل كحاويات للدولة
• تشكيل تسلسل هرمي تم تكوينه في pyhp.toml
• موجودة داخل pyhp.backends
• يمكن التفاعل معه عبر أوامر pyhp-backend أو python3 -m pyhp.backends CLI

تثبيت

يوضح لك هذا القسم كيفية تثبيت PYHP على جهاز الكمبيوتر الخاص بك. إذا كنت ترغب في استخدام البرامج النصية PYHP على موقع الويب الخاص بك بواسطة CGI ، فعليك تمكين CGI بالإضافة إلى ذلك في خادم الويب الخاص بك.

تماما مثل حزمة بيثون

1. بناء حزمة Pyhp-Core Python مع python3 setup.py bdist_wheel
2. منتهي! يمكنك الآن تثبيت العجلة الموجودة في Distory مع PIP

• اختياري: اضبط متغير PYHPCONFIG Environ أو نسخ pyhp.toml على أحد مواقع ملفات التكوين لاستخدام أوامر CLI

حزمة دبيان

1. تنفيذ debian/build_deb.sh في الدليل الجذر للمشروع.
2. منتهي! يمكنك الآن تثبيت حزمة Debian باستخدام sudo dpkg -i python3-pyhp-core_{version}-1_all.deb

• اختياري: تحقق مما إذا تم تثبيت الحزم الموصى بها python3-toml و python3-werkzeug لاستخدام أوامر CLI
• هام: سيتم تنفيذ pyhp-backend clear عند إلغاء التثبيت أو الترقية إذا كانت الواجهة الخلفية عبارة عن ذاكرة التخزين المؤقت ، تذكر ذلك عند استخدام مسارات ~

يدويًا

1. قم بتثبيت حزمة Pyhp-Core Python
2. اضبط متغير PYHPCONFIG Environ أو نسخ 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 ()