How to update php-redis extension and why you might need to do so during shopware updates This post gives you an explanation on why you might need to update the php-redis when upgrading to the latest shopware versions and how you can do so hassle-free
Why you might need to update the php-redis extension during Shopware updates?
The latest shopware 6.7.7.0 version included the upgrade to Symfony LTS version 7.4. Because the previously used Symfony 7.3 version stopped being actively supported in Jan 2026, shopware's 6.6 LTS version will receive the Symfony update as well as part of the next release. The update from Symfony 7.3 to 7.4 is only a minor upgrade, so it should not include any breaking changes. While that is true on the code level of Symfony itself, Symfony did increase the needed minimum version of the php-redis extension to 6.1 as part of the minor update. So if you currently use an older version of the extension, you will need to update the extension in order to successfully update shopware. This might especially be the case if you rely on older versions of Linux distributions; the 24.04 LTS version of Ubuntu, for example, ships php-redis extension in version 5.3, which is not compatible, and you need to take action to update the package accordingly.
How can I figure out which php-redis version I'm currently running?
You can check the installed version of php-redis extension by running the following command:
When that command indicates that you are running on version 6.1 or newer you are ready to update to the latest shopware version without further action. If you currently run on an older version, you need to update that first.
How to update the php-redis extension in Docker
Docker makes it easy to control the full environment; therefore, it is straightforward to update the php-redis extension in your Dockerfile.
First you should download the php extension installer for Docker and make it executable:
That script helps you to manage php extensions.
Next you can install the php-redis extension:
By default, that will install the latest stable version of the extension. It might be the case that you pinned the installed version, and you need to upgrade that:
When you use the official shopware/docker image, that update is already done automatically, and you just need to make sure that you update to the latest version of the image.
How to update the php-redis extension in Ubuntu
You can install the php-redis extension in Ubuntu through the default package manager:
However, depending on the Ubuntu version you are using, the extension available in the official package repository might be too old.
In that case, you can install the package from the ondrej/php package repository, which is the trusted source for pre-built php packages:
After that when you install the php-redis extension it should pick up the latest version:
How to install the extension locally (with PIE)
There is a new extension installer in the PHP ecosystem called PIE. PIE makes installing extensions easier and installs the latest versions from Packagist. PIE is intended to replace the old PECL installer and works similarly to Composer.
To install PIE follow the installation instructions from the official repository:
When you have PIE installed, you can install the php-redis extension by running:
How to install the extension locally (with PECL)
PECL is the old-school extension installer in the PHP ecosystem; setting it up is not as straightforward as PIE, so it is not recommended anymore. However, if you have already set up PECL, you can continue using that.
If you have PECL set up, you can install the latest extension by running:
