@@ -190,6 +190,7 @@ Configuration
190190
191191* `session `_
192192
193+ * `cache_limiter `_
193194 * `cookie_domain `_
194195 * `cookie_httponly `_
195196 * `cookie_lifetime `_
@@ -1208,6 +1209,50 @@ cookie_path
12081209This determines the path to set in the session cookie. By default, it will
12091210use ``/ ``.
12101211
1212+ cache_limiter
1213+ .............
1214+
1215+ **type **: ``string `` or ``int `` **default **: ``'' ``
1216+
1217+ If set to ``0 ``, Symfony won't set any particular header related to the cache
1218+ and it will rely on the cache control method configured in the
1219+ `session.cache-limiter `_ PHP.ini option.
1220+
1221+ Unlike the other session options, ``cache_limiter `` is set as a regular
1222+ :doc: `container parameter </service_container/parameters >`:
1223+
1224+ .. configuration-block ::
1225+
1226+ .. code-block :: yaml
1227+
1228+ # app/config/services.yml
1229+ parameters :
1230+ session.storage.options :
1231+ cache_limiter : 0
1232+
1233+ .. code-block :: xml
1234+
1235+ <!-- app/config/services.xml -->
1236+ <?xml version =" 1.0" encoding =" UTF-8" ?>
1237+ <container xmlns =" http://symfony.com/schema/dic/services"
1238+ xmlns : xsi =" http://www.w3.org/2001/XMLSchema-instance"
1239+ xsi : schemaLocation =" http://symfony.com/schema/dic/services
1240+ https://symfony.com/schema/dic/services/services-1.0.xsd" >
1241+
1242+ <parameters >
1243+ <parameter key =" session.storage.options" type =" collection" >
1244+ <parameter key =" cache_limiter" >0</parameter >
1245+ </parameter >
1246+ </parameters >
1247+ </container >
1248+
1249+ .. code-block :: php
1250+
1251+ // app/config/services.php
1252+ $container->setParameter('session.storage.options', [
1253+ 'cache_limiter' => 0,
1254+ ]);
1255+
12111256 cookie_domain
12121257.............
12131258
@@ -2791,4 +2836,5 @@ to know their differences.
27912836.. _`default_socket_timeout` : https://php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
27922837.. _`PEM formatted` : https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
27932838.. _`haveibeenpwned.com` : https://haveibeenpwned.com/
2839+ .. _`session.cache-limiter` : https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
27942840.. _`Microsoft NTLM authentication protocol` : https://docs.microsoft.com/en-us/windows/desktop/secauthn/microsoft-ntlm
0 commit comments