Cache

Cache

Using a cache is a great way of making your application run quicker. The Symfony cache component ships with many adapters to different storages. Every adapter is developed for high performance.

The following example shows a typical usage of the cache:

  1. use Symfony\Contracts\Cache\ItemInterface;
  3. // The callable will only be executed on a cache miss.
  4. $value = $pool->get('my_cache_key', function (ItemInterface $item) {
  5.     $item->expiresAfter(3600);
  7.     // ... do some HTTP request or heavy computations
  8.     $computedValue = 'foobar';
  10.     return $computedValue;
  11. });
  13. echo $value; // 'foobar'
  15. // ... and to remove the cache key
  16. $pool->delete('my_cache_key');

Symfony supports Cache Contracts, PSR-6/16 and Doctrine Cache interfaces. You can read more about these at the component documentation.

Configuring Cache with FrameworkBundle

When configuring the cache component there are a few concepts you should know of:

Pool

This is a service that you will interact with. Each pool will always have its own namespace and cache items. There is never a conflict between pools.

Adapter

An adapter is a template that you use to create pools.

Provider

A provider is a service that some adapters use to connect to the storage. Redis and Memcached are example of such adapters. If a DSN is used as the provider then a service is automatically created.

There are two pools that are always enabled by default. They are cache.app and cache.system. The system cache is used for things like annotations, serializer, and validation. The cache.app can be used in your code. You can configure which adapter (template) they use by using the app and system key like:

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         app: cache.adapter.filesystem
    5.         system: cache.adapter.system

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd
    8.         http://symfony.com/schema/dic/symfony
    9.         https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    11.     <framework:config>
    12.         <framework:cache app="cache.adapter.filesystem"
    13.             system="cache.adapter.system"
    14.         />
    15.     </framework:config>
    16. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Config\FrameworkConfig;
    4. return static function (FrameworkConfig $framework) {
    5.     $framework->cache()
    6.         ->app('cache.adapter.filesystem')
    7.         ->system('cache.adapter.system')
    8.     ;
    9. };

The Cache component comes with a series of adapters pre-configured:

New in version 5.2: cache.adapter.redis_tag_aware has been introduced in Symfony 5.2.

Some of these adapters could be configured via shortcuts. Using these shortcuts will create pools with service IDs that follow the pattern cache.[type].

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         directory: '%kernel.cache_dir%/pools' # Only used with cache.adapter.filesystem
    6.         # service: cache.doctrine
    7.         default_doctrine_provider: 'app.doctrine_cache'
    8.         # service: cache.psr6
    9.         default_psr6_provider: 'app.my_psr6_service'
    10.         # service: cache.redis
    11.         default_redis_provider: 'redis://localhost'
    12.         # service: cache.memcached
    13.         default_memcached_provider: 'memcached://localhost'
    14.         # service: cache.pdo
    15.         default_pdo_provider: 'doctrine.dbal.default_connection'

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd
    8.         http://symfony.com/schema/dic/symfony
    9.         https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    11.     <framework:config>
    12.         <!--
    13.         default_doctrine_provider: Service: cache.doctrine
    14.         default_psr6_provider: Service: cache.psr6
    15.         default_redis_provider: Service: cache.redis
    16.         default_memcached_provider: Service: cache.memcached
    17.         default_pdo_provider: Service: cache.pdo
    18.         -->
    19.         <!-- "directory" attribute is only used with cache.adapter.filesystem -->
    20.         <framework:cache directory="%kernel.cache_dir%/pools"
    21.             default_doctrine_provider="app.doctrine_cache"
    22.             default_psr6_provider="app.my_psr6_service"
    23.             default_redis_provider="redis://localhost"
    24.             default_memcached_provider="memcached://localhost"
    25.             default_pdo_provider="doctrine.dbal.default_connection"
    26.         />
    27.     </framework:config>
    28. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Config\FrameworkConfig;
    4. return static function (FrameworkConfig $framework) {
    5.     $framework->cache()
    6.         // Only used with cache.adapter.filesystem
    7.         ->directory('%kernel.cache_dir%/pools')
    8.         // Service: cache.doctrine
    9.         ->defaultDoctrineProvider('app.doctrine_cache')
    10.         // Service: cache.psr6
    11.         ->defaultPsr6Provider('app.my_psr6_service')
    12.         // Service: cache.redis
    13.         ->defaultRedisProvider('redis://localhost')
    14.         // Service: cache.memcached
    15.         ->defaultMemcachedProvider('memcached://localhost')
    16.         // Service: cache.pdo
    17.         ->defaultPdoProvider('doctrine.dbal.default_connection')
    18.     ;
    19. };

Creating Custom (Namespaced) Pools

You can also create more customized pools:

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         default_memcached_provider: 'memcached://localhost'
    6.         pools:
    7.             # creates a "custom_thing.cache" service
    8.             # autowireable via "CacheInterface $customThingCache"
    9.             # uses the "app" cache configuration
    10.             custom_thing.cache:
    11.                 adapter: cache.app
    13.             # creates a "my_cache_pool" service
    14.             # autowireable via "CacheInterface $myCachePool"
    15.             my_cache_pool:
    16.                 adapter: cache.adapter.filesystem
    18.             # uses the default_memcached_provider from above
    19.             acme.cache:
    20.                 adapter: cache.adapter.memcached
    22.             # control adapter's configuration
    23.             foobar.cache:
    24.                 adapter: cache.adapter.memcached
    25.                 provider: 'memcached://user:[email protected]'
    27.             # uses the "foobar.cache" pool as its backend but controls
    28.             # the lifetime and (like all pools) has a separate cache namespace
    29.             short_cache:
    30.                 adapter: foobar.cache
    31.                 default_lifetime: 60

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd
    8.         http://symfony.com/schema/dic/symfony
    9.         https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    11.     <framework:config>
    12.         <framework:cache default-memcached-provider="memcached://localhost">
    13.             <!-- creates a "custom_thing.cache" service
    14.                  autowireable via "CacheInterface $customThingCache"
    15.                  uses the "app" cache configuration -->
    16.             <framework:pool name="custom_thing.cache" adapter="cache.app"/>
    18.             <!-- creates a "my_cache_pool" service
    19.                  autowireable via "CacheInterface $myCachePool" -->
    20.             <framework:pool name="my_cache_pool" adapter="cache.adapter.filesystem"/>
    22.             <!-- uses the default_memcached_provider from above -->
    23.             <framework:pool name="acme.cache" adapter="cache.adapter.memcached"/>
    25.             <!-- control adapter's configuration -->
    26.             <framework:pool name="foobar.cache" adapter="cache.adapter.memcached"
    27.                 provider="memcached://user:[email protected]"
    28.             />
    30.             <!-- uses the "foobar.cache" pool as its backend but controls
    31.                  the lifetime and (like all pools) has a separate cache namespace -->
    32.             <framework:pool name="short_cache" adapter="foobar.cache" default-lifetime="60"/>
    33.         </framework:cache>
    34.     </framework:config>
    35. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Config\FrameworkConfig;
    4. return static function (FrameworkConfig $framework) {
    5.     $cache = $framework->cache();
    6.     $cache->defaultMemcachedProvider('memcached://localhost');
    8.     // creates a "custom_thing.cache" service
    9.     // autowireable via "CacheInterface $customThingCache"
    10.     // uses the "app" cache configuration
    11.     $cache->pool('custom_thing.cache')
    12.         ->adapters(['cache.app']);
    14.     // creates a "my_cache_pool" service
    15.     // autowireable via "CacheInterface $myCachePool"
    16.     $cache->pool('my_cache_pool')
    17.         ->adapters(['cache.adapter.filesystem']);
    19.     // uses the default_memcached_provider from above
    20.     $cache->pool('acme.cache')
    21.         ->adapters(['cache.adapter.memcached']);
    23.      // control adapter's configuration
    24.     $cache->pool('foobar.cache')
    25.         ->adapters(['cache.adapter.memcached'])
    26.         ->provider('memcached://user:[email protected]');
    28.     $cache->pool('short_cache')
    29.         ->adapters(['foobar.cache'])
    30.         ->defaultLifetime(60);
    31. };

Each pool manages a set of independent cache keys: keys from different pools never collide, even if they share the same backend. This is achieved by prefixing keys with a namespace that’s generated by hashing the name of the pool, the name of the cache adapter class and a configurable seed that defaults to the project directory and compiled container class.

