diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 7aa44f1a924..1bdecdc2fed 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -142,6 +142,7 @@ Configuration * `session`_ + * `cache_limiter`_ * `cookie_domain`_ * `cookie_httponly`_ * `cookie_lifetime`_ @@ -867,6 +868,50 @@ cookie_path This determines the path to set in the session cookie. By default, it will use ``/``. +cache_limiter +............. + +**type**: ``string`` or ``int`` **default**: ``''`` + +If set to ``0``, Symfony won't set any particular header related to the cache +and it will rely on the cache control method configured in the +`session.cache-limiter`_ PHP.ini option. + +Unlike the other session options, ``cache_limiter`` is set as a regular +:doc:`container parameter `: + +.. configuration-block:: + + .. code-block:: yaml + + # app/config/services.yml + parameters: + session.storage.options: + cache_limiter: 0 + + .. code-block:: xml + + + + + + + + 0 + + + + + .. code-block:: php + + // app/config/services.php + $container->setParameter('session.storage.options', [ + 'cache_limiter' => 0, + ]); + cookie_domain ............. @@ -2332,3 +2377,4 @@ to know their differences. .. _`blue/green deployment`: http://martinfowler.com/bliki/BlueGreenDeployment.html .. _`gulp-rev`: https://www.npmjs.com/package/gulp-rev .. _`webpack-manifest-plugin`: https://www.npmjs.com/package/webpack-manifest-plugin +.. _`session.cache-limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter