Aller au contenu

Fin de vie de PHP 8.2 : planifier le passage à 8.3 ou 8.4

Planifiez votre sortie de PHP 8.2 avant sa fin de vie le 31 décembre 2026, la date après laquelle php.net ne publie plus aucun correctif de sécurité pour cette version. Vous trouverez chaque site WordPress, compte cPanel et application Composer encore en 8.2, choisirez entre PHP 8.3 et 8.4, et bâtirez un calendrier à rebours depuis l'échéance.

Si vos sites WordPress, votre serveur cPanel ou votre application Composer utilisent encore PHP 8.2, ce plan vous en fait sortir avant le 31 décembre 2026, le jour où php.net cesse de la corriger. Il s’adresse aux propriétaires de sites, aux agences et aux administrateurs de serveurs qui ont trouvé 8.2, longtemps la version par défaut en hébergement partagé, en vérifiant après l’avis « PHP2Shell » du 21 octobre 2026. Passez à PHP 8.4, sauf si une extension, un thème ou un paquet que vous ne pouvez pas remplacer échoue dessus; prenez alors 8.3, que php.net soutient jusqu’au 31 décembre 2027. La fin de vie (EOL, pour end of life) veut dire que le projet PHP ne publie aucun correctif pour 8.2 quand le prochain bogue sérieux arrive, ce qui est arrivé à PHP 8.1 le 21 octobre. Une application Composer est une application PHP dont les bibliothèques sont installées par Composer, le gestionnaire de paquets de PHP.

Ce que vous allez accomplir

  • Une liste datée de chaque site, compte cPanel et application encore en PHP 8.2, lue depuis le gestionnaire web et pas seulement depuis la ligne de commande.
  • Un choix entre 8.3, 8.4 et 8.5 fait selon des critères écrits.
  • Un calendrier bâti à rebours depuis le 31 décembre 2026, avec la production basculée avant le gel des changements de la mi-décembre.
  • Une fenêtre de retour pendant laquelle revenir à 8.2 reste sans danger, puis une date où 8.2 quitte le serveur.
  • Une réponse claire pour les sites qui ne pourront pas respecter la date.

Prérequis

  • WordPress 6.7 ou plus récent pour PHP 8.4, et 6.9 ou plus récent pour 8.5, selon le manuel du noyau au 27 octobre 2026 (compatibilité PHP et versions de WordPress). La page des exigences recommande PHP 8.3 ou plus (exigences de WordPress).
  • Sur cPanel, un accès root à WHM (WebHost Manager, le côté administration du serveur de cPanel) ou un compte revendeur avec la fonction Gestionnaire MultiPHP. La version 25.91 d’EasyApache 4, du 21 octobre 2026, livre ea-php83 8.3.36, ea-php84 8.4.27 et ea-php85 8.5.12 (journal des modifications d’EasyApache 4).
  • Sur un serveur Linux ordinaire, un accès root et une source de paquets qui offre 8.3 ou 8.4.
  • Une copie de préproduction de chaque site important, et une sauvegarde récente que vous avez déjà restaurée au moins une fois.

Comment ça fonctionne

Chaque branche de PHP reçoit deux ans de soutien actif, pendant lesquels les bogues et les failles de sécurité sont corrigés dans des versions mineures régulières, puis deux années de plus de correctifs de sécurité seulement (versions soutenues de php.net). Ensuite, c’est la fin de vie. Au 27 octobre 2026, php.net donne ces dates :

BrancheSoutien actif jusqu’auCorrectifs de sécurité jusqu’au
8.231 déc. 2024 (terminé)31 déc. 2026
8.331 déc. 2025 (terminé)31 déc. 2027
8.431 déc. 202631 déc. 2028
8.531 déc. 202731 déc. 2029

PHP 8.2 ne reçoit donc que des correctifs de sécurité depuis près de deux ans, et le 31 décembre 2026 est sa dernière date possible de correctif. L’annonce de la version 8.2.35, le 21 octobre 2026, le dit sans détour : « PHP 8.2 reaches end of life on 31 December 2026 and will receive no further security fixes after that date » (archives 2026 de php.net).