Each custom pool becomes a service whose service ID is the name of the pool (e.g. custom_thing.cache). An autowiring alias is also created for each pool using the camel case version of its name - e.g. custom_thing.cache can be injected automatically by naming the argument $customThingCache and type-hinting it with either Symfony\Contracts\Cache\CacheInterface or Psr\Cache\CacheItemPoolInterface:

  1. use Symfony\Contracts\Cache\CacheInterface;
  3. // from a controller method
  4. public function listProducts(CacheInterface $customThingCache)
  5. {
  6.     // ...
  7. }
  9. // in a service
  10. public function __construct(CacheInterface $customThingCache)
  11. {
  12.     // ...
  13. }

Tip

If you need the namespace to be interoperable with a third-party app, you can take control over auto-generation by setting the namespace attribute of the cache.pool service tag. For example, you can override the service definition of the adapter:

  • YAML

    1. # config/services.yaml
    2. services:
    3.     app.cache.adapter.redis:
    4.         parent: 'cache.adapter.redis'
    5.         tags:
    6.             - { name: 'cache.pool', namespace: 'my_custom_namespace' }

  • XML

    1. <!-- config/services.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    6.         https://symfony.com/schema/dic/services/services-1.0.xsd">
    8.     <services>
    9.         <service id="app.cache.adapter.redis" parent="cache.adapter.redis">
    10.             <tag name="cache.pool" namespace="my_custom_namespace"/>
    11.         </service>
    12.     </services>
    13. </container>

  • PHP

    1. // config/services.php
    2. namespace Symfony\Component\DependencyInjection\Loader\Configurator;
    4. return function(ContainerConfigurator $configurator) {
    5.     $services = $configurator->services();
    7.     $services->set('app.cace.adapter.redis')
    8.         ->parent('cache.adapter.redis')
    9.         ->tag('cache.pool', ['namespace' => 'my_custom_namespace']);
    10. };

Custom Provider Options

Some providers have specific options that can be configured. The RedisAdapter allows you to create providers with the options timeout, retry_interval. etc. To use these options with non-default values you need to create your own \Redis provider and use that when configuring the pool.

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         pools:
    5.             cache.my_redis:
    6.                 adapter: cache.adapter.redis
    7.                 provider: app.my_custom_redis_provider
    9. services:
    10.     app.my_custom_redis_provider:
    11.         class: \Redis
    12.         factory: ['Symfony\Component\Cache\Adapter\RedisAdapter', 'createConnection']
    13.         arguments:
    14.             - 'redis://localhost'
    15.             - { retry_interval: 2, timeout: 10 }

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd
    8.         http://symfony.com/schema/dic/symfony
    9.         https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    11.     <framework:config>
    12.         <framework:cache>
    13.             <framework:pool name="cache.my_redis" adapter="cache.adapter.redis" provider="app.my_custom_redis_provider"/>
    14.         </framework:cache>
    15.     </framework:config>
    17.     <services>
    18.         <service id="app.my_custom_redis_provider" class="\Redis">
    19.             <factory class="Symfony\Component\Cache\Adapter\RedisAdapter" method="createConnection"/>
    20.             <argument>redis://localhost</argument>
    21.             <argument type="collection">
    22.                 <argument key="retry_interval">2</argument>
    23.                 <argument key="timeout">10</argument>
    24.             </argument>
    25.         </service>
    26.     </services>
    27. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Component\Cache\Adapter\RedisAdapter;
    3. use Symfony\Component\DependencyInjection\ContainerBuilder;
    4. use Symfony\Config\FrameworkConfig;
    6. return static function (ContainerBuilder $container, FrameworkConfig $framework) {
    7.     $framework->cache()
    8.         ->pool('cache.my_redis')
    9.             ->adapters(['cache.adapter.redis'])
    10.             ->provider('app.my_custom_redis_provider');
    12.     $container->register('app.my_custom_redis_provider', \Redis::class)
    13.         ->setFactory([RedisAdapter::class, 'createConnection'])
    14.         ->addArgument('redis://localhost')
    15.         ->addArgument([
    16.             'retry_interval' => 2,
    17.             'timeout' => 10
    18.         ])
    19.     ;
    20. };

Creating a Cache Chain

Different cache adapters have different strengths and weaknesses. Some might be really quick but optimized to store small items and some may be able to contain a lot of data but are quite slow. To get the best of both worlds you may use a chain of adapters.

A cache chain combines several cache pools into a single one. When storing an item in a cache chain, Symfony stores it in all pools sequentially. When retrieving an item, Symfony tries to get it from the first pool. If it’s not found, it tries the next pools until the item is found or an exception is thrown. Because of this behavior, it’s recommended to define the adapters in the chain in order from fastest to slowest.

