How to update PHP to 8.4.28 in rConfig
How to update PHP to 8.4.28
Section titled “How to update PHP to 8.4.28”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.
What changed
Section titled “What changed”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).
Prerequisites
Section titled “Prerequisites”- 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
Check the installed PHP version
Section titled “Check the installed PHP version”Run:
php -vOn Docker, run it inside the container:
docker exec rconfig8docker-app-1 php -vIf 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.
Update PHP
Section titled “Update PHP”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.
-
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;' -
Back up the data directory from the root of your
rconfig8dockerclone:Terminal window tar -czf rconfig-data-backup-$(date +%Y%m%d).tar.gz ./data -
Pull the latest image:
Terminal window docker compose pullCheck the output for the app image.
PulledorDownloaded newer imagemeans a new image arrived.Image is up to datemeans you already had the latest image. -
Recreate the container so it runs the new image:
Terminal window docker compose up -d --force-recreate -
Confirm the PHP version inside the container is now
8.4.28or 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.
-
Confirm all services are running:
Terminal window docker exec rconfig8docker-app-1 supervisorctl status
Ubuntu 20.04 / 22.04 / 24.04
rConfig’s Ubuntu scripts install PHP from ppa:ondrej/php.
-
Store your PHP minor version in a variable:
Terminal window PHPV=$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;')echo $PHPV -
Refresh the package lists:
Terminal window sudo apt-get update -
Check that the candidate version is
8.4.28or later:Terminal window apt-cache policy php${PHPV}-cliIf the Candidate line shows an older version, check that
ppa:ondrej/phpis enabled on the server and runsudo apt-get updateagain, or contact prosupport@rconfig.com. -
Upgrade the installed PHP packages for that version:
Terminal window sudo apt-get install --only-upgrade "php${PHPV}*" "libapache2-mod-php${PHPV}"Packages that are not installed are skipped.
-
Restart PHP-FPM (if you use it) and Apache:
Terminal window sudo systemctl restart php${PHPV}-fpm 2>/dev/nullsudo systemctl restart apache2 -
Restart the Horizon queue workers so they load the new PHP binary:
Terminal window cd /var/www/html/rconfig8/current && sudo php artisan horizon:terminateSupervisor starts Horizon again automatically.
CentOS Stream / Rocky Linux / AlmaLinux 8 and 9
rConfig’s RHEL-family scripts install PHP from the Remi repository module stream (for example php:remi-8.4).
-
Check which PHP module stream is enabled:
Terminal window sudo dnf module list --enabled php -
Refresh metadata and list the available PHP updates:
Terminal window sudo dnf clean metadatasudo dnf --refresh list --upgrades 'php*'If no update to
8.4.28or later is listed, check that the Remi repository is enabled withdnf repolist, or contact prosupport@rconfig.com. -
Upgrade the PHP packages:
Terminal window sudo dnf upgrade 'php*' -
Restart PHP-FPM and Apache:
Terminal window sudo systemctl restart php-fpm httpd -
Restart the Horizon queue workers so they load the new PHP binary:
Terminal window cd /var/www/html/rconfig8/current && sudo php artisan horizon:terminateSupervisor starts Horizon again automatically.
Red Hat Enterprise Linux 8 and 9
A RHEL server gets PHP either from the Remi repository (installed by rConfig’s scripts) or from Red Hat’s own AppStream PHP module. Make sure the subscription is active before you start:
sudo subscription-manager status-
Check where PHP comes from:
Terminal window dnf info --installed php-cli | grep -E "Version|Release|From repo"A repository name containing
remimeans Remi. Anything else (for examplerhel-9-for-x86_64-appstream-rpms) means Red Hat AppStream. -
If PHP comes from Red Hat AppStream, check for the errata and apply them, for example:
Terminal window sudo dnf updateinfo list --cve CVE-2026-129289sudo dnf upgrade --cve CVE-2026-129289Repeat the check for the other CVE IDs in the table above, or confirm the errata with Red Hat or your systems team.
-
If PHP comes from Remi, refresh metadata and upgrade the PHP packages:
Terminal window sudo dnf clean metadatasudo dnf --refresh list --upgrades 'php*'sudo dnf upgrade 'php*' -
Restart PHP-FPM and Apache:
Terminal window sudo systemctl restart php-fpm httpd -
Restart the Horizon queue workers so they load the new PHP binary:
Terminal window cd /var/www/html/rconfig8/current && sudo php artisan horizon:terminate
Check the update
Section titled “Check the update”- Run
php -v(ordocker exec rconfig8docker-app-1 php -vfor Docker) and confirm the version is8.4.28or later. For vendor backports, where the version number stays the same, confirm the package changelog lists the CVE IDs instead. - Log in to rConfig and open Settings → System & Health.
- Check the PHP version in the System Info card.
- Run a device backup and open a few pages to confirm rConfig works normally.
What’s next
Section titled “What’s next”- rConfig Security Advisory rCFG-SA-2026-16 for the latest status
- PHP Foundation release announcement and the PHP 8 changelog
- Updating PHP for rConfig for moving to a newer supported PHP version