Upgrading PHP 8.2 to 8.3 on Rocky Linux 9: Re-compiling APCu, Imagick, and Memcached extensions safely

Prerequisites and Initial Assessment

Before embarking on the PHP upgrade from 8.2 to 8.3 on Rocky Linux 9, a thorough assessment of your current environment is paramount. This includes identifying all installed PHP extensions, their compilation methods (e.g., PECL, distribution packages), and any custom configurations. Understanding dependencies is crucial to avoid service disruptions. We’ll assume you’re using the Remi repository for PHP, which is a common and well-supported choice for RHEL-based systems.

Verify your current PHP version and installed extensions:

• Check PHP version:

• List installed PECL extensions:

• List installed distribution packages (if any):

It’s also advisable to have a rollback plan. This might involve taking snapshots of your server or having a clear procedure to revert to PHP 8.2 if critical issues arise. Ensure your development and staging environments are updated and tested thoroughly before proceeding to production.

Installing PHP 8.3 and Core Dependencies

First, ensure your system is up-to-date and the Remi repository is configured correctly. If not, follow the official Remi repository installation guide for Rocky Linux 9.

Install PHP 8.3 and essential modules. We’ll explicitly install the development headers and libraries, which are critical for compiling PECL extensions.

• Update system packages:

• Install PHP 8.3 and common modules:

The php-devel package provides the necessary header files and tools for compiling PHP extensions. The php-pear package is essential for managing PECL extensions.

Re-compiling APCu Extension

APCu (Alternative PHP Cache Userland) is a widely used in-memory object cache. It needs to be re-compiled against the new PHP 8.3 version.

First, uninstall the existing APCu extension if it was installed via PECL or a package manager. If it was part of a distribution package, you might need to remove the entire PHP 8.2 package group and install the PHP 8.3 equivalents.

• Uninstall existing APCu (if installed via PECL):

Now, install the APCu PECL extension for PHP 8.3. The pecl install command, when run after installing the correct php-devel package, will automatically target the active PHP version.

• Install APCu for PHP 8.3:

After installation, you’ll need to ensure the extension is enabled in your PHP configuration. This typically involves adding a line to a `.ini` file. The exact location can vary, but common paths include /etc/php.d/.

• Add APCu to PHP configuration:

Verify the installation by checking the PHP info output or running php -m.

Re-compiling Imagick Extension

The Imagick extension provides an object-oriented interface to the ImageMagick image processing library. Like APCu, it requires recompilation for PHP 8.3.

Ensure the ImageMagick development libraries are installed. These are separate from the PHP extension itself.

• Install ImageMagick development libraries:

Uninstall the existing Imagick extension if it was installed via PECL.

• Uninstall existing Imagick (if installed via PECL):

Install the Imagick PECL extension for PHP 8.3.

• Install Imagick for PHP 8.3:

Add the Imagick extension to your PHP configuration.

• Add Imagick to PHP configuration:

Confirm the Imagick extension is loaded.

Re-compiling Memcached Extension

The Memcached extension allows PHP to interact with Memcached servers, a distributed memory object caching system. This also requires recompilation.

Install the Memcached client libraries and development headers.

• Install Memcached development libraries:

Uninstall the existing Memcached extension if it was installed via PECL.

• Uninstall existing Memcached (if installed via PECL):

Install the Memcached PECL extension for PHP 8.3.

• Install Memcached for PHP 8.3:

Add the Memcached extension to your PHP configuration.

• Add Memcached to PHP configuration:

Verify the Memcached extension is loaded.

Web Server Configuration and Restart

After recompiling and enabling extensions, you must restart your web server and PHP-FPM to load the new PHP version and extensions. This process varies slightly depending on whether you’re using Apache with mod_php or Nginx with PHP-FPM.

For Nginx with PHP-FPM:

• Restart PHP-FPM service:

• Restart Nginx:

For Apache with mod_php (less common in modern deployments but possible):

• Restart Apache:

If you are using Apache with PHP-FPM (e.g., via `mod_proxy_fcgi`), you would restart the Apache service and the PHP-FPM service as described for Nginx.

Post-Upgrade Verification and Troubleshooting

Thorough verification is the final, critical step. This involves not just checking if PHP 8.3 is running and extensions are loaded, but also testing your applications.

• Verify PHP version and loaded extensions via phpinfo(): Create a simple PHP file (e.g., info.php) in your web root with the following content:

Access this file through your web browser. Search for “PHP Version” and “apcu”, “imagick”, “memcached” within the output to confirm they are present and correctly configured.

• Run application-specific tests: Execute your application’s test suite. Manually test critical user flows and administrative functions. Pay close attention to areas that heavily utilize caching, image manipulation, or external services that might interact with Memcached.

• Check web server and PHP-FPM logs: Monitor /var/log/nginx/error.log (or equivalent for Apache) and /var/log/php-fpm/www-error.log (or your specific FPM pool’s log file) for any new errors or warnings that appeared after the upgrade.

Common Troubleshooting Scenarios:

• Extension not loading: Double-check that the correct php-devel package for PHP 8.3 was installed before attempting to compile the PECL extension. Ensure the `.ini` file enabling the extension is in the correct /etc/php.d/ directory and has the correct syntax (e.g., extension=apcu.so).

• Compilation errors: These often indicate missing development libraries (e.g., ImageMagick, Memcached client libraries). Ensure all `-devel` packages and library headers are installed. Sometimes, compiler flags or specific versions of libraries can cause issues; consult the PECL extension’s documentation for known compatibility problems.

• Application errors: If your application throws errors related to these extensions, it might be due to subtle API changes between PHP versions or incompatible configurations. Review the PHP 8.3 migration guides and the documentation for each extension for any breaking changes. For example, APCu has had significant changes over its lifecycle.

By following these steps methodically, you can ensure a smooth and safe upgrade to PHP 8.3, maintaining the integrity and performance of your critical server infrastructure.