From 48f55e270be134289036fa35d7a395c9e6ad0657 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= Date: Tue, 27 May 2014 11:06:48 +0200 Subject: [PATCH] document the mysterious abc part of the header One can't help but wonder what it is about. --- cookbook/cache/varnish.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/cookbook/cache/varnish.rst b/cookbook/cache/varnish.rst index da06add99f1..7dd46d9a11f 100644 --- a/cookbook/cache/varnish.rst +++ b/cookbook/cache/varnish.rst @@ -38,6 +38,11 @@ application: set req.http.Surrogate-Capability = "abc=ESI/1.0"; } +.. note:: + + The ``abc`` part of the header isn't important unless you have multiple "surrogates" + that need to advertise their capabilities. See `Surrogate-Capability Header`_ for details. + Then, optimize Varnish so that it only parses the Response contents when there is at least one ESI tag by checking the ``Surrogate-Control`` header that Symfony2 adds automatically: @@ -217,3 +222,4 @@ absolute URLs: .. _`Varnish`: https://www.varnish-cache.org .. _`Edge Architecture`: http://www.w3.org/TR/edge-arch .. _`GZIP and Varnish`: https://www.varnish-cache.org/docs/3.0/phk/gzip.html +.. _`Surrogate-Capability Header`: http://www.w3.org/TR/edge-arch