Le même jour a montré ce que ça veut dire concrètement. Les deux bogues critiques surnommés « PHP2Shell », CVE-2026-109618 et CVE-2026-109619, permettent à un visiteur non authentifié d’exécuter du code sur le serveur. Leurs correctifs sont sortis en 8.2.35, 8.3.36, 8.4.27 et 8.5.12. Pour 8.1, aucune publication, parce que « PHP 8.1 and older no longer receive updates from the PHP project ». Ceux qui étaient en 8.1 ont attendu un rétroportage, une rustine appliquée à l’ancienne version par une distribution ou un hébergeur. À partir du 1er janvier 2027, c’est 8.2 qui se trouve dans cette position.

Calendrier vertical de la fin octobre à janvier : inventaire d'ici le 6 novembre, tests en préproduction d'ici le 27 novembre, production basculée d'ici le 11 décembre, fenêtre de retour jusqu'au 24 décembre, dernier correctif de sécurité 8.2 le 31 décembre, puis le premier avis de 2027 avec des correctifs pour 8.3 à 8.5 et un cul-de-sac rouge pour tout ce qui est encore en 8.2

Quelle version : 8.3, 8.4 ou 8.5

Choisissez 8.4 par défaut. Elle reçoit des correctifs de sécurité jusqu’au 31 décembre 2028, WordPress la soutient depuis 6.7, et les auteurs d’extensions ont eu près de deux ans pour s’y faire. Choisissez 8.3 seulement quand une extension, un thème ou un paquet que vous ne pouvez pas remplacer échoue en 8.4. Ça vous donne un an de plus, parce que 8.3 atteint sa fin de vie le 31 décembre 2027. Choisissez 8.5 quand la préproduction passe sans accroc et que vous voulez le plus de temps devant vous; c’est aussi la branche avec laquelle les auteurs d’extensions ont eu le moins de temps. PHP 8.6 en est à la version candidate 4 dans les archives de php.net d’octobre 2026, et php.net demande de ne pas l’utiliser en production.

CritèrePHP 8.3PHP 8.4PHP 8.5
Correctifs de sécurité jusqu’au (php.net, 27 oct. 2026)31 déc. 202731 déc. 202831 déc. 2029
Correctifs de bogues (soutien actif)Terminé le 31 déc. 2025Jusqu’au 31 déc. 2026Jusqu’au 31 déc. 2027
Soutien du noyau WordPress (manuel, 27 oct. 2026)6.4 et plus6.7 et plus6.9 et plus
Paquet cPanel (EA4 25.91)ea-php83, 8.3.36ea-php84, 8.4.27ea-php85, 8.5.12
Saut depuis 8.2Un an de dépréciationsDeux ansTrois ans, extensions moins testées
Prochain changement obligéFin 2027Fin 2028Fin 2029

Une agence avec des dizaines de sites clients tire le plus de 8.4 : une seule passe de compatibilité couvre deux années de plus. Une boutique avec une vieille extension de paiement qui ne déclare que 8.3 prend 8.3 maintenant et inscrit le remplacement à l’agenda de 2027. Les dépréciations sont listées dans le guide de migration de PHP 8.3.x vers 8.4.x.

Le calendrier, à rebours depuis le 31 décembre

Comptez à partir de l’échéance, pas à partir d’aujourd’hui. Les deux dernières semaines de décembre sont un gel des changements pour la plupart des entreprises, la période où personne ne touche à la production, alors la production bascule avant.

