Aller au contenu

PHP dans Docker : mise à jour, épinglage et vérification

Faites entrer le correctif PHP2Shell dans vos conteneurs PHP en les reconstruisant sur une image php officielle corrigée, épinglée par son condensé. Vous recréerez chaque conteneur et prouverez que chacun utilise la nouvelle image et annonce une version de PHP corrigée.

Si vous faites tourner WordPress ou une autre application PHP dans Docker, voici comment passer chaque conteneur à un PHP qui contient le correctif PHP2Shell d’octobre 2026, et comment le prouver. PHP2Shell regroupe deux failles critiques d’exécution de code à distance, inscrites au catalogue CVE (Common Vulnerabilities and Exposures) sous les numéros CVE-2026-109618 et CVE-2026-109619. Le projet PHP les a corrigées dans 8.2.35, 8.3.36, 8.4.27 et 8.5.12 le 21 octobre 2026 (archives des publications de php.net). Avec des conteneurs, docker pull ne fait que télécharger une nouvelle image, et chaque conteneur démarré plus tôt continue d’utiliser l’ancienne. Reconstruisez sur une image php officielle corrigée, épinglez-la par son condensé, recréez les conteneurs, puis vérifiez de l’intérieur de chaque conteneur en marche.

Les images officielles citées ci-dessous ont d’abord été examinées le 30 octobre 2026, puis revérifiées le 21 novembre 2026. Les étiquettes bougent, alors revérifiez avant de vous fier à un condensé précis.

Mise à jour du 21 novembre 2026. Les versions d’octobre ne sont plus celles à viser. Le 19 novembre 2026, le projet PHP a publié 8.2.36, 8.3.37, 8.4.28 et 8.5.13 comme versions de sécurité (archives des versions de php.net). Elles corrigent CVE-2026-115560. Sur 8.3 et les branches suivantes, elles corrigent aussi CVE-2026-129481, que le projet PHP décrit comme un correctif incomplet de CVE-2026-109619. Ces quatre versions sont maintenant le minimum dans chaque branche. Les étiquettes, le condensé et les exemples de sortie des étapes ci-dessous utilisent les versions de novembre, confirmées sur Docker Hub le 21 novembre 2026.

Ce que vous allez accomplir

  • Une liste de chaque conteneur en marche, avec la version de PHP qu’il exécute vraiment et l’indication s’il utilise encore une image périmée.
  • Un Dockerfile qui part d’une étiquette officielle corrigée, épinglée par condensé pour que la construction ne dérive pas en silence.
  • Des images reconstruites et des conteneurs recréés, avec Docker Compose ou un simple docker run.
  • Une preuve, conteneur par conteneur, que son ID d’image correspond à la nouvelle image et que PHP annonce une version corrigée.
  • Le réglage session.upload_progress.enabled = 0 intégré à l’image, que le projet PHP recommande pour une troisième faille, CVE-2026-115560.

Prérequis

  • Un accès au terminal de l’hôte Docker, avec un utilisateur qui peut lancer les commandes docker.
  • Docker Engine avec le module Compose (docker compose) et le module Buildx, qui font tous deux partie de l’installation standard de Docker Engine. Les commandes ci-dessous ont été vérifiées avec Docker 29 et Compose 5.
  • Le Dockerfile et le fichier compose.yaml (ou docker-compose.yml) de chaque application, sous gestion de versions.
  • Une sauvegarde récente de vos volumes et de votre base de données. Recréer un conteneur conserve les volumes nommés, et une sauvegarde vous laisse quand même une porte de sortie si la nouvelle image pose problème.
  • Si vous ne pouvez pas reconstruire aujourd’hui, commencez par l’article atténuations PHP2Shell en attendant le correctif.

Comment ça fonctionne

Trois choses différentes portent le nom d’« image », et une seule sert vos visiteurs.

Trois niveaux après un docker pull : l'étiquette php:8.3-fpm du registre et l'image locale affichent PHP 8.3.37, mais le conteneur actif, démarré avant le pull, exécute encore PHP 8.3.36 sur l'ancien ID d'image jusqu'à ce que compose up le recrée

