• Docs
  • Talk to an expert
Blog
Blog
BlogProduitÉtudes de casNouvellesPerspectives
Blog

Exécute FrankenPHP sur Upsun, sans avoir à gérer le runtime

FrankenPHPPHPBlackfireperformanceautoscaling
18 novembre 2026
Partager
Cette page a été rédigée en anglais par nos experts, puis traduite par une IA pour vous y donner accès rapidement! Pour la version originale, c’est par ici.

En bref

  • FrankenPHP est désormais un environnement d'exécution géré sur Upsun pour PHP 8.2 à 8.5.
  • Définis le type : frankenphp:1.8.5, puis déploie. Le runtime est géré et optimisé pour toi par Upsun.
  • Le mode Classic est le mode par défaut et fonctionne comme PHP-FPM (FastCGI Process Manager). Le mode Worker est pris en charge pour les applications conçues pour ce mode.
  • Disponible sur les projets Flex et Fixed sans frais supplémentaires.

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.

D’une configuration faite main à un type de runtime

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_ROOT

Dé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.5

Les 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.

Ce qu’Upsun te facilite

  • Pas de réglage manuel des workers. La taille des workers et des threads est automatiquement adaptée au CPU et à la mémoire de ton conteneur, avec des paramètres par défaut optimisés que tu peux étendre grâce à ta propre configuration de FrankenPHP et de Caddy.
  • Moins de maintenance en cours d’exécution. Les mises à jour de sécurité et les correctifs d’exécution sont intégrés à l’image gérée ; ton équipe n’a donc pas besoin de suivre les versions de FrankenPHP ni de gérer sa propre version.
  • Profilage sans configuration. Les identifiants Blackfire et la sonde de profilage sont fournis automatiquement, y compris en mode worker, ce qui te permet de mesurer l’impact de n’importe quelle modification. Le profilage continu est pris en charge lorsqu’il est activé sur le projet.
  • Mise à l'échelle automatique dans les deux modes. La mise à l'échelle automatique d'Upsun fonctionne aussi bien en mode classique qu'en mode worker.

Mode classique ou mode worker ?

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.

Ce que le mode worker exige de ton application

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.

Disponibilité et tarifs

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.

Pour commencer

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.

Restez informé

Abonnez-vous à notre newsletter mensuelle pour les dernières mises à jour et nouvelles.

Déployez en toute liberté.
Essayez Upsun gratuitement.

Développez avec DispatchDéployez avec Cloud