Skip to content

Commit 0a8ae28

Browse files
committed
Added some links
1 parent 38833c1 commit 0a8ae28

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

http_cache/validation.rst

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,8 @@ to implement the validation model: ``ETag`` and ``Last-Modified``.
3838
Validation with the ``ETag`` Header
3939
-----------------------------------
4040

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
4343
resource. It's entirely generated and set by your application so that you can
4444
tell, for example, if the ``/about`` resource that's stored by the cache is
4545
up-to-date with what your application would return.
@@ -78,10 +78,10 @@ to 304.
7878

7979
When using ``mod_deflate`` or ``mod_brotli`` in Apache 2.4, the original
8080
``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.
8282

8383
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
8585
can use the following Apache configuration to keep both the original ETag
8686
and the modified one when compressing responses:
8787

@@ -236,3 +236,6 @@ headers that must not be present for ``304`` responses (see
236236
:method:`Symfony\\Component\\HttpFoundation\\Response::setNotModified`).
237237

238238
.. _`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

Comments
 (0)