Une étiquette comme php:8.3-fpm est un nom mobile dans le registre. L’équipe des images officielles de Docker la reconstruit chaque fois que PHP ou le système Debian ou Alpine sous-jacent change. Une image locale est la copie sur votre hôte, identifiée par un ID d’image. Un conteneur démarre à partir d’un ID d’image précis et le garde toute sa vie. Télécharger ou construire une image plus récente déplace l’étiquette de votre hôte vers le nouvel ID, mais ne touche jamais à un conteneur en marche. Docker n’a aucune étape qui remplace l’image sous un conteneur actif. Il faut le supprimer et en démarrer un nouveau.

C’est pourquoi la preuve doit venir du conteneur en marche lui-même. Deux faits tranchent la question. L’ID d’image du conteneur doit être égal à celui de l’image que vous venez de construire, et PHP doit y annoncer une version corrigée.

Un autre piège se cache dans l’image de base. L’image php officielle compile PHP à partir des sources de php.net, alors son numéro de version passe à 8.3.37, et ainsi de suite. Une image maison qui part de debian ou ubuntu et installe PHP avec apt reçoit plutôt le paquet de la distribution. Ces paquets gardent leur ancien numéro avec un correctif rétroporté, et suivent les avis de sécurité de la distribution, pas les numéros de php.net. L’article mettre à jour PHP sur un serveur Linux après un correctif de sécurité explique comment les lire.

