Skip to content

How to update PHP to 8.4.28 in rConfig

PHP 8.4.28, released on 19 November 2026, fixes 14 security vulnerabilities in PHP. This page gives example steps for updating PHP on the server that hosts rConfig to 8.4.28 or later. It covers the rConfig Docker image, Ubuntu, CentOS / Rocky Linux and RHEL, and accompanies the rConfig Security Advisory rCFG-SA-2026-16.

The PHP project’s 8.4.28 release fixes these CVEs:

CVE Component
CVE-2026-115560, CVE-2026-126714 Session
CVE-2026-129481 Session shutdown
CVE-2026-129496 Timezone cache
CVE-2026-129538 PHP-CGI
CVE-2026-129289, CVE-2026-129292, CVE-2026-129291 PHP-FPM. CVE-2026-129289 is request smuggling through a request body that was never read
CVE-2026-128090 PHAR
CVE-2026-129506, CVE-2026-15353 SOAP
CVE-2026-128064, CVE-2026-127960 Streams
CVE-2026-129501 DOM XML

The PHP project rates this release Critical. Any rConfig server running PHP 8.4 older than 8.4.28 is affected.

rConfig Pro and Enterprise 8.4.3 require PHP 8.4.28 or later. Update PHP to 8.4.28 before you upgrade to 8.4.3. From 8.4.3, the app shows a warning if the server’s PHP is older.

If you run PHP for other software on the same server, update each branch to its latest release (8.5.13, 8.3.37 or 8.2.36).

  • Root or sudo access to the rConfig server, or to the Docker host
  • A current backup of the rConfig application directory and database. See backing up rConfig before an update
  • A maintenance window agreed with your team. Apache, PHP-FPM and the Horizon queue workers restart during the update

Run:

Terminal window
php -v

On Docker, run it inside the container:

Terminal window
docker exec rconfig8docker-app-1 php -v

If the first line shows PHP 8.4.28 or later, PHP already has these fixes. Also check the PHP version in Settings → System & Health, in the System Info card. That is the PHP Apache serves, which can differ from the CLI if a service was not restarted.

rConfig V8 Pro Docker image

The rConfig image is built on the official php:8.4-apache-bookworm image. PHP in the image is compiled from source, so it cannot be patched with apt inside the container. The rConfig Pro Docker image runs PHP 8.4.28. Pull the latest image to update.

  1. Record the PHP version the container runs today, so you can compare it after the update:

    Terminal window
    docker exec rconfig8docker-app-1 php -r 'echo PHP_VERSION, PHP_EOL;'
  2. Back up the data directory from the root of your rconfig8docker clone:

    Terminal window
    tar -czf rconfig-data-backup-$(date +%Y%m%d).tar.gz ./data
  3. Pull the latest image:

    Terminal window
    docker compose pull

    Check the output for the app image. Pulled or Downloaded newer image means a new image arrived. Image is up to date means you already had the latest image.

  4. Recreate the container so it runs the new image:

    Terminal window
    docker compose up -d --force-recreate
  5. Confirm the PHP version inside the container is now 8.4.28 or later:

    Terminal window
    docker exec rconfig8docker-app-1 php -r 'echo PHP_VERSION, PHP_EOL;'

    If it shows an older version, the container is not running the latest image. Do not treat the server as updated. Check which image tag your compose file uses, or contact prosupport@rconfig.com.

  6. Confirm all services are running:

    Terminal window
    docker exec rconfig8docker-app-1 supervisorctl status
  1. Run php -v (or docker exec rconfig8docker-app-1 php -v for Docker) and confirm the version is 8.4.28 or later. For vendor backports, where the version number stays the same, confirm the package changelog lists the CVE IDs instead.
  2. Log in to rConfig and open Settings → System & Health.
  3. Check the PHP version in the System Info card.
  4. Run a device backup and open a few pages to confirm rConfig works normally.