Skip to content

Commit 0bf898c

Browse files
javiereguiluzxabbuh
authored andcommitted
Added docs for framework.cache.prefix_seed
1 parent 7a8e74a commit 0bf898c

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

reference/configuration/framework.rst

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,8 @@ Configuration
104104
* `php_errors`_
105105
* `log`_
106106
* `throw`_
107+
* `cache <reference-cache>`_
108+
* `prefix_seed`_
107109

108110
secret
109111
~~~~~~
@@ -1463,6 +1465,27 @@ throw
14631465
Throw 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+
14661489
Full 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

Comments
 (0)