Étape par étape

  1. Listez la version de PHP dans chaque conteneur en marche. Cette boucle demande sa version de PHP à chaque conteneur en marche. Les conteneurs sans PHP, comme une base de données ou un mandataire nginx, affichent no php :

    for c in $(docker ps --format '{{.Names}}'); do
      v=$(docker exec "$c" php -r 'echo PHP_VERSION;' 2>/dev/null || echo 'no php')
      printf '%-24s %s\n' "$c" "$v"
    done

    Exemple de sortie :

    shop-wordpress-1         8.3.36
    shop-db-1                no php
    intranet-php-1           8.2.30
    api-worker-1             8.4.28

    En date du 21 novembre 2026, il manque un correctif à toute version sous 8.2.36, 8.3.37, 8.4.28 ou 8.5.13 dans sa propre branche. Une version 8.1 ou plus ancienne n’est pas corrigée non plus, et aucune étiquette officielle corrigée n’existe pour elle (l’étape 3 en parle). Pour un seul conteneur, docker exec <container> php -v affiche la bannière complète, avec la date de compilation.

  2. Vérifiez d’où chaque image tient son PHP. Les images php officielles, et l’image wordpress construite à partir d’elles, inscrivent la version dans une variable d’environnement :

    docker image inspect --format '{{range .Config.Env}}{{println .}}{{end}}' shop-wordpress:latest | grep '^PHP_VERSION='

    Exemple de sortie :

    PHP_VERSION=8.3.36

    Si rien ne s’affiche, PHP vient d’un paquet de la distribution. Vérifiez le paquet dans le conteneur avec docker exec <container> dpkg -l 'php*' sous Debian ou Ubuntu, ou docker exec <container> apk info -v sous Alpine. Comparez ensuite la version du paquet avec l’avis de sécurité de cette distribution.

  3. Choisissez une étiquette officielle corrigée. Vous pouvez lire la version de PHP de n’importe quelle étiquette avant de la télécharger :

    docker buildx imagetools inspect php:8.3.37-fpm-bookworm --format '{{json .Image}}' | grep -o 'PHP_VERSION=[0-9.]*' | sort -u

    Sortie attendue :

    PHP_VERSION=8.3.37

    Gardez la branche de PHP, la variante et le système d’exploitation que vous utilisez aujourd’hui, et ne changez que la version. Si vous utilisez php:8.3-fpm-bookworm, passez à php:8.3.37-fpm-bookworm. Pour php:8.4-apache, passez à une étiquette comme php:8.4.28-apache-bookworm. Sous Alpine, gardez -alpine, comme dans php:8.3.37-fpm-alpine. Nommez la version de Debian (bookworm ou trixie) de façon délibérée. Les étiquettes sans ce suffixe suivent la version de Debian par défaut de l’image, trixie en date du 21 novembre 2026. Une étiquette sans suffixe peut donc changer votre système d’exploitation pendant une mise à jour de sécurité. Pour l’image wordpress, prenez une étiquette propre à une version de PHP, comme wordpress:php8.3-fpm, qui annonçait PHP_VERSION=8.3.37 pour amd64 et arm64 le 21 novembre 2026.

    Les branches plus anciennes sont un cul-de-sac. En date du 21 novembre 2026, l’image php officielle ne liste des étiquettes prises en charge que pour 8.2, 8.3, 8.4, 8.5 et 8.6. L’étiquette php:8.1-fpm existe encore, mais sa dernière reconstruction date de décembre 2025 et elle annonce 8.1.34, qui n’a pas le correctif PHP2Shell. Le projet PHP n’a publié aucune version corrigée de 8.1, 8.0 ou 7.4, alors aucune étiquette officielle corrigée n’existe pour elles. Faites passer ces applications à 8.3 ou 8.4. Évitez aussi d’atterrir sur 8.2, puisque son soutien de sécurité prend fin le 31 décembre 2026.

  4. Épinglez l’image de base par son condensé. Un condensé (digest) est l’empreinte du contenu d’une image précise, une longue valeur sha256: qui ne change jamais, contrairement à une étiquette. Obtenez celui de l’étiquette choisie :

    docker buildx imagetools inspect php:8.3.37-fpm-bookworm

    Exemple de sortie (abrégé, obtenu le 21 novembre 2026) :

    Name:      docker.io/library/php:8.3.37-fpm-bookworm
    MediaType: application/vnd.oci.image.index.v1+json
    Digest:    sha256:5b9440ebac23314bb42d33338918c1c2c852469e5b0a7f0a9493448d827bab35

    Prenez la ligne Digest: du haut. Elle désigne l’index multiarchitecture, alors le même épinglage fonctionne sur les hôtes Intel et ARM. Si l’image est déjà téléchargée, docker image inspect --format '{{index .RepoDigests 0}}' php:8.3.37-fpm-bookworm affiche la même valeur, sous la forme php@sha256: suivi du condensé. Mettez l’étiquette et le condensé sur la ligne FROM de votre Dockerfile :

    FROM php:8.3.37-fpm-bookworm@sha256:5b9440ebac23314bb42d33338918c1c2c852469e5b0a7f0a9493448d827bab35

    Quand les deux sont présents, Docker utilise le condensé et garde l’étiquette seulement pour les humains qui lisent le fichier. Obtenez votre propre condensé au lieu de copier celui-ci. L’image derrière une étiquette est reconstruite de temps en temps, et Docker Hub indique que celle-ci a été publiée pour la dernière fois le 19 novembre 2026.

  5. Intégrez le réglage contre CVE-2026-115560 à l’image. CVE-2026-115560, publiée par le projet PHP le 23 octobre 2026, est une faille distincte dans le même code de progression du téléversement en session. Les versions d’octobre, 8.3.36 comprise, y sont exposées. PHP 8.5.13, 8.4.28, 8.3.37 et 8.2.36, publiées le 19 novembre 2026, la corrigent (php.net); reconstruisez donc sur l’une d’elles ou sur une version plus récente. Désactiver la fonction dans l’image reste une bonne précaution. La progression du téléversement permet à une page d’indiquer où en est l’envoi d’un fichier, et peu d’applications s’en servent. Créez un fichier nommé zz-php2shell.ini à côté du Dockerfile :

    session.upload_progress.enabled = 0

    Copiez-le ensuite dans le dossier de configuration de PHP. Les images officielles gardent ce chemin dans $PHP_INI_DIR, qui vaut /usr/local/etc/php, et lisent chaque fichier .ini de son sous-dossier conf.d :

    COPY zz-php2shell.ini "$PHP_INI_DIR/conf.d/"

    Le préfixe zz- fait charger le fichier en dernier, pour qu’aucun fichier précédent ne puisse réactiver la fonction. Si votre Dockerfile ne le fait pas déjà, pensez à ajouter RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini". Les images officielles sont livrées sans php.ini actif, ce qui laisse PHP sur ses valeurs par défaut intégrées.

  6. Reconstruisez sans le cache. Construisez avec une image de base fraîche et sans réutiliser de couches :

    docker compose build --pull --no-cache

    Sans Compose, lancez docker build --pull --no-cache -t shop-wordpress:latest . dans le dossier du Dockerfile. Le signal de réussite est une ligne comme Image shop-wordpress:latest Built avec Compose, ou naming to docker.io/library/shop-wordpress:latest done vers la fin de la sortie de docker build. --pull télécharge l’image de base même si une copie plus ancienne existe sur l’hôte. --no-cache compte surtout pour les images qui installent PHP avec apt ou apk. Sinon, une couche RUN apt-get install en cache garderait les paquets du mois dernier.

    Pour les services qui utilisent une image toute faite, sans section build:, comme un wordpress:php8.3-fpm non modifié, changez l’étiquette dans compose.yaml et téléchargez-la plutôt :

    docker compose pull
  7. Recréez les conteneurs. Démarrez de nouveaux conteneurs à partir des nouvelles images :

    docker compose up -d --force-recreate

    Exemple de sortie (abrégé) :

     Container shop-db-1 Recreate
     Container shop-wordpress-1 Recreate
     Container shop-wordpress-1 Recreated
     Container shop-db-1 Recreated
     Container shop-db-1 Starting
     Container shop-wordpress-1 Starting
     Container shop-db-1 Started
     Container shop-wordpress-1 Started

    docker compose up -d recrée déjà à lui seul les services dont l’image a changé. --force-recreate élimine le doute, au prix de redémarrer aussi les services inchangés comme la base de données, alors prévoyez une courte interruption. Pour limiter l’opération à un seul service, ajoutez son nom à la fin, comme dans docker compose up -d --force-recreate wordpress. Pour un conteneur lancé à la main avec docker run, arrêtez-le et supprimez-le, puis relancez la même commande docker run avec la nouvelle étiquette. Les volumes nommés survivent à l’opération, mais pas ce qui a été écrit dans le système de fichiers propre au conteneur.

