Aller au contenu

Corriger « Unit php8.3-fpm.service not found » sur Ubuntu

Quand systemctl répond que php8.3-fpm.service est introuvable, vous pouvez voir quelles versions de PHP-FPM sont vraiment installées, réinstaller le service avec les extensions de votre site WordPress et pointer nginx ou Apache vers le nouveau socket. Vous terminez avec le service actif et des pages servies par la version de PHP attendue.

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-fpm avec 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 200 et qu’elle est servie par PHP 8.3 par PHP-FPM.

Prérequis

  • Un accès root ou sudo par 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-upgrade d’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.

Parcours de décision pour Unit php8.3-fpm.service not found : vérifier d'abord que /etc/php/8.3/fpm existe, puis que dpkg affiche php8.3-fpm en ii et non en rc, puis que le service n'est pas masqué, et enfin que nginx ou Apache pointe vers /run/php/php8.3-fpm.sock plutôt que vers l'ancien socket php8.1, la panne habituelle derrière un 502 une fois le service réparé

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

  1. Listez les versions de PHP qui ont des fichiers sur le disque.

    ls /etc/php/

    Exemple de sortie :

    8.1  8.3

    Chaque numéro est une version qui a, ou a déjà eu, une configuration ici. Si 8.3 manque, PHP 8.3 n’a jamais été installé ou a été purgé. S’il est là, vérifiez qu’il contient un dossier fpm avec ls /etc/php/8.3/. Une version qui n’a que cli et mods-available a le PHP en ligne de commande, mais pas le service.

  2. 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)

    ii veut dire installé. rc veut dire retiré, avec la configuration laissée derrière. Dans cet exemple, l’ancien service 8.1 a disparu et php8.3-fpm n’apparaît pas du tout : il n’a jamais été installé, ou il a été purgé. Si la commande affiche dpkg-query: no packages found matching php*-fpm, aucun paquet FPM n’est installé ni resté en état rc.

  3. 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. masked veut dire qu’un masque bloque l’unité, et un redémarrage répond alors plutôt Unit php8.3-fpm.service is masked. L’étape 6 retire le masque. enabled ou disabled veut dire que l’unité existe sous ce nom exact : vérifiez le numéro de version dans la commande que vous avez tapée.

  4. Vérifiez d’où viendrait php8.3-fpm.

    apt-cache policy php8.3-fpm

    Exemple 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 Packages

    Candidate: 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 sous Version table: mentionne ppa.launchpadcontent.net/ondrej/php ou packages.sury.org, cette version vient de la source tierce.

  5. 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 rc apparaissent 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-zip

    Certaines extensions de l’archive Ubuntu ou Debian peuvent être installées sous un nom sans numéro de version, comme php-redis ou php-imagick. dpkg -l 'php-*' les liste, et vous installez le nom en php8.3- de chacune. Si l’ancien PHP fonctionne encore, php8.1 -m liste 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-zip

    php8.3-cli, php8.3-common et php8.3-opcache viennent avec php8.3-fpm, qui en dépend. Si apt répond E: Unable to locate package pour un nom, retirez ce nom, terminez l’installation et cherchez-le ensuite avec apt-cache policy. Installez le paquet avec numéro de version, pas php-fpm, pour obtenir exactement 8.3.

  6. 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-fpm

    Résultat attendu : active. Si la première commande affiche une ligne Removed pour /etc/systemd/system/php8.3-fpm.service, l’unité était masquée. Si elle n’affiche rien, elle ne l’était pas. La commande enable peut aussi afficher quelques lignes sur le script d’initialisation SysV, ce qui est normal. failed veut dire que le service démarre puis s’arrête; passez au premier point du dépannage.

  7. 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 avec diff /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, comme pm.max_children, jamais le fichier au complet. Copiez les autres fichiers de pool, comme erabliere.conf, avec sudo cp. Changez ensuite tout 8.1 de leur ligne listen = en 8.3 :

    grep -n 'listen =' /etc/php/8.3/fpm/pool.d/*.conf
    sudo php-fpm8.3 -t

    Résultat attendu : un chemin listen = distinct par pool, puis une ligne qui se termine par NOTICE: configuration file /etc/php/8.3/fpm/php-fpm.conf test is successful. Redémarrez avec sudo systemctl restart php8.3-fpm une fois le test réussi.

  8. 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/null

    Avec nginx, une ancienne ligne ressemble à fastcgi_pass unix:/run/php/php8.1-fpm.sock;. Le journal d’erreurs affiche connect() 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, changez php8.1-fpm.sock en php8.3-fpm.sock, puis testez et rechargez :

    sudo nginx -t && sudo systemctl reload nginx

    Résultat attendu : nginx: the configuration file /etc/nginx/nginx.conf syntax is ok et nginx: 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 apache2

    Résultat attendu : Syntax OK. a2disconf peut signaler que php8.1-fpm n’existe pas, ce qui est sans conséquence. Corrigez toute ligne SetHandler "proxy:unix:/run/php/php8.1-fpm.sock|fcgi://localhost" trouvée par grep dans un hôte virtuel. Si a2query -m liste php8.1, l’ancien module mod_php (PHP exécuté dans Apache) est encore actif : lancez sudo a2dismod php8.1.

Valider que ça fonctionne

  1. Le service tourne et le socket existe.

    systemctl is-active php8.3-fpm
    ls -l /run/php/

    Résultat attendu : active, et une ligne pour php8.3-fpm.sock appartenant à www-data.

  2. 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.php

    Résultat attendu : 200 pour les deux. Un 502 avec nginx ou un 503 avec Apache veut dire que le serveur Web cherche encore un socket qui n’existe pas : reprenez l’étape 8.

  3. PHP-FPM sert bien 8.3. wp --info indique 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.com par la racine de votre site, la ligne root de nginx ou DocumentRoot d’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.php

    Exemple de sortie :

    8.3.6 fpm-fcgi

    fpm-fcgi confirme que la requête est passée par PHP-FPM. Un 403 ou un 404 veut 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.

  4. 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 -t

    Un 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 du user = du pool n’existe pas sur ce serveur.

  • Deux pools partagent un socket. Dans PHP 8.3, php-fpm8.3 -t signale [pool erabliere] unable to set listen address as it's already used in another pool 'www'. Donnez à chaque pool son propre chemin listen =. Si une ancienne version de PHP tourne encore sur le même chemin, le journal affiche Another FPM instance seems to already listen on /run/php/php8.3-fpm.sock. Arrêtez l’ancien service avec sudo 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 installed veut dire que certains paquets PHP viennent d’Ubuntu et d’autres du PPA. Lancez apt-cache policy php8.3-common php8.3-fpm pour voir l’origine de chacun. Choisissez une seule source et installez-en tous les paquets php8.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 -v indique le PHP en ligne de commande vers lequel pointe /usr/bin/php, qui est distinct de FPM. Lancez sudo update-alternatives --config php et choisissez /usr/bin/php8.3. Les tâches cron qui appellent php suivent 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.