PyHP

Interprétérants PYHP

PYHP est un package qui vous permet d'intégrer le code Python comme le code PHP dans HTML et d'autres fichiers texte. Un script est appelé soit par la configuration du serveur Web ou un Shebang et communique avec le serveur Web via WSGI.

Caractéristiques:

• Analyseur pour intégrer le code python en html
• Un tas de fonctionnalités PHP implémentées dans Python
• Structure modulaire pour permettre l'utilisation de fonctionnalités en dehors de l'interprète
• Alignement automatique du code pour une amélioration de la lisibilité
• mise en cache

Comment ça marche:

Syntaxe

• Comme PHP, le code Python est contenu dans les balises <?pyhp et ?>
• Les sections de code peuvent avoir une indentation de départ pour une meilleure lisibilité à l'intérieur (par exemple) des fichiers HTML
• Contrairement à PHP, chaque section de code de code doit avoir une syntaxe valide
  • si des stades ou des boucles ne peuvent pas courir plusieurs sections de code

Temps d'exécution

• Les constantes de niveau de module sont définies et permettent une introspection source si le backend le prend en charge
• exit et sys.exit terminez le script, pas l'ensemble du serveur
• Les fonctions enregistrées atexit ne sont pas appelées avant l'arrêt du serveur en mode WSGI
• Étant donné que les instructions d'essai ne peuvent pas s'étendre sur plusieurs sections de code, les actions de nettoyage doivent être exécutées par register_shutdown_function

Usage

• peut être utilisé pour
• Scripts CLI avec la commande pyhp-cli
• Scripts CGI en utilisant la commande pyhp-cgi
• Serveurs WSGI en utilisant le sous-module pyhp.wsgi.apps
• Si aucun nom n'est donné, le programme lit à partir de stdin, sinon il utilise le nom pour charger le code à partir du backend configuré

Applications

• Exécuter du code et capturer sa sortie
• Fournir au code une interface
• sont disponibles pour les environnements uniques et multi-thread
• Peut être construit par des usines contenues dans le sous-module pyhp.wsgi.util

Interfaces

• agir comme une interface entre la passerelle WSGI et le script
• sont disponibles sous forme de minces emballages WSGI ou d'interfaces de style PHP

Interface PHP

• Les fonctionnalités PHP suivantes sont disponibles:
  • $_SERVER comme SERVER
  • $_REQUEST comme REQUEST
  • $_GET comme GET
  • $_POST comme POST
  • $_COOKIE comme COOKIE
  • $_FILES comme FILES
  • http_response_code
  • header
  • headers_list
  • header_remove
  • headers_sent
  • header_register_callback avec un argument de mot clé replace supplémentaire pour enregistrer plusieurs rappels
  • setcookie avec un argument de mot-clé samesite supplémentaire
  • setrawcookie également avec un argument de mot-clé samesite supplémentaire
  • register_shutdown_function avec l'ordre d'exécution de rappel inversé (LIFO)
  • opcache_compile_file qui soulève des exceptions au lieu de retourner False lorsque la compilation échoue
  • opcache_invalidate
  • opcache_is_script_cached
  • opcache_reset

Fichier de configuration

• est valide Toml
• est recherché dans ces endroits (aucune fusion n'a lieu, le premier fichier gagne):
  • Le chemin donné par l'argument -c ou --config CLI
  • Le chemin indiqué par la variable d'environnement PYHPCONFIG
  • ~/.config/pyhp.toml
  • /etc/pyhp.toml
• augmente une RuntimeError si elle n'est pas trouvée

Backends

• implémenter la récupération de code ou décorer d'autres backend pour ajouter de la mise en cache IA
• agir comme des conteneurs pour codesources
• former une hiérarchie configurée dans pyhp.toml
• sont contenus à l'intérieur pyhp.backends
• peut être interagi avec via les commandes CLI pyhp-backend ou python3 -m pyhp.backends

Installation

Cette section vous montre comment installer PYHP sur votre ordinateur. Si vous souhaitez utiliser les scripts PYHP sur votre site Web par CGI, vous devez en outre activer CGI dans votre serveur Web.

Tout comme le package Python

1. Construisez le package PYHP-core Python avec python3 setup.py bdist_wheel
2. Fait! Vous pouvez désormais installer la roue contenue dans le répertoire DIST avec PIP

• Facultatif: Définissez la variable environnement PYHPCONFIG ou copiez PYHP.toml sur l'un des emplacements de fichiers de configuration pour utiliser les commandes CLI

Paquet debian

1. Exécutez debian/build_deb.sh dans le répertoire racine du projet.
2. Fait! Vous pouvez maintenant installer le package Debian avec sudo dpkg -i python3-pyhp-core_{version}-1_all.deb

• Facultatif: Vérifiez si les packages recommandés python3-toml et python3-werkzeug sont installés pour utiliser les commandes CLI
• IMPORTANT: pyhp-backend clear sera exécuté sur la désinstallation ou la mise à niveau si le backend est un cache, n'oubliez pas cela lorsque vous utilisez des chemins contenant ~ pour le cache de fichier

Manuellement

1. Installez le package PYHP-core Python
2. Définissez la variable environnement PYHPCONFIG ou copiez PYHP.toml sur l'un des emplacements des fichiers de configuration
3. Fait! Vous pouvez maintenant utiliser les commandes pyhp-*

Exemple WSGI

Manuellement

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

À partir d'un fichier de configuration

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