Validez que ça fonctionne

  1. Comparez l’ID d’image de chaque conteneur avec son image actuelle. Cette boucle signale tout conteneur qui exécute encore une image plus ancienne que celle vers laquelle pointe maintenant son étiquette. Elle affiche aussi la version de PHP à côté :

    for c in $(docker ps --format '{{.Names}}'); do
      ref=$(docker inspect --format '{{.Config.Image}}' "$c")
      running=$(docker inspect --format '{{.Image}}' "$c")
      current=$(docker image inspect --format '{{.Id}}' "$ref" 2>/dev/null)
      if [ "$running" = "$current" ]; then s='current'; else s='STALE'; fi
      v=$(docker exec "$c" php -r 'echo PHP_VERSION;' 2>/dev/null || echo 'no php')
      printf '%-24s %-30s %-8s %s\n' "$c" "$ref" "$v" "$s"
    done

    Exemple de sortie :

    shop-wordpress-1         shop-wordpress:latest          8.3.37   current
    shop-db-1                mariadb:11.4                   no php   current
    intranet-php-1           intranet-php:latest            8.2.30   STALE

    Chaque conteneur PHP doit indiquer current avec une version corrigée. Une ligne STALE veut dire que l’image a été reconstruite mais que le conteneur n’a pas été recréé, alors refaites l’étape 7 pour lui.

  2. Vérifiez la version servie par PHP-FPM ou Apache. docker exec … php lance un nouveau processus en ligne de commande. Le côté web est servi par PHP-FPM (FastCGI Process Manager, le groupe de processus PHP derrière votre serveur web) ou par le processus Apache démarré avec le conteneur. Dans les images officielles, les deux viennent de la même compilation, alors un conteneur recréé suffit. Pour le voir quand même du côté web, écrivez un fichier jetable dans la racine du site, demandez-le par votre site, puis supprimez-le. Pour l’image wordpress, la racine est /var/www/html :

    docker exec shop-wordpress-1 sh -c 'echo "<?php echo PHP_VERSION, \" \", PHP_SAPI;" > /var/www/html/kb-ver-7f3a.php'
    curl -s https://shop.example.com/kb-ver-7f3a.php; echo
    docker exec shop-wordpress-1 rm /var/www/html/kb-ver-7f3a.php

    Sortie attendue : 8.3.37 fpm-fcgi pour PHP-FPM, ou 8.3.37 apache2handler pour la variante Apache. Sous WordPress, vous pouvez vous passer du fichier. La version de PHP apparaît aussi sous Outils » Santé du site » Infos » Serveur.

  3. Confirmez que l’atténuation est active. Interrogez le binaire PHP-FPM, qui lit le même dossier conf.d que les processus web :

    docker exec shop-wordpress-1 php-fpm -i | grep session.upload_progress.enabled

    Sortie attendue :

    session.upload_progress.enabled => Off => Off

    Sur la variante Apache, lancez php -i au lieu de php-fpm -i. PHP-FPM et Apache ne lisent les fichiers .ini qu’au démarrage. Si jamais vous copiez le fichier dans un conteneur en marche, il reste sans effet jusqu’au redémarrage du conteneur, et une recréation est plus propre.