DatesJalonTerminé quand
27 oct. au 6 nov.InventaireChaque site et chaque compte a une version inscrite à côté
9 nov. au 27 nov.Test de compatibilité en préproductionChaque site a passé sur la version cible, ou a un blocage écrit
30 nov. au 11 déc.Bascule de la productionQuelques sites par jour, hors pointe; 8.2 reste installé
14 déc. au 24 déc.Fenêtre de retour8.2 reçoit encore des correctifs, alors ramener un site est sans danger
31 déc.Dernier jour de correctifs de sécurité pour 8.2Plus rien en 8.2, sauf les exceptions datées
Première fenêtre de janvierRetrait de 8.2ea-php82 ou les paquets php8.2 sont désinstallés

Si vous lisez ceci après le 27 octobre, compressez les deux premières lignes, pas les trois dernières.

Étape par étape

  1. Lisez la version depuis WordPress, côté web. Dans l’administration de WordPress, ouvrez Outils » Santé du site » Informations et dépliez Serveur. La ligne Version de PHP montre la version qui a servi la page, par exemple 8.2.35 (Supports 64bit values). Notez-la pour chaque site; c’est le PHP qui sert vos visiteurs.

  2. Lisez la version depuis WP-CLI, qui peut différer. WP-CLI est la commande wp qui gère WordPress depuis un terminal. Sur le serveur, dans le répertoire du site :

    wp cli info

    Exemple de sortie (abrégée) :

    PHP binary:     /opt/cpanel/ea-php82/root/usr/bin/php
    PHP version:    8.2.35
    php.ini used:   /opt/cpanel/ea-php82/root/etc/php.ini
    WP-CLI version: 2.12.0

    Pour une réponse sur une ligne :

    wp --skip-plugins --skip-themes eval 'echo PHP_VERSION . PHP_EOL;'

    Exemple de sortie :

    8.2.35

    C’est le PHP de la ligne de commande, celui des tâches cron. C’est PATH qui le choisit, pas le réglage web du site, alors il peut dire 8.2 pendant que les visiteurs reçoivent 8.4. Si les deux ne concordent pas, notez les deux. PHP en ligne de commande sur cPanel dans une autre version que PHP-FPM donne le correctif, et comment vérifier quelle version de PHP votre site utilise vraiment couvre le côté web.

  3. Sur cPanel, lisez la version par défaut du système et chaque domaine en une passe. La version par défaut du système est celle dont chaque compte hérite s’il n’en a pas choisi une :

    whmapi1 php_get_system_default_version

    Exemple de sortie :

    ---
    data:
      version: ea-php82
    metadata:
      command: php_get_system_default_version
      reason: OK
      result: 1
      version: 1

    Listez ensuite chaque hôte virtuel, comptez les versions et affichez ceux en 8.2 avec leur source :

    whmapi1 --output=json php_get_vhost_versions | python3 -c '
    import json, sys, collections
    rows = json.load(sys.stdin)["data"]["versions"]
    print(collections.Counter(r["version"] for r in rows))
    for r in rows:
        if r["version"] == "ea-php82":
            src = "system default" if r["phpversion_source"].get("system_default") else "set on domain"
            print(r["vhost"], r["account"], src, "fpm" if r["php_fpm"] else "no-fpm")
    '

    Exemple de sortie :

    Counter({'ea-php82': 23, 'ea-php83': 9, 'ea-php84': 5})
    boutique-lac.com boutique system default fpm
    agence-nord.ca agence set on domain fpm
    clinique-rive.qc.ca clinique system default no-fpm

    La même liste se trouve dans WHM » Logiciels » Gestionnaire MultiPHP. Les lignes marquées system default changent toutes ensemble quand vous changez la version par défaut à l’étape 7, alors comptez-les à part. Les lignes marquées set on domain bougent une à la fois.

  4. Sur un serveur Linux ordinaire, lisez les versions installées et le gestionnaire de chaque site. Chaque site confie ses requêtes PHP à un socket PHP-FPM, et le nom du socket porte la version. FPM est le FastCGI Process Manager, le bassin de processus PHP derrière nginx ou Apache. Sur Debian ou Ubuntu :

    ls /etc/php/
    grep -rh 'fastcgi_pass\|SetHandler' /etc/nginx/sites-enabled/ /etc/apache2/sites-enabled/ 2>/dev/null | sort | uniq -c

    Exemple de sortie :

    8.2  8.4
          7 	fastcgi_pass unix:/run/php/php8.2-fpm.sock;
          2 	fastcgi_pass unix:/run/php/php8.4-fpm.sock;

    Chaque ligne php8.2-fpm.sock est un site à déplacer. Au 27 octobre 2026, le suivi des CVE d’Ubuntu indique php8.2 comme « Not in release » pour chaque LTS de 20.04 à 26.04. Sur une LTS, PHP 8.2 vient d’un PPA (un personal package archive, un dépôt extérieur à ceux d’Ubuntu), et c’est le responsable du PPA, pas Ubuntu, qui décide s’il reçoit un correctif.

  5. Vérifiez les applications Composer pour un blocage. Dans le répertoire de l’application :

    composer why-not php 8.4

    Exemple de sortie quand quelque chose bloque :

    acme/legacy-pdf  2.3.1  requires  php (~8.1.0 || ~8.2.0 || ~8.3.0)

    Exemple de sortie quand rien ne bloque :

    There is no installed package depending on "php" in versions not matching 8.4

    Une exigence "php": "^8.2" dans composer.json permet déjà 8.4. Le piège habituel est un config.platform.php figé à 8.2.0, qui fait résoudre Composer comme si le serveur était en 8.2. Montez-le à la version cible avant de lancer composer update.

  6. Testez chaque site sur la version cible, en préproduction. Trois articles existants couvrent la boucle de test; prenez celui qui correspond au site. Pour WordPress sur cPanel, commencez par vérifier la compatibilité WordPress avant un changement de version PHP. La méthode de l’hôte virtuel de préproduction dans passer WordPress à PHP 8.5 sur cPanel avec une vraie boucle de test de compatibilité fonctionne telle quelle avec ea-php84 comme cible. Pour une application maison, utilisez la passe PHPStan et Rector et le bassin PHP-FPM parallèle de mettre à niveau une application en production vers PHP 8.4 sans mauvaise surprise. Inscrivez le résultat à côté de chaque site : passé, passé avec des avis de dépréciation, ou bloqué par une extension nommée.

  7. Basculez la production par petits lots. Sur cPanel, par domaine :

    whmapi1 php_set_vhost_versions version=ea-php84 vhost=boutique-lac.com

    Attendu : result: 1 et reason: OK dans le bloc metadata. Quand il ne reste que des lignes system default, et que chacune a passé l’étape 6, changez la version par défaut en une seule étape réfléchie :

    whmapi1 php_set_system_default_version version=ea-php84

    Sur un serveur ordinaire, pointez la ligne fastcgi_pass ou SetHandler du site vers le nouveau socket et rechargez le serveur web, comme dans l’article sur le bassin parallèle. Laissez les paquets 8.2 installés jusqu’à l’étape 9.

  8. Gardez la fenêtre de retour ouverte jusqu’au 24 décembre. Pendant cette période, 8.2 reçoit encore des correctifs de sécurité, alors ramener un site avec version=ea-php82 est une décision d’une ligne, sans coût de sécurité. Surveillez le journal d’erreurs de chaque site déplacé pour des lignes PHP Fatal error; les lignes PHP Deprecated ne justifient pas un retour.

  9. Retirez 8.2 dans la première fenêtre de janvier. Une fois qu’aucun domaine n’y pointe, désinstallez ea-php82 dans WHM » Logiciels » EasyApache 4, ou lancez apt remove 'php8.2-*' sur Debian et Ubuntu. Une version qui n’est pas installée ne peut pas être choisie par erreur.

