@@ -104,6 +104,8 @@ Configuration
104104* `php_errors `_
105105 * `log `_
106106 * `throw `_
107+ * `cache <reference-cache >`_
108+ * `prefix_seed `_
107109
108110secret
109111~~~~~~
@@ -1463,6 +1465,27 @@ throw
14631465Throw PHP errors as ``\ErrorException `` instances. The parameter
14641466``debug.error_handler.throw_at `` controls the threshold.
14651467
1468+ cache
1469+ ~~~~~
1470+
1471+ prefix_seed
1472+ ...........
1473+
1474+ .. versionadded :: 3.2
1475+ The ``prefix_seed `` option was introduced in Symfony 3.2.
1476+
1477+ **type **: ``string `` **default **: ``null ``
1478+
1479+ If defined, this value is used as part of the "namespace" generated for the
1480+ cache item keys. A common practice is to use the unique name of the application
1481+ (e.g. ``symfony.com ``) because that prevents naming collisions when deploying
1482+ multiple applications into the same path (on different servers) that share the
1483+ same cache backend.
1484+
1485+ It's also useful when using `blue/green deployment `_ strategies and more
1486+ generally, when you need to abstract out the actual deployment directory (for
1487+ example, when warming caches offline).
1488+
14661489Full Default Configuration
14671490--------------------------
14681491
@@ -1607,3 +1630,4 @@ Full Default Configuration
16071630.. _`Doctrine Cache` : http://docs.doctrine-project.org/projects/doctrine-common/en/latest/reference/caching.html
16081631.. _`egulias/email-validator` : https://github.com/egulias/EmailValidator
16091632.. _`PhpStormProtocol` : https://github.com/aik099/PhpStormProtocol
1633+ .. _`blue/green deployment` : http://martinfowler.com/bliki/BlueGreenDeployment.html
0 commit comments