Dépannage

  • Le conteneur annonce encore l’ancienne version après docker compose up -d. Compose recrée un service seulement quand il voit un changement. Lancez docker compose up -d --force-recreate <service>, puis la boucle de validation. Si la version ne bouge toujours pas, la ligne image: de compose.yaml pointe sans doute vers une ancienne étiquette, alors relisez-la avant de reconstruire.
  • L’image reconstruite a encore l’ancien PHP. Un épinglage par condensé l’emporte sur l’étiquette. Si vous avez changé l’étiquette en gardant une ancienne valeur @sha256:, Docker construit à partir de l’ancienne image. Obtenez le nouveau condensé avec docker buildx imagetools inspect et mettez à jour la ligne FROM.
  • PHP_VERSION est corrigée, mais docker exec … php -v affiche autre chose. Votre Dockerfile installe un deuxième PHP, souvent avec apt, par-dessus la base officielle. Vérifiez avec docker exec <container> sh -c 'command -v php; ls /usr/bin/php*'. Gardez un seul PHP par image.
  • STALE apparaît pour un conteneur que vous avez bel et bien recréé. Une autre construction a eu lieu ensuite et a encore déplacé l’étiquette, par exemple une tâche d’intégration continue (CI). Recréez-le une fois de plus après la dernière construction, et déployez à partir d’une étiquette ou d’un condensé qu’une construction ultérieure ne peut pas réutiliser.
  • Un conteneur refuse de démarrer après la recréation. Lisez docker compose logs --tail 50 <service>. Si votre ancienne étiquette n’avait pas de suffixe de version, vérifiez si le système de base est passé de bookworm à trixie. Si c’est le cas, remettez -bookworm dans l’étiquette et reconstruisez.

Garder le correctif en place

Un épinglage par condensé empêche la dérive silencieuse, mais il bloque aussi les reconstructions de sécurité automatiques. Laissez un robot proposer le condensé suivant sous forme de demande de fusion. L’écosystème docker de Dependabot et Renovate mettent tous deux à jour les lignes FROM qui portent une étiquette et un condensé. Renovate peut aussi ajouter des condensés aux lignes non épinglées avec son option pinDigests. Chaque fois qu’une proposition arrive, construisez, recréez et relancez la boucle de validation.

Quand ce n’est pas la bonne approche

Si une plateforme d’hébergement fait tourner vos conteneurs pour vous, elle les reconstruit et les redémarre peut-être selon son propre calendrier. Demandez au fournisseur quelle image il utilise, et lancez plutôt la validation depuis sa console. Si votre application a encore besoin de PHP 7.4, 8.0 ou 8.1, aucune image officielle ne la corrige. Vos options sont une version payante à soutien prolongé d’un fournisseur tiers, ou la mise à niveau de l’application. Si vous ne pouvez pas reconstruire aujourd’hui, les réglages de l’article sur les atténuations réduisent l’exposition en attendant. Ce n’est pas un correctif.

Si c’est le genre de travail que vous préféreriez ne plus jamais porter, c’est le quotidien d’Opérations Cloud — réservez une revue d’infrastructure.