
En bref
|
FrankenPHP propose une autre façon d’exécuter PHP. En mode worker, ton application se lance une seule fois et reste en mémoire, traitant les requêtes les unes après les autres sans redémarrer à chaque fois. Pour les applications conçues pour ça, ça peut se traduire par des temps de réponse plus courts et moins de ressources de calcul pour un trafic identique.
Pour y parvenir, il fallait devenir ta propre équipe de gestion du runtime : assembler FrankenPHP toi-même, dimensionner manuellement les workers et les threads, configurer le profilage et veiller à ce que tout soit correctement mis à jour. FrankenPHP est désormais un runtime géré sur Upsun, tu n’as donc plus à t’en occuper.
Jusqu’à présent, exécuter FrankenPHP sur Upsun passait par une image composable : tu ajoutais FrankenPHP en tant que paquet, puis tu écrivais et gérais ta propre commande de démarrage. Les parties spécifiques à FrankenPHP de cette configuration ressemblaient à ça (version abrégée) :
applications:
app:
type: "composable:<version>"
stack:
packages:
- "frankenphp"
web:
commands:
start: frankenphp php-server --worker $PLATFORM_DOCUMENT_ROOT/index.php --listen=localhost:$PORT --root=$PLATFORM_DOCUMENT_ROOTDésormais, tu définis le type de runtime, et Upsun se charge de compiler, de patcher et d’optimiser FrankenPHP pour ton conteneur :
applications:
app:
type: frankenphp:1.8.5Les versions 1.8.2 à 1.8.5 te donnent respectivement PHP 8.2 à 8.5, et suivent la politique de fin de vie de PHP. L’image tourne en production sur Upsun depuis août 2026, et le site de documentation de Blackfire lui-même fonctionne dessus avec PHP 8.5.
FrankenPHP ne rend pas automatiquement toutes les applications plus rapides. Le mode classique fonctionne comme PHP-FPM. Le principal gain de performances provient du mode worker, où les applications conçues pour ce mode restent en mémoire entre les requêtes.
Le mode classique est le mode par défaut. Il traite chaque requête comme le fait PHP-FPM, donc ton application fonctionne sans changement. Il te permet de bénéficier dès aujourd’hui d’un environnement d’exécution FrankenPHP pris en charge et à jour, sans modification du code, et te laisse le choix d’adopter le mode worker quand tu le souhaites.
C’est en mode worker que les gains peuvent être significatifs. La Fondation PHP, citant une analyse de Sylius, la plateforme de e-commerce, fait état de temps de réponse réduits d’environ 80 % et d’un nombre de machines plus de six fois inférieur en mode worker. Ce sont leurs chiffres, mesurés dans leurs conditions. Upsun n’a pas encore publié ses propres tests de performance, et les résultats dépendent de ton application et de la taille de ton conteneur.
Comme l’application reste en mémoire, son état y reste aussi. Les variables statiques, les propriétés statiques de classe, les variables globales et les caches en mémoire persistent d’une requête à l’autre. Symfony, Laravel et Yii intègrent FrankenPHP ; d’autres applications peuvent nécessiter une logique de nettoyage. La documentation du mode worker de FrankenPHP explique ce qu’il faut réinitialiser entre les requêtes, et Igor, un outil d’analyse statique tiers conçu pour le mode worker de FrankenPHP, peut t’aider à auditer une application Symfony avant de basculer.
La taille du conteneur a aussi son importance. Une configuration worker optimisée pour plusieurs cœurs n’aura guère l’occasion de montrer toute sa valeur sur une petite instance ne disposant que d’une fraction de CPU.
Une approche judicieuse consiste à commencer en mode classique, à profiler avec Blackfire, puis à passer en mode worker lorsque les chiffres te le conseillent.
Le runtime FrankenPHP géré est disponible sur les projets Flex et Fixed sans frais supplémentaires. Comme pour tous les runtimes sur Upsun, tu paies les ressources utilisées par ton conteneur.
Deux choses à savoir avant de commencer. New Relic n’est pas pris en charge car son extension PHP ne dispose pas d’une version thread-safe et ne peut pas être chargée dans FrankenPHP ; Blackfire est le profileur pris en charge. Si tu utilises déjà FrankenPHP sur l’image Composable, ton application continue de fonctionner telle quelle, et tu peux passer au runtime géré quand tu le souhaites. Il n’y a pas encore de guide de migration.
Définis le type dans la configuration de ton application, puis déploie-la. Consulte la documentation de FrankenPHP pour connaître les options de configuration, notamment le mode worker.