If an error happens when storing an item in a pool, Symfony stores it in the other pools and no exception is thrown. Later, when the item is retrieved, Symfony stores the item automatically in all the missing pools.

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         pools:
    5.             my_cache_pool:
    6.                 default_lifetime: 31536000  # One year
    7.                 adapters:
    8.                   - cache.adapter.array
    9.                   - cache.adapter.apcu
    10.                   - {name: cache.adapter.redis, provider: 'redis://user:[email protected]'}

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd">
    9.     <framework:config>
    10.         <framework:cache>
    11.             <framework:pool name="my_cache_pool" default-lifetime="31536000">
    12.                 <framework:adapter name="cache.adapter.array"/>
    13.                 <framework:adapter name="cache.adapter.apcu"/>
    14.                 <framework:adapter name="cache.adapter.redis" provider="redis://user:[email protected]"/>
    15.             </framework:pool>
    16.         </framework:cache>
    17.     </framework:config>
    18. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Config\FrameworkConfig;
    4. return static function (FrameworkConfig $framework) {
    5.     $framework->cache()
    6.         ->pool('my_cache_pool')
    7.             ->defaultLifetime(31536000) // One year
    8.             ->adapters([
    9.                 'cache.adapter.array',
    10.                 'cache.adapter.apcu',
    11.                 ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:[email protected]'],
    12.             ])
    13.     ;
    14. };

Using Cache Tags

In applications with many cache keys it could be useful to organize the data stored to be able to invalidate the cache more efficiently. One way to achieve that is to use cache tags. One or more tags could be added to the cache item. All items with the same key could be invalidated with one function call:

  1. use Symfony\Contracts\Cache\ItemInterface;
  2. use Symfony\Contracts\Cache\TagAwareCacheInterface;
  4. class SomeClass
  5. {
  6.     private $myCachePool;
  8.     // using autowiring to inject the cache pool
  9.     public function __construct(TagAwareCacheInterface $myCachePool)
  10.     {
  11.         $this->myCachePool = $myCachePool;
  12.     }
  14.     public function someMethod()
  15.     {
  16.         $value0 = $this->myCachePool->get('item_0', function (ItemInterface $item) {
  17.             $item->tag(['foo', 'bar']);
  19.             return 'debug';
  20.         });
  22.         $value1 = $this->myCachePool->get('item_1', function (ItemInterface $item) {
  23.             $item->tag('foo');
  25.             return 'debug';
  26.         });
  28.         // Remove all cache keys tagged with "bar"
  29.         $this->myCachePool->invalidateTags(['bar']);
  30.     }
  31. }

The cache adapter needs to implement Symfony\Contracts\Cache\TagAwareCacheInterface to enable this feature. This could be added by using the following configuration.

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         pools:
    5.             my_cache_pool:
    6.                 adapter: cache.adapter.redis
    7.                 tags: true

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd
    8.         http://symfony.com/schema/dic/symfony
    9.         https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    11.     <framework:config>
    12.         <framework:cache>
    13.           <framework:pool name="my_cache_pool" adapter="cache.adapter.redis" tags="true"/>
    14.         </framework:cache>
    15.     </framework:config>
    16. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Config\FrameworkConfig;
    4. return static function (FrameworkConfig $framework) {
    5.     $framework->cache()
    6.         ->pool('my_cache_pool')
    7.             ->tags(true)
    8.             ->adapters(['cache.adapter.redis'])
    9.     ;
    10. };

Tags are stored in the same pool by default. This is good in most scenarios. But sometimes it might be better to store the tags in a different pool. That could be achieved by specifying the adapter.

  • YAML

    1. # config/packages/cache.yaml
    2. framework:
    3.     cache:
    4.         pools:
    5.             my_cache_pool:
    6.                 adapter: cache.adapter.redis
    7.                 tags: tag_pool
    8.             tag_pool:
    9.                 adapter: cache.adapter.apcu

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd">
    9.     <framework:config>
    10.         <framework:cache>
    11.           <framework:pool name="my_cache_pool" adapter="cache.adapter.redis" tags="tag_pool"/>
    12.           <framework:pool name="tag_pool" adapter="cache.adapter.apcu"/>
    13.         </framework:cache>
    14.     </framework:config>
    15. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Config\FrameworkConfig;
    4. return static function (FrameworkConfig $framework) {
    5.     $framework->cache()
    6.         ->pool('my_cache_pool')
    7.             ->tags('tag_pool')
    8.             ->adapters(['cache.adapter.redis'])
    9.     ;
    11.     $framework->cache()
    12.         ->pool('tag_pool')
    13.             ->adapters(['cache.adapter.apcu'])
    14.     ;
    15. };

