FrankenPHP für PHP-Entwickler #

Diese Seite richtet sich an PHP-Entwickler, deren Code möglicherweise von FrankenPHP ausgeliefert wird, dem Webserver Caddy mit in eine Binärdatei kompiliertem PHP, den exp:velocity steuern kann (--engine=frankenphp). FrankenPHP ist die produktionsreife Alternative zur empfohlenen Engine qbix. Für PHP-Code verhält es sich wie PHP-FPM. Der vollständige Betriebsleitfaden ist FrankenPHP als Web-Engine von Exponential.

Inhalt #

1. Klassischer Modus: ein sauberer Zustand pro Anfrage
2. Die drei Engines im Vergleich
3. Das eingebettete PHP
4. Für einen Test starten
5. Was Sie in Ihrem Code prüfen sollten

Klassischer Modus: ein sauberer Zustand pro Anfrage #

FrankenPHP führt PHP im klassischen Modus aus: ein Pool von PHP-Threads in einem Prozess, wobei jede Anfrage von einem sauberen Zustand ausgeht, genau wie unter PHP-FPM. Der Worker-Modus, in dem ein PHP-Skript über Anfragen hinweg lebendig bleibt, wird bewusst nicht angeboten, weil der Kernel Anfragezustand in globalen Variablen hält und eine Anfrage in die nächste durchsickern lassen würde. Für Ihren Code bedeutet das: Die Fallen durch statischen Zustand bei persistenten Workern gelten unter FrankenPHP nicht (Fallen durch statischen Zustand), und Sie zahlen die Bootstrap-Kosten bei jeder Anfrage, wie unter PHP-FPM.

Die drei Engines im Vergleich #

Code auf frankenphp oder php neben qbix zu testen trennt Fehler in Ihrem Code von Zustand, der zwischen Anfragen erhalten bleibt (Velocity-Engines).

Das eingebettete PHP #

FrankenPHP bringt sein eigenes PHP und seine eigenen Erweiterungen mit; es liest nicht die php.ini der Maschine. Einstellungen kommen aus settings/velocity.ini:

Zwei Folgen für Entwickler:

• MySQL braucht einen ausdrücklichen Socket. Ohne php.ini der Maschine gibt es keinen Standard-MySQL-Socket; setzen Sie ihn in IniOptions[], sonst schlagen Datenbankverbindungen fehl (§6.1 des Leitfadens).
• Die Erweiterungen sind die der Binärdatei. Eine PHP-Erweiterung, die Ihr Code braucht, muss im Build von FrankenPHP enthalten sein, nicht nur im PHP der Maschine; lesen Sie den Leitfaden, bevor Sie sich auf eine verlassen.

Für einen Test starten #

php bin/php/console exp:velocity install --engine=frankenphp --check
php bin/php/console exp:velocity start --engine=frankenphp
php bin/php/console exp:velocity status --all
php bin/php/console exp:velocity stop --engine=frankenphp

install lädt ein festgelegtes Release herunter und prüft seine SHA-256-Prüfsumme, bevor es überhaupt ausgeführt wird. Die Engine lauscht auf eigenen Ports (standardmäßig [FrankenPHPSettings] Port=8089, HTTPSPort=8444), sodass sie neben der Engine qbix läuft. Das Caddyfile wird bei jedem Start aus velocity.ini erzeugt (var/vc/frankenphp/run/Caddyfile); Logs liegen unter var/vc/frankenphp/log. Die Engine-Klasse ist expVelocityFrankenPHP (kernel/classes/expvelocityfrankenphp.php).

Was Sie in Ihrem Code prüfen sollten #

• Kein Verlass auf Worker-Zustand. Code, der nur funktioniert, weil eine statische Eigenschaft überlebt hat (ein in einer früheren Anfrage vorgewärmter Cache), ist hier langsamer oder falsch; Code, der hier korrekt und unter qbix falsch ist, hält Zustand, den er nicht halten sollte.
• Pfade und das Wurzelverzeichnis. Wie überall: EXP_ROOT_DIR oder eZSys::rootDir(), keine aus einer Kernel-Datei abgeleiteten Pfade (Das Engine-Archiv (phar) für PHP-Entwickler).
• Fehler. display_errors ist in dieser Engine standardmäßig aus; lesen Sie PHP-Fehler in den Logs und in der Debug-Leiste.

Verwandte Seiten #

• FrankenPHP als Web-Engine von Exponential
• Persistente Velocity-Worker für PHP-Entwickler
• Befehle für Webserver und Solr
• Freie Dokumentation: diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.