Validez que ça fonctionne

  1. Relancez le décompte de l’étape 3. Le résultat attendu n’a aucune entrée ea-php82 :

    Counter({'ea-php84': 32, 'ea-php83': 5})
  2. Ouvrez Santé du site » Informations » Serveur sur trois sites déplacés. Version de PHP doit afficher 8.4.27 ou plus récent.

  3. Lancez wp cli info une fois par compte. PHP version doit correspondre à la version web, sinon les tâches cron de ce compte tournent sur un PHP que vous êtes sur le point de retirer.

  4. Confirmez que les processus tournent sous la nouvelle version :

    systemctl list-units --plain --no-legend 'ea-php*php-fpm*'

    Exemple de sortie :

    ea-php83-php-fpm.service  loaded active running  The PHP FastCGI Process Manager
    ea-php84-php-fpm.service  loaded active running  The PHP FastCGI Process Manager

    Aucune ligne ea-php82-php-fpm.service ne doit rester après l’étape 9.

  5. Passez une commande test et soumettez un formulaire sur chaque site déplacé. Une erreur fatale dans le journal justifie un retour; un avis de dépréciation, non.

Dépannage

  • Santé du site affiche 8.4, mais une tâche planifiée échoue avec une erreur en 8.2. La tâche cron utilise le PHP de la ligne de commande, celui de PATH. Appelez le binaire par son chemin complet dans la ligne cron, par exemple /opt/cpanel/ea-php84/root/usr/bin/php, ou corrigez le PATH du compte comme dans l’article lié à l’étape 2.
  • php_set_vhost_versions répond que la version n’est pas installée. ea-php84 n’est pas encore provisionné. Ajoutez-le dans WHM » Logiciels » EasyApache 4 sous le profil courant, puis relancez la commande.
  • Un domaine sert encore 8.2 après le changement. Cherchez une ligne de gestionnaire dans le .htaccess du site, par exemple AddHandler application/x-httpd-ea-php82, souvent copiée d’un autre site. Retirez ce bloc; le Gestionnaire MultiPHP écrit le sien.
  • Une extension échoue seulement en 8.4 avec Fatal error: Uncaught TypeError. Cette extension est le blocage. Notez-la, passez le site en 8.3 pour l’instant, et ouvrez une tâche datée pour remplacer l’extension avant le 31 décembre 2027.

Si vous ne pouvez pas respecter la date

Certains sites manqueront l’échéance : une extension sans version 8.3, un client qui refuse tout changement en décembre, une application que personne ne peut reconstruire à temps. Traitez chacun comme une exception nommée, avec un responsable et une date en janvier, pas comme un défaut silencieux.

Un soutien prolongé payant existe. Au 27 octobre 2026, cPanel documente TuxCare Extended Lifecycle Support (ELS) pour PHP, des paquets corrigés par le fournisseur pour les versions en fin de vie, offerts dans le Gestionnaire MultiPHP (documentation cPanel). Cette page renvoie à la liste de TuxCare pour les versions couvertes, alors vérifiez si PHP 8.2 y figure avant de compter dessus. Ubuntu Pro couvre les paquets des dépôts LTS d’Ubuntu, et php8.2 n’y figure dans aucun, alors une version venue d’un PPA n’a pas de couverture Pro non plus. Tant que chaque exception n’a pas bougé, gardez les réglages de atténuations PHP2Shell en attendant le correctif en place, parce que le prochain avis arrivera sans publication 8.2 derrière lui.

Quand ce n’est pas la bonne approche

Si vous louez un seul compte sur le serveur de quelqu’un d’autre, vous n’avez pas besoin du calendrier. Ouvrez le Gestionnaire MultiPHP dans cPanel, testez sur une copie de préproduction et choisissez 8.4. Si vos sites sont déjà en 8.3 ou plus récent, rien ici ne s’applique avant l’automne 2027. Si vous êtes encore en PHP 8.1 ou plus ancien, l’échéance est déjà passée. Commencez par PHP 7.4, 8.0 ou 8.1 : obtenir le correctif PHP2Shell, puis migrer des applications PHP 7.x vers PHP 8.x. Pour toute une flotte cPanel avec communication aux clients et retour par compte, voyez migration serveur entier hors d’une version PHP en fin de vie sur cPanel.

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.