Vous avez lancé sudo systemctl restart php8.3-fpm sur un serveur Ubuntu ou Debian et reçu Failed to restart php8.3-fpm.service: Unit php8.3-fpm.service not found. en retour. Ou encore, systemctl status php8.3-fpm a répondu Unit php8.3-fpm.service could not be found. Ça arrive surtout après une réinstallation de PHP, une mise à niveau qui a changé sa version ou un changement de source. Le site WordPress renvoie alors souvent des erreurs 502 ou 503. Vérifiez quatre choses dans cet ordre, parce que l’une d’elles est presque toujours en cause. PHP 8.3 est-il là, son paquet -fpm est-il installé, le service est-il masqué, et le serveur Web pointe-t-il encore vers le socket de l’ancienne version?
Ce que vous allez accomplir
- Voir quelles versions de PHP et quels services PHP-FPM le serveur possède vraiment, plutôt que ceux que vous croyez avoir.
- Réinstaller
php8.3-fpmavec les mêmes extensions qu’avant, tirées de la liste de paquets de l’ancienne version. - Transférer les réglages de pool personnalisés de l’ancienne version vers la nouvelle.
- Pointer nginx ou Apache vers le nouveau socket et recharger les deux services dans un ordre sûr.
- Confirmer qu’une page WordPress répond
200et qu’elle est servie par PHP 8.3 par PHP-FPM.
Prérequis
- Un accès root ou
sudopar SSH à un serveur Ubuntu ou Debian qui fait tourner WordPress derrière nginx ou Apache. - Les exemples prennent PHP 8.3 comme version voulue et PHP 8.1 comme ancienne version. C’est la paire que vous obtenez après un
do-release-upgraded’Ubuntu 22.04, livré avec PHP 8.1, vers Ubuntu 24.04, livré avec PHP 8.3. Debian 12 est livré avec PHP 8.2. Remplacez les numéros par les vôtres. - Si vous ajoutez des versions de PHP d’une source tierce, c’est le PPA ondrej/php (une archive de paquets personnelle) sur Ubuntu ou packages.sury.org sur Debian. La même personne maintient les deux.
- Une sauvegarde récente des fichiers et de la base de données du site. Rien ici n’efface de données, mais une mise à niveau qui a retiré PHP a pu changer autre chose aussi.
- Cet article sert à réparer une installation existante. Pour une première installation, consultez installer PHP-FPM sur Ubuntu.
Comment ça fonctionne
Sur Debian et Ubuntu, chaque version de PHP a son propre service FPM. PHP-FPM, le gestionnaire de processus FastCGI, garde des processus PHP prêts pour que le serveur Web leur passe les requêtes. Le paquet php8.3-fpm installe le fichier d’unité php8.3-fpm.service, le binaire php-fpm8.3, la configuration sous /etc/php/8.3/fpm/ et, une fois démarré, le socket /run/php/php8.3-fpm.sock. Un socket est ici un fichier spécial que nginx ou Apache ouvre pour parler à PHP. Il n’existe pas de php-fpm.service sans numéro de version sur ces systèmes, donc ce nom-là est introuvable lui aussi.
Installer php8.3 ou php8.3-cli ne vous donne pas le service. Seul le paquet -fpm le fait. Le paquet php-fpm est un métapaquet, un paquet vide qui installe la version que la source de paquets considère comme celle par défaut. Dans l’archive d’Ubuntu 24.04, c’est php8.3-fpm. Dans le PPA ondrej/php, c’est habituellement la plus récente version de PHP, qui n’est pas forcément 8.3.
Quand un paquet est retiré sans être purgé, dpkg garde ses fichiers de configuration et l’indique rc : retiré, configuration conservée. Le dossier /etc/php/8.3/fpm/ peut donc exister sans que le service existe. L’inverse arrive aussi. Le paquet est installé, mais quelqu’un a masqué l’unité, ce qui la relie à /dev/null pour que systemd refuse de la démarrer.
Étape par étape
-
Listez les versions de PHP qui ont des fichiers sur le disque.
ls /etc/php/Exemple de sortie :
8.1 8.3Chaque numéro est une version qui a, ou a déjà eu, une configuration ici. Si
8.3manque, PHP 8.3 n’a jamais été installé ou a été purgé. S’il est là, vérifiez qu’il contient un dossierfpmavecls /etc/php/8.3/. Une version qui n’a queclietmods-availablea le PHP en ligne de commande, mais pas le service. -
Vérifiez l’état de chaque paquet FPM.
dpkg -l 'php*-fpm'Exemple de sortie :
Desired=Unknown/Install/Remove/Purge/Hold | Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend |/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad) ||/ Name Version Architecture Description +++-==============-====================-============-================================================================= rc php8.1-fpm 8.1.2-1ubuntu2.19 amd64 server-side, HTML-embedded scripting language (FPM-CGI binary)iiveut dire installé.rcveut dire retiré, avec la configuration laissée derrière. Dans cet exemple, l’ancien service 8.1 a disparu etphp8.3-fpmn’apparaît pas du tout : il n’a jamais été installé, ou il a été purgé. Si la commande affichedpkg-query: no packages found matching php*-fpm, aucun paquet FPM n’est installé ni resté en étatrc. -
Demandez à systemd quelles unités FPM il connaît.
systemctl list-unit-files 'php*-fpm*'Exemple de sortie :
UNIT FILE STATE PRESET php8.3-fpm.service masked enabled 1 unit files listed.0 unit files listed.confirme que le paquet manque.maskedveut dire qu’un masque bloque l’unité, et un redémarrage répond alors plutôtUnit php8.3-fpm.service is masked.L’étape 6 retire le masque.enabledoudisabledveut dire que l’unité existe sous ce nom exact : vérifiez le numéro de version dans la commande que vous avez tapée. -
Vérifiez d’où viendrait
php8.3-fpm.apt-cache policy php8.3-fpmExemple de sortie sur Ubuntu 24.04, sans le PPA :
php8.3-fpm: Installed: (none) Candidate: 8.3.6-0ubuntu0.24.04.13 Version table: 8.3.6-0ubuntu0.24.04.13 500 500 http://archive.ubuntu.com/ubuntu noble-updates/universe amd64 Packages 500 http://security.ubuntu.com/ubuntu noble-security/universe amd64 PackagesCandidate:doit montrer une version. Si la commande n’affiche rien sur le paquet, aucune source configurée n’offre PHP 8.3. Sur Ubuntu 22.04 ou Debian 12, il vous faut alors d’abord le PPA ou sury.org, ce que couvre le guide d’installation. Si une ligne sousVersion table:mentionneppa.launchpadcontent.net/ondrej/phpoupackages.sury.org, cette version vient de la source tierce. -
Dressez la liste des extensions à partir de l’ancienne version, puis installez. Demandez à dpkg quels paquets d’extension l’ancienne version avait. Les paquets en état
rcapparaissent encore, et c’est ce que vous voulez :dpkg -l 'php8.1-*' | awk '/^(ii|rc)/ {print $2}'Exemple de sortie :
php8.1-cli php8.1-common php8.1-curl php8.1-fpm php8.1-gd php8.1-imagick php8.1-intl php8.1-mbstring php8.1-mysql php8.1-opcache php8.1-readline php8.1-xml php8.1-zipCertaines extensions de l’archive Ubuntu ou Debian peuvent être installées sous un nom sans numéro de version, comme
php-redisouphp-imagick.dpkg -l 'php-*'les liste, et vous installez le nom enphp8.3-de chacune. Si l’ancien PHP fonctionne encore,php8.1 -mliste les modules chargés comme deuxième vérification. Installez les mêmes noms pour 8.3 :sudo apt update sudo apt install php8.3-fpm php8.3-mysql php8.3-curl php8.3-gd php8.3-imagick php8.3-intl php8.3-mbstring php8.3-xml php8.3-zipphp8.3-cli,php8.3-commonetphp8.3-opcacheviennent avecphp8.3-fpm, qui en dépend. Si apt répondE: Unable to locate packagepour un nom, retirez ce nom, terminez l’installation et cherchez-le ensuite avecapt-cache policy. Installez le paquet avec numéro de version, pasphp-fpm, pour obtenir exactement 8.3. -
Démasquez et démarrez le service. Un masque peut survivre au retrait du paquet, parce qu’il se trouve dans
/etc/systemd/system/et non dans le paquet :sudo systemctl unmask php8.3-fpm sudo systemctl enable --now php8.3-fpm systemctl is-active php8.3-fpmRésultat attendu :
active. Si la première commande affiche une ligneRemovedpour/etc/systemd/system/php8.3-fpm.service, l’unité était masquée. Si elle n’affiche rien, elle ne l’était pas. La commandeenablepeut aussi afficher quelques lignes sur le script d’initialisation SysV, ce qui est normal.failedveut dire que le service démarre puis s’arrête; passez au premier point du dépannage. -
Transférez les réglages de pool personnalisés. Les pools sont les groupes de processus PHP, un fichier de configuration chacun. Listez les deux dossiers :
ls /etc/php/8.1/fpm/pool.d/ /etc/php/8.3/fpm/pool.d/Si l’ancien dossier ne contient que
www.conf, comparez-le au nouveau avecdiff /etc/php/8.1/fpm/pool.d/www.conf /etc/php/8.3/fpm/pool.d/www.conf. Recopiez seulement les lignes que vous aviez changées, commepm.max_children, jamais le fichier au complet. Copiez les autres fichiers de pool, commeerabliere.conf, avecsudo cp. Changez ensuite tout8.1de leur lignelisten =en8.3:grep -n 'listen =' /etc/php/8.3/fpm/pool.d/*.conf sudo php-fpm8.3 -tRésultat attendu : un chemin
listen =distinct par pool, puis une ligne qui se termine parNOTICE: configuration file /etc/php/8.3/fpm/php-fpm.conf test is successful. Redémarrez avecsudo systemctl restart php8.3-fpmune fois le test réussi. -
Pointez le serveur Web vers le nouveau socket. Trouvez chaque mention de l’ancien :
sudo grep -rn 'php8.1-fpm' /etc/nginx/ /etc/apache2/ 2>/dev/nullAvec nginx, une ancienne ligne ressemble à
fastcgi_pass unix:/run/php/php8.1-fpm.sock;. Le journal d’erreurs afficheconnect() to unix:/run/php/php8.1-fpm.sock failed (2: No such file or directory) while connecting to upstream, et les visiteurs reçoivent un 502. Modifiez chaque fichier trouvé par grep, changezphp8.1-fpm.sockenphp8.3-fpm.sock, puis testez et rechargez :sudo nginx -t && sudo systemctl reload nginxRésultat attendu :
nginx: the configuration file /etc/nginx/nginx.conf syntax is oketnginx: configuration file /etc/nginx/nginx.conf test is successful.Avec Apache, le paquet fournit
/etc/apache2/conf-available/php8.3-fpm.conf, mais ne l’active pas. Basculez la configuration :sudo a2enmod proxy_fcgi setenvif sudo a2disconf php8.1-fpm sudo a2enconf php8.3-fpm sudo apachectl configtest && sudo systemctl reload apache2Résultat attendu :
Syntax OK.a2disconfpeut signaler quephp8.1-fpmn’existe pas, ce qui est sans conséquence. Corrigez toute ligneSetHandler "proxy:unix:/run/php/php8.1-fpm.sock|fcgi://localhost"trouvée par grep dans un hôte virtuel. Sia2query -mlistephp8.1, l’ancien module mod_php (PHP exécuté dans Apache) est encore actif : lancezsudo a2dismod php8.1.
Valider que ça fonctionne
-
Le service tourne et le socket existe.
systemctl is-active php8.3-fpm ls -l /run/php/Résultat attendu :
active, et une ligne pourphp8.3-fpm.sockappartenant àwww-data. -
Une page WordPress répond.
curl -s -o /dev/null -w '%{http_code}\n' https://example.com/ curl -s -o /dev/null -w '%{http_code}\n' https://example.com/wp-login.phpRésultat attendu :
200pour les deux. Un502avec nginx ou un503avec Apache veut dire que le serveur Web cherche encore un socket qui n’existe pas : reprenez l’étape 8. -
PHP-FPM sert bien 8.3.
wp --infoindique le PHP en ligne de commande, pas celui qui sert le site. Interrogez directement le serveur Web avec un fichier temporaire, puis supprimez-le. Remplacez/var/www/example.compar la racine de votre site, la lignerootde nginx ouDocumentRootd’Apache :echo '<?php echo PHP_VERSION, " ", PHP_SAPI;' | sudo tee /var/www/example.com/fpm-check-7f3a.php >/dev/null curl -s https://example.com/fpm-check-7f3a.php; echo sudo rm /var/www/example.com/fpm-check-7f3a.phpExemple de sortie :
8.3.6 fpm-fcgifpm-fcgiconfirme que la requête est passée par PHP-FPM. Un403ou un404veut dire que votre configuration n’exécute que les fichiers PHP de WordPress, une bonne règle à garder. Si la page d’état de FPM est activée, elle montre aussi le nom du pool, et le guide de la page d’état explique ses champs. -
WordPress a ses extensions. Connectez-vous à WordPress et ouvrez Outils » Santé du site. Aucun problème critique ne doit nommer un module PHP manquant.
Dépannage
-
Le service démarre, puis tombe. Lisez la raison :
journalctl -u php8.3-fpm -n 30 --no-pager sudo php-fpm8.3 -tUn pool copié en est habituellement la cause.
ERROR: [/etc/php/8.3/fpm/pool.d/erabliere.conf:23] unknown entry 'pm.max_requets'nomme le fichier, la ligne et le réglage mal orthographié.ERROR: [pool erabliere] cannot get uid for user 'erabliere'veut dire que le compte duuser =du pool n’existe pas sur ce serveur. -
Deux pools partagent un socket. Dans PHP 8.3,
php-fpm8.3 -tsignale[pool erabliere] unable to set listen address as it's already used in another pool 'www'. Donnez à chaque pool son propre cheminlisten =. Si une ancienne version de PHP tourne encore sur le même chemin, le journal afficheAnother FPM instance seems to already listen on /run/php/php8.3-fpm.sock. Arrêtez l’ancien service avecsudo systemctl disable --now php8.1-fpm. -
apt refuse à cause de sources mélangées. Un message comme
php8.3-fpm : Depends: php8.3-common (= 8.3.6-0ubuntu0.24.04.13) but 8.3.14-1+ubuntu24.04.1+deb.sury.org+1 is to be installedveut dire que certains paquets PHP viennent d’Ubuntu et d’autres du PPA. Lancezapt-cache policy php8.3-common php8.3-fpmpour voir l’origine de chacun. Choisissez une seule source et installez-en tous les paquetsphp8.3-*. -
Le dossier de configuration a disparu, mais dpkg indique
rc. Si quelqu’un a supprimé/etc/php/8.3/à la main, une réinstallation normale ne ramène pas les fichiers. dpkg saute les fichiers de configuration que vous avez retirés volontairement. Demandez-lui de les restaurer :sudo apt install --reinstall -o Dpkg::Options::="--force-confmiss" php8.3-fpm -
Le site fonctionne, mais WP-CLI ou cron montre une autre version.
php -vindique le PHP en ligne de commande vers lequel pointe/usr/bin/php, qui est distinct de FPM. Lancezsudo update-alternatives --config phpet choisissez/usr/bin/php8.3. Les tâches cron qui appellentphpsuivent le même choix.
Pour les causes de 502 qui restent une fois le socket corrigé, comme un délai dépassé ou un pool à court de processus, consultez corriger un 502 Bad Gateway nginx.
Quand ce n’est pas la bonne approche
Sur un serveur cPanel & WHM, PHP vient d’EasyApache 4 sous forme de paquets ea-phpXY, avec des services nommés ea-php83-php-fpm. N’y installez pas php8.3-fpm avec apt : vous contourneriez cPanel et risqueriez un conflit avec ses paquets. Suivez plutôt le guide cPanel sur apache_php_fpm.
Dans un conteneur Docker, il n’y a habituellement pas de systemd, donc systemctl ne trouve aucune unité. PHP-FPM tourne comme processus principal du conteneur, et vous changez de version en changeant d’image, par exemple php:8.3-fpm. C’est pareil sur les plateformes gérées qui choisissent la version de PHP pour vous.
Si la mise à niveau a aussi changé nginx, Apache ou MySQL, réparez PHP d’abord, puis vérifiez ces services un à la fois. La page de manuel Debian de systemctl décrit en détail mask, unmask et list-unit-files.
Un WordPress qui rapporte vraiment mérite un opérateur — Stack Harbor opère cette pile sous WordPress Entreprise ; réservez une consultation d’infrastructure.