@@ -104,6 +104,8 @@ Configuration
104
104
* `php_errors `_
105
105
* `log `_
106
106
* `throw `_
107
+ * `cache <reference-cache >`_
108
+ * `prefix_seed `_
107
109
108
110
secret
109
111
~~~~~~
@@ -1463,6 +1465,27 @@ throw
1463
1465
Throw PHP errors as ``\ErrorException `` instances. The parameter
1464
1466
``debug.error_handler.throw_at `` controls the threshold.
1465
1467
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
+
1466
1489
Full Default Configuration
1467
1490
--------------------------
1468
1491
@@ -1607,3 +1630,4 @@ Full Default Configuration
1607
1630
.. _`Doctrine Cache` : http://docs.doctrine-project.org/projects/doctrine-common/en/latest/reference/caching.html
1608
1631
.. _`egulias/email-validator` : https://github.com/egulias/EmailValidator
1609
1632
.. _`PhpStormProtocol` : https://github.com/aik099/PhpStormProtocol
1633
+ .. _`blue/green deployment` : http://martinfowler.com/bliki/BlueGreenDeployment.html
0 commit comments