@@ -77,20 +77,21 @@ Before using the Twig templates to render some contents, they are compiled into
7777regular PHP code. Compilation is a costly process, so the result is cached in
7878the directory defined by this configuration option.
7979
80- Set this option to ``false `` to disable Twig template compilation. However, this
81- is not recommended; not even in the ``dev `` environment, because the
82- ``auto_reload `` option ensures that cached templates which have changed get
83- compiled again.
80+ You can either specify a custom path where the cache should be stored (as a
81+ string) or use ``true `` to let Symfony decide the default path. When set to
82+ ``true ``, the cache is stored in ``%kernel.cache_dir%/twig `` by default. However,
83+ if ``auto_reload `` is disabled and ``%kernel.build_dir% `` differs from
84+ ``%kernel.cache_dir% ``, the cache will be stored in ``%kernel.build_dir%/twig `` instead.
8485
85- Specify the path where the cache should be stored. If set to ``true ``, the cache
86- defaults to ``%kernel.cache_dir%/twig ``. However, if the ``auto_reload `` option is
87- disabled and ``%kernel.build_dir% `` is different from ``%kernel.cache_dir% ``,
88- the cache will instead be stored in ``%kernel.build_dir%/twig ``.
86+ Set this option to ``false `` to disable Twig template compilation. However, this
87+ is not recommended, not even in the ``dev `` environment, because the ``auto_reload ``
88+ option ensures that cached templates which have changed get compiled again.
8989
9090.. versionadded :: 7.3
9191
92- Support for ``true `` value was added in Symfony 7.3, and it became the default
93- value for this option instead of ``%kernel.cache_dir%/twig ``.
92+ Support for using ``true `` as a value was introduced in Symfony 7.3. It also
93+ became the default value for this option, replacing the explicit path
94+ ``%kernel.cache_dir%/twig ``.
9495
9596charset
9697~~~~~~~
0 commit comments