Added working example for ChainCache

Author: Nyholm

cache.rst

@@ -389,7 +389,8 @@ case the value needs to be recalculated.
             cache:
                 pools:
                     my_cache_pool:
-                        adapter: app.my_cache_chain_adapter
+                        adapter: cache.adapter.psr6
+                        provider: app.my_cache_chain_adapter
                     cache.my_redis:
                         adapter: cache.adapter.redis
                         provider: 'redis://user:[email protected]'
@@ -418,17 +419,19 @@ case the value needs to be recalculated.
 
             <framework:config>
                 <framework:cache>
-                    <framework:pool name="my_cache_pool" adapter="app.my_cache_chain_adapter"/>
+                    <framework:pool name="my_cache_pool" adapter="cache.adapter.psr6" provider="app.my_cache_chain_adapter"/>
                     <framework:pool name="cache.my_redis" adapter="cache.adapter.redis" provider="redis://user:[email protected]"/>
+                    <framework:pool name="cache.apcu" adapter="cache.adapter.apcu"/>
+                    <framework:pool name="cache.array" adapter="cache.adapter.array"/>
                 </framework:cache>
             </framework:config>
 
             <services>
                 <service id="app.my_cache_chain_adapter" class="Symfony\Component\Cache\Adapter\ChainAdapter">
                     <argument type="collection">
-                        <argument type="service" value="cache.adapter.array"/>
+                        <argument type="service" value="cache.array"/>
+                        <argument type="service" value="cache.apcu"/>
                         <argument type="service" value="cache.my_redis"/>
-                        <argument type="service" value="cache.adapter.file"/>
                     </argument>
                     <argument>31536000</argument>
                 </service>
@@ -442,28 +445,37 @@ case the value needs to be recalculated.
             'cache' => [
                 'pools' => [
                     'my_cache_pool' => [
-                        'adapter' => 'app.my_cache_chain_adapter',
+                        'adapter' => 'cache.adapter.psr6',
+                        'provider' => 'app.my_cache_chain_adapter',
                     ],
                     'cache.my_redis' => [
                         'adapter' => 'cache.adapter.redis',
                         'provider' => 'redis://user:[email protected]',
                     ],
+                    'cache.apcu' => [
+                        'adapter' => 'cache.adapter.apcu',
+                    ],
+                    'cache.array' => [
+                        'adapter' => 'cache.adapter.array',
+                    ],
                 ],
             ],
         ]);
 
         $container->getDefinition('app.my_cache_chain_adapter', \Symfony\Component\Cache\Adapter\ChainAdapter::class)
             ->addArgument([
-                new Reference('cache.adapter.array'),
+                new Reference('cache.array'),
+                new Reference('cache.apcu'),
                 new Reference('cache.my_redis'),
-                new Reference('cache.adapter.file'),
             ])
             ->addArgument(31536000);
 
 .. note::
 
-    In this configuration there is a ``cache.my_redis`` pool that is used as an
-    adapter in the ``app.my_cache_chain_adapter``
+    In this configuration the ``my_cache_pool`` pool is using the ``cache.adapter.psr6``
+    adapter and the ``app.my_cache_chain_adapter`` service as a provider. That is
+    because ``ChainAdapter`` does not support the ``cache.pool`` tag. So it is decorated
+    with the ``ProxyAdapter``.
 
 
 Using Cache Tags