FrankenPHP : un serveur d'applications moderne pour PHP

D'après leur documentation, FrankenPHP est 3,5 fois plus rapide que PHP FPM. Il a atteint une release stable depuis, et il vaut clairement la peine d'être testé en développement local.

Alors, à quoi ressemble un vrai site dessus ? Lançons une installation Joomla complète pour le découvrir.

Ce que FrankenPHP vous apporte​

Un site Joomla complet, en https, servi par FrankenPHP, démarré en deux commandes :

Vous ne verrez peut-être pas de gain de vitesse spectaculaire sur votre machine puisque vous êtes le seul visiteur, mais c'est agréable de se dire qu'on surfe aussi vite en local.

Maintenant, la partie honnête du contrat, avant de vous lancer :

Pourquoi ça fonctionne​

• FrankenPHP est un serveur d'applications PHP moderne construit sur le serveur web Caddy : un seul processus sert PHP et gère le https, au lieu du classique duo « le serveur web parle à PHP-FPM ».
• Comme il garde le runtime PHP vivant entre les requêtes, ses auteurs le mesurent jusqu'à 3,5 fois plus rapide que PHP-FPM.
• Vous n'avez rien à assembler : Alexandre Elisé publie une image FrankenPHP + Joomla prête à l'emploi, donc toute la mise en place tient dans un fichier compose.yaml et un docker compose up.

Le mettre en route​

Je vous invite à jouer avec sur votre machine de développement (sauf si vous avez vos propres serveurs ; vous ne pourrez certainement pas utiliser FrankenPHP chez votre hébergeur).

Rendez-vous par exemple dans votre dossier /tmp/joomla et créez le fichier compose.yaml ci-dessous. La source du projet est https://github.com/alexandreelise/frankenphp-joomla et le fichier readme Getting Started d'Alexandre couvre les autres façons de le lancer.

services:

  joomla:
    image: alexandreelise/frankenphp-joomla:hardened-mysql-0.1.1?
    restart: always
    ports:
      - 80:80?
      - 443:443
    environment:
      - MYSQL_ROOT_PASSWORD=test
      - JOOMLA_DB_HOST=db?
      - JOOMLA_DB_USER=exampleuser
      - JOOMLA_DB_PASSWORD=examplepass
      - JOOMLA_DB_NAME=exampledb
    volumes:
      - joomla:/app/public?
    depends_on:?
      - db

  db:
    image: mysql:8.2
    environment:
      - MYSQL_DATABASE=exampledb
      - MYSQL_USER=exampleuser
      - MYSQL_PASSWORD=examplepass
      - MYSQL_ROOT_PASSWORD=test
    volumes:
      - db:/var/lib/mysql?

volumes:?
  joomla:
  db:

En lançant docker compose pull, Docker va télécharger les deux images ; celle avec FrankenPHP et Joomla et celle pour MySQL. Selon la vitesse de votre connexion Internet, cela prendra quelques secondes ; uniquement la première fois.

Ensuite, il ne vous reste plus qu'à créer les containers basés sur les images en lançant docker compose up.

Ce qui se passe pendant ces longues minutes​

Vous allez commencer à recevoir des messages de logs dans la console (parce qu'ici, pour l'illustration, vous n'avez pas utilisé le flag --detach) :

La raison est que Joomla va essayer de se connecter à MySQL alors que le container MySQL n'est pas prêt à accepter les connexions. Vous verrez donc défiler beaucoup de [ERROR] Connection refused. Restez patient et, après un moment, vous obtiendrez ceci :

Quand tout s'est bien déroulé, rendez-vous simplement sur https://localhost:443 pour voir votre site Joomla tourner sur FrankenPHP. Pour accéder à la page d'administration, allez sur https://localhost:443/administrator. Les identifiants à utiliser se retrouvent dans les logs, comme indiqué par la flèche rouge sur l'image ci-dessus. Vous pouvez aussi les récupérer avec cette commande : docker compose logs | grep -i "Here are your Joomla credentials:".

Sous le capot (passez votre chemin si vous voulez juste l'utiliser)​

Ces lignes Connection refused ne sont pas un problème FrankenPHP : c'est l'erreur classique du « mon container est démarré, donc mon service est prêt ». Un container démarré n'est pas une base de données qui accepte les connexions, et rien dans docker compose up ne fait la différence.

C'est exactement le problème que les healthchecks résolvent ; Obtenez les informations de santé de vos containers en cours d'exécution montre comment savoir si un container est vraiment prêt, et pas seulement démarré.

Conclusion​

Pour une machine de développement locale, FrankenPHP vaut le détour : une seule image, du https directement, et un runtime PHP qui reste chaud entre les requêtes. Le prix à payer, c'est un premier démarrage qui prend un bon quart d'heure ; après ça, docker compose up est instantané.

Si vous préférez avoir un site Joomla qui tourne tout de suite avec la stack classique Apache + PHP-FPM, Démarrer Joomla avec Docker en quelques clics vous y amène en deux minutes.