Document all core response http control directives

Author: osavchenko

components/http_foundation.rst

@@ -489,13 +489,18 @@ can be used to set the most commonly used cache information in one method
 call::
 
     $response->setCache([
-        'etag'          => 'abcdef',
-        'last_modified' => new \DateTime(),
-        'max_age'       => 600,
-        's_maxage'      => 600,
-        'private'       => false,
-        'public'        => true,
-        'immutable'     => true,
+        'must_revalidate'  => false,
+        'no_cache'         => false,
+        'no_store'         => false,
+        'no_transform'     => false,
+        'public'           => true,
+        'private'          => false,
+        'proxy_revalidate' => false,
+        'max_age'          => 600,
+        's_maxage'         => 600,
+        'immutable'        => true,
+        'last_modified'    => new \DateTime(),
+        'etag'             => 'abcdef'
     ]);
 
 To check if the Response validators (``ETag``, ``Last-Modified``) match a

create_framework/http_kernel_httpkernelinterface.rst

@@ -117,22 +117,28 @@ The Response class contains methods that let you configure the HTTP cache. One
 of the most powerful is ``setCache()`` as it abstracts the most frequently used
 caching strategies into a single array::
 
-    $date = date_create_from_format('Y-m-d H:i:s', '2005-10-15 10:00:00');
-
     $response->setCache([
-        'public'        => true,
-        'etag'          => 'abcde',
-        'last_modified' => $date,
-        'max_age'       => 10,
-        's_maxage'      => 10,
+        'must_revalidate'  => false,
+        'no_cache'         => false,
+        'no_store'         => false,
+        'no_transform'     => false,
+        'public'           => true,
+        'private'          => false,
+        'proxy_revalidate' => false,
+        'max_age'          => 600,
+        's_maxage'         => 600,
+        'immutable'        => true,
+        'last_modified'    => new \DateTime(),
+        'etag'             => 'abcdef'
     ]);
 
     // it is equivalent to the following code
     $response->setPublic();
+    $response->setMaxAge(600);
+    $response->setSharedMaxAge(600);
+    $response->setImmutable();
+    $response->setLastModified(new \DateTime());
     $response->setEtag('abcde');
-    $response->setLastModified($date);
-    $response->setMaxAge(10);
-    $response->setSharedMaxAge(10);
 
 When using the validation model, the ``isNotModified()`` method allows you to
 cut on the response time by short-circuiting the response generation as early as

http_cache.rst

@@ -344,12 +344,18 @@ Additionally, most cache-related HTTP headers can be set via the single
 
     // sets cache settings in one call
     $response->setCache([
-        'etag'          => $etag,
-        'last_modified' => $date,
-        'max_age'       => 10,
-        's_maxage'      => 10,
-        'public'        => true,
-        // 'private'    => true,
+        'must_revalidate'  => false,
+        'no_cache'         => false,
+        'no_store'         => false,
+        'no_transform'     => false,
+        'public'           => true,
+        'private'          => false,
+        'proxy_revalidate' => false,
+        'max_age'          => 600,
+        's_maxage'         => 600,
+        'immutable'        => true,
+        'last_modified'    => new \DateTime(),
+        'etag'             => 'abcdef'
     ]);
 
 Cache Invalidation