From b0dc28f31d3beb1ca43c0e3755ad2fda26bee8f6 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 30 Jun 2019 19:08:25 +0200
Subject: [PATCH] Document how to create cache pool with framework config

---
 cache.rst | 82 ++++++++++++++-----------------------------------------
 1 file changed, 21 insertions(+), 61 deletions(-)

diff --git a/cache.rst b/cache.rst
index 448b3cd3cf1..6144b470979 100644
--- a/cache.rst
+++ b/cache.rst
@@ -234,7 +234,7 @@ You can also create more customized pools:
                     <framework:pool name="my_cache_pool" adapter="cache.adapter.array"/>
                     <framework:pool name="acme.cache" adapter="cache.adapter.memcached"/>
                     <framework:pool name="foobar.cache" adapter="cache.adapter.memcached" provider="memcached://user:password@example.com"/>
-                    <framework:pool name="short_cache" adapter="foobar.cache" default_lifetime="60"/>
+                    <framework:pool name="short_cache" adapter="foobar.cache" default-lifetime="60"/>
                 </framework:cache>
             </framework:config>
         </container>
@@ -380,6 +380,10 @@ To get the best of both worlds you may use a chain of adapters. The idea is to
 first look at the quick adapter and then move on to slower adapters. In the worst
 case the value needs to be recalculated.
 
+.. versionadded:: 4.4
+
+    Support for configuring a chain using ``framework.cache.pools`` was introduced in Symfony 4.4.
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -389,23 +393,11 @@ case the value needs to be recalculated.
             cache:
                 pools:
                     my_cache_pool:
-                        adapter: cache.adapter.psr6
-                        provider: app.my_cache_chain_adapter
-                    cache.my_redis:
-                        adapter: cache.adapter.redis
-                        provider: 'redis://user:password@example.com'
-                    cache.apcu:
-                        adapter: cache.adapter.apcu
-                    cache.array:
-                        adapter: cache.adapter.array
-
-
-        services:
-            app.my_cache_chain_adapter:
-                class: Symfony\Component\Cache\Adapter\ChainAdapter
-                arguments:
-                    - ['@cache.array', '@cache.apcu', '@cache.my_redis']
-                    - 31536000 # One year
+                        default_lifetime: 31536000  # One year
+                        adapters:
+                          - cache.adapter.array
+                          - cache.adapter.apcu
+                          - {name: cache.adapter.redis, provider: 'redis://user:password@example.com'}
 
     .. code-block:: xml
 
@@ -419,23 +411,13 @@ case the value needs to be recalculated.
 
             <framework:config>
                 <framework:cache>
-                    <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:password@example.com"/>
-                    <framework:pool name="cache.apcu" adapter="cache.adapter.apcu"/>
-                    <framework:pool name="cache.array" adapter="cache.adapter.array"/>
+                    <framework:pool name="my_cache_pool" default-lifetime="31536000">
+                        <framework:adapter name="cache.adapter.array" />
+                        <framework:adapter name="cache.adapter.apcu" />
+                        <framework:adapter name="cache.adapter.redis" provider="redis://user:password@example.com" />
+                    </framework:pool>
                 </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.array"/>
-                        <argument type="service" value="cache.apcu"/>
-                        <argument type="service" value="cache.my_redis"/>
-                    </argument>
-                    <argument>31536000</argument>
-                </service>
-            </services>
         </container>
 
     .. code-block:: php
@@ -445,39 +427,17 @@ case the value needs to be recalculated.
             'cache' => [
                 'pools' => [
                     'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.psr6',
-                        'provider' => 'app.my_cache_chain_adapter',
-                    ],
-                    'cache.my_redis' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'provider' => 'redis://user:password@example.com',
-                    ],
-                    'cache.apcu' => [
-                        'adapter' => 'cache.adapter.apcu',
-                    ],
-                    'cache.array' => [
-                        'adapter' => 'cache.adapter.array',
+                        'default_lifetime' => 31536000, // One year
+                        'adapters' => [
+                            'cache.adapter.array',
+                            'cache.adapter.apcu',
+                            ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
+                        ],
                     ],
                 ],
             ],
         ]);
 
-        $container->getDefinition('app.my_cache_chain_adapter', \Symfony\Component\Cache\Adapter\ChainAdapter::class)
-            ->addArgument([
-                new Reference('cache.array'),
-                new Reference('cache.apcu'),
-                new Reference('cache.my_redis'),
-            ])
-            ->addArgument(31536000);
-
-.. note::
-
-    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
 ----------------
 

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>pFad - Phonifier reborn</title>
<meta http-equiv='Content-Type' content='text/html; charset=utf-8' />
</head>
<body>
<h1>Pfad - The Proxy pFad of &#169; 2024 Garber Painting. All rights reserved.</h1>


<!-- Disclaimer -->
<p>Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.</p>
<br>
<p>Alternative Proxies:</p><p><a href="http://rainy.clevelandohioweatherforecast.com/php-proxy/index.php?q=https://patch-diff.githubusercontent.com/raw/symfony/symfony-docs/pull/11855.patch" target="_blank">Alternative Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/index.php?u=https://patch-diff.githubusercontent.com/raw/symfony/symfony-docs/pull/11855.patch" target="_blank">pFad Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v3index.php?u=https://patch-diff.githubusercontent.com/raw/symfony/symfony-docs/pull/11855.patch" target="_blank">pFad v3 Proxy</a></p><p><a href="http://rainy.clevelandohioweatherforecast.com/pFad/v4index.php?u=https://patch-diff.githubusercontent.com/raw/symfony/symfony-docs/pull/11855.patch" target="_blank">pFad v4 Proxy</a></p></body>
</html>