📄
Webhosting

Configurer et paramétrer PHP-FPM pour votre site web

📅 10 novembre 2026 ✏️ 10 novembre 2026 ⏱ 6 min leestijd

PHP-FPM assure des sites web plus rapides et plus stables. Découvrez comment le configurer, comprendre les principaux paramètres et résoudre les problèmes courants.

PHP-FPM (FastCGI Process Manager) est la manière dont votre serveur traite les requêtes PHP. Bien configuré, il assure des temps de chargement plus rapides et moins d’erreurs en cas d’affluence. Dans cet article, découvrez ce que fait PHP-FPM, quels réglages ont réellement de l’impact et comment résoudre les problèmes courants comme les erreurs 502 ou les réponses lentes.

Qu’est-ce que PHP-FPM et pourquoi l’utiliser

PHP-FPM est un processus qui exécute le code PHP indépendamment de votre serveur web (comme Nginx ou LiteSpeed). Au lieu que chaque visiteur démarre un nouveau processus PHP, FPM maintient un pool de « processus workers » prêts à traiter les requêtes directement. Cela économise du temps de démarrage et vous donne le contrôle sur la quantité de mémoire et de processus que PHP peut utiliser.

L’alternative, mod_php, exécute PHP en tant que partie intégrante d’Apache. Cela fonctionne, mais c’est moins flexible et souvent plus lent avec de nombreux visiteurs simultanés. Pratiquement tous les environnements d’hébergement modernes, y compris l’hébergement web avec LiteSpeed, utilisent donc PHP-FPM ou une variante similaire (LSAPI) sous le capot.

Principaux paramètres PHP-FPM expliqués

La configuration de PHP-FPM se trouve généralement dans un fichier de pool, par exemple /etc/php/8.x/fpm/pool.d/www.conf. Ces paramètres déterminent le comportement :

  • pm : le type de processus de gestion. Généralement dynamic (les processus sont ajustés à la hausse et à la baisse) ou ondemand (les processus ne démarrent qu’à la réception d’une requête, utile en cas de faible trafic).
  • pm.max_children : le nombre maximum de processus PHP simultanés. Une valeur trop basse entraîne des temps d’attente ou des erreurs 502 en cas d’affluence, une valeur trop élevée peut saturer la mémoire de votre serveur.
  • pm.start_servers : le nombre de processus prêts immédiatement au démarrage.
  • pm.min_spare_servers et pm.max_spare_servers : la marge de processus inactifs que FPM maintient pour absorber les pics.
  • pm.max_requests : après combien de requêtes un worker redémarre. Cela évite les fuites de mémoire dues à un code peu soigné.
  • request_terminate_timeout : après combien de secondes un script PHP bloqué est interrompu.
💡 Astuce : calculez pm.max_children en fonction de la mémoire disponible divisée par la consommation moyenne de mémoire par processus PHP (visible via votre monitoring ou avec ps aux), plutôt que de copier un chiffre fixe trouvé sur internet.

Configurer PHP-FPM : plan par étapes

Voici comment adapter les paramètres en toute sécurité sur un serveur Linux :

1

Ouvrez le fichier de configuration du pool

Allez dans le dossier de votre version PHP, par exemple /etc/php/8.2/fpm/pool.d/www.conf, et ouvrez le fichier avec un éditeur de texte comme nano ou vim.

2

Ajustez pm et les processus enfants

Définissez pm = dynamic et saisissez des valeurs réalistes pour max_children, start_servers, min_spare_servers et max_spare_servers en fonction des ressources de votre serveur.

3

Définissez les timeouts et max_requests

Réglez pm.max_requests sur une valeur entre 500 et 1000 et request_terminate_timeout sur quelques secondes au-dessus de la durée d’exécution attendue de vos scripts.

4

Testez la configuration

Vérifiez la syntaxe avec php-fpm -t avant de redémarrer, afin de ne pas provoquer de temps d’arrêt à cause d’une faute de frappe.

5

Redémarrez le service PHP-FPM

Redémarrez le service avec par exemple systemctl restart php8.2-fpm et vérifiez son statut avec systemctl status php8.2-fpm.

Si vous utilisez Plesk, vous pouvez aussi ajuster beaucoup de ces paramètres par domaine via l’interface, sans devoir plonger dans les fichiers de configuration. C’est plus pratique si vous gérez plusieurs sites web.

Résoudre les problèmes courants

La plupart des problèmes PHP-FPM se répartissent en quelques catégories :

  • 502 Bad Gateway en cas d’affluence : cela indique souvent un pm.max_children réglé trop bas, ce qui fait que le serveur web ne trouve plus de worker disponible. Augmentez le nombre de processus ou vérifiez si votre serveur dispose de suffisamment de mémoire.
  • Le site web réagit lentement sous faible charge : vérifiez que pm.start_servers et min_spare_servers ne sont pas trop bas, ce qui obligerait à démarrer sans cesse de nouveaux processus.
  • L’utilisation de la mémoire augmente constamment : réduisez pm.max_requests pour que les workers redémarrent plus souvent et réduisent le risque de fuites de mémoire.
  • Les scripts se bloquent ou expirent : vérifiez request_terminate_timeout et consultez le slowlog de PHP-FPM (slowlog et request_slowlog_timeout dans le fichier de pool) pour voir quels scripts s’exécutent trop longtemps.

En cas de doute, consultez toujours d’abord les journaux d’erreurs de PHP-FPM et de votre serveur web. Vous y trouverez généralement précisément quelle limite a été atteinte.

Questions fréquentes

PHP-FPM est-il toujours meilleur que mod_php ?

Pour la plupart des sites web modernes, oui, car il gère les ressources serveur de manière plus flexible et économique, surtout avec plusieurs sites web sur un seul serveur.

Quelle version de PHP dois-je utiliser ?

Choisissez toujours une version de PHP activement prise en charge et compatible avec votre CMS ou framework. Les versions plus anciennes ne reçoivent plus de mises à jour de sécurité.

Puis-je ajuster les paramètres PHP-FPM sur un hébergement mutualisé ?

Cela dépend de votre offre et de votre panneau de contrôle. Dans Plesk, vous pouvez souvent gérer vous-même certains paramètres liés à FPM par domaine.

Que se passe-t-il si max_children est trop élevé ?

Votre serveur peut alors autoriser trop de processus simultanément, ce qui peut épuiser la mémoire disponible et ralentir l’ensemble du serveur au lieu de n’affecter que ce seul site web.

Conclusion

Bien configurer PHP-FPM est une question d’équilibre : suffisamment de processus pour l’affluence, mais pas au point de manquer de mémoire sur votre serveur. Commencez avec des valeurs réalistes basées sur les ressources de votre serveur, testez toujours la configuration avant de redémarrer, et surveillez les journaux en cas de problème. Si vous êtes bloqué, notre support se fera un plaisir de vous aider.

Découvrir l’hébergement web →

Was dit artikel nuttig?