@@ -38,8 +38,8 @@ to implement the validation model: ``ETag`` and ``Last-Modified``.
38
38
Validation with the ``ETag `` Header
39
39
-----------------------------------
40
40
41
- The `` ETag `` ("entity-tag") header is an optional HTTP header whose value is an
42
- arbitrary string that uniquely identifies one representation of the target
41
+ The `HTTP ETag `_ ("entity-tag") header is an optional HTTP header whose value is
42
+ an arbitrary string that uniquely identifies one representation of the target
43
43
resource. It's entirely generated and set by your application so that you can
44
44
tell, for example, if the ``/about `` resource that's stored by the cache is
45
45
up-to-date with what your application would return.
@@ -78,10 +78,10 @@ to 304.
78
78
79
79
When using ``mod_deflate `` or ``mod_brotli `` in Apache 2.4, the original
80
80
``ETag `` value is modified (e.g. if ``ETag `` was ``foo ``, Apache turns it
81
- into ``foo-gzip `` or ``foo-brotli ``), which breaks the ETag-based validation.
81
+ into ``foo-gzip `` or ``foo-br ``), which breaks the ETag-based validation.
82
82
83
83
Starting from Apache 2.5, you can control this behavior with the
84
- `` DeflateAlterETag `` and `` BrotliAlterETag `` directives. Alternatively, you
84
+ `DeflateAlterETag `_ and `BrotliAlterETag `_ directives. Alternatively, you
85
85
can use the following Apache configuration to keep both the original ETag
86
86
and the modified one when compressing responses:
87
87
@@ -236,3 +236,6 @@ headers that must not be present for ``304`` responses (see
236
236
:method: `Symfony\\ Component\\ HttpFoundation\\ Response::setNotModified `).
237
237
238
238
.. _`expiration model` : https://tools.ietf.org/html/rfc2616#section-13.2
239
+ .. _`HTTP ETag` : https://en.wikipedia.org/wiki/HTTP_ETag
240
+ .. _`DeflateAlterETag` : https://httpd.apache.org/docs/trunk/mod/mod_deflate.html
241
+ .. _`BrotliAlterETag` : https://httpd.apache.org/docs/2.4/mod/mod_brotli.html
0 commit comments