Note

The interface Symfony\Contracts\Cache\TagAwareCacheInterface is autowired to the cache.app service.

Clearing the Cache

To clear the cache you can use the bin/console cache:pool:clear [pool] command. That will remove all the entries from your storage and you will have to recalculate all the values. You can also group your pools into “cache clearers”. There are 3 cache clearers by default:

  • cache.global_clearer
  • cache.system_clearer
  • cache.app_clearer

The global clearer clears all the cache items in every pool. The system cache clearer is used in the bin/console cache:clear command. The app clearer is the default clearer.

To see all available cache pools:

  1. $ php bin/console cache:pool:list

Clear one pool:

  1. $ php bin/console cache:pool:clear my_cache_pool

Clear all custom pools:

  1. $ php bin/console cache:pool:clear cache.app_clearer

Clear all caches everywhere:

  1. $ php bin/console cache:pool:clear cache.global_clearer

Encrypting the Cache

New in version 5.1: The Symfony\Component\Cache\Marshaller\SodiumMarshaller class was introduced in Symfony 5.1.

To encrypt the cache using libsodium, you can use the Symfony\Component\Cache\Marshaller\SodiumMarshaller.

First, you need to generate a secure key and add it to your secret store as CACHE_DECRYPTION_KEY:

  1. $ php -r 'echo base64_encode(sodium_crypto_box_keypair());'

Then, register the SodiumMarshaller service using this key:

  • YAML

    1. # config/packages/cache.yaml
    3. # ...
    4. services:
    5.     Symfony\Component\Cache\Marshaller\SodiumMarshaller:
    6.         decorates: cache.default_marshaller
    7.         arguments:
    8.             - ['%env(base64:CACHE_DECRYPTION_KEY)%']
    9.             # use multiple keys in order to rotate them
    10.             #- ['%env(base64:CACHE_DECRYPTION_KEY)%', '%env(base64:OLD_CACHE_DECRYPTION_KEY)%']
    11.             - '@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'

  • XML

    1. <!-- config/packages/cache.xml -->
    2. <?xml version="1.0" encoding="UTF-8" ?>
    3. <container xmlns="http://symfony.com/schema/dic/services"
    4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    5.     xmlns:framework="http://symfony.com/schema/dic/symfony"
    6.     xsi:schemaLocation="http://symfony.com/schema/dic/services
    7.         https://symfony.com/schema/dic/services/services-1.0.xsd
    8.         http://symfony.com/schema/dic/symfony
    9.         https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    11.     <!-- ... -->
    13.     <services>
    14.         <service id="Symfony\Component\Cache\Marshaller\SodiumMarshaller" decorates="cache.default_marshaller">
    15.             <argument type="collection">
    16.                 <argument>env(base64:CACHE_DECRYPTION_KEY)</argument>
    17.                 <!-- use multiple keys in order to rotate them -->
    18.                 <!-- <argument>env(base64:OLD_CACHE_DECRYPTION_KEY)</argument> -->
    19.             </argument>
    20.             <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
    21.         </service>
    22.     </services>
    23. </container>

  • PHP

    1. // config/packages/cache.php
    2. use Symfony\Component\Cache\Marshaller\SodiumMarshaller;
    3. use Symfony\Component\DependencyInjection\ChildDefinition;
    4. use Symfony\Component\DependencyInjection\Reference;
    6. // ...
    7. $container->setDefinition(SodiumMarshaller::class, new ChildDefinition('cache.default_marshaller'))
    8.     ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)'])
    9.     // use multiple keys in order to rotate them
    10.     //->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
    11.     ->addArgument(new Reference(SodiumMarshaller::class.'.inner'));

Caution

This will encrypt the values of the cache items, but not the cache keys. Be careful not the leak sensitive data in the keys.

When configuring multiple keys, the first key will be used for reading and writing, and the additional key(s) will only be used for reading. Once all cache items encrypted with the old key have expired, you can remove OLD_CACHE_DECRYPTION_KEY completely.

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.