From cd120f3abfc741543078929d56931768f6bc5e93 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Wed, 21 Jan 2026 14:34:50 +0100 Subject: [PATCH 1/3] =?UTF-8?q?reverse=5Fproxy.md:=20varnish5.vcl=20?= =?UTF-8?q?=E2=86=92=20varnish7.vcl+parameters.vcl?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../cache/http_cache/reverse_proxy.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md b/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md index ee48ad7cbd..41c7e57755 100644 --- a/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md +++ b/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md @@ -47,8 +47,11 @@ Using a different proxy is highly recommended as they provide better performance For reverse proxies to work properly with your installation, you need to add the corresponding VCL files for your HTTP Cache. -- [Varnish VCL xkey example](https://github.com/ibexa/http-cache/blob/main/docs/varnish/vcl/varnish5.vcl) -- Fastly can be found in `vendor/ibexa/fastly/fastly`. You must install the following to use Fastly: +- Varnish config can be found in `vendor/ibexa/http-cache/docs/varnish/vcl`: + - use [parameters.vcl](https://github.com/ibexa/http-cache/blob/main/docs/varnish/vcl/parameters.vcl) for installation specific settings + - plus one of the `varnish*.vcl` corresponding to your Varnish version + - For example, [varnish7.vcl](https://github.com/ibexa/http-cache/blob/main/docs/varnish/vcl/varnish7.vcl) when using Varnish 7 +- Fastly config can be found in `vendor/ibexa/fastly/fastly`. You must install the following to use Fastly: - `ibexa_main.vcl` as the **main** custom VCL - `ibexa_user_hash.vcl` as another custom VCL - `snippet_re_enable_shielding.vcl` as snippet From 107dbbe1c9d6e9ef5a02ed0ba64f939b08257995 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Wed, 21 Jan 2026 14:37:54 +0100 Subject: [PATCH 2/3] =?UTF-8?q?content=5Faware=5Fcache.md:=20Fix=20?= =?UTF-8?q?=20spacing=20in=201=CB=A2=E1=B5=97=20and=203=CA=B3=E1=B5=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../cache/http_cache/content_aware_cache.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md b/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md index 91bd9eb0e7..702b495812 100644 --- a/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md +++ b/docs/infrastructure_and_maintenance/cache/http_cache/content_aware_cache.md @@ -521,7 +521,7 @@ The output is: Now, investigate the response of each of these ESI fragments to understand what is going on. It's important to put that URL in single quotes as the URLS to the ESIs include special characters that can be interpreted by the shell. -#### 1st ESI +#### 1st ESI ```bash $ curl -IXGET --resolve www.staging.foobar.com.us-2.platformsh.site:443:1.2.3.4 --header "Surrogate-Capability: abc=ESI/1.0" --header "x-user-context-hash: daea248406c0043e62997b37292bf93a8c91434e8661484983408897acd93814" 'https://www.staging.foobar.com.us-2.platformsh.site/_fragment?_hash=B%2BLUWB2kxTCc6nc5aEEn0eEqBSFar%2Br6jNm8fvSKdWU%3D&_path=locationId%3D2%26contentId%3D52%26blockId%3D11%26versionNo%3D3%26languageCode%3Deng-GB%26serialized_siteaccess%3D%257B%2522name%2522%253A%2522site%2522%252C%2522matchingType%2522%253A%2522default%2522%252C%2522matcher%2522%253Anull%252C%2522provider%2522%253Anull%257D%26serialized_siteaccess_matcher%3Dnull%26_format%3Dhtml%26_locale%3Den_GB%26_controller%3DEzSystems%255CEzPlatformPageFieldTypeBundle%255CController%255CBlockController%253A%253ArenderAction' @@ -549,7 +549,7 @@ Surrogate-Key: ez-all c52 l2 The headers here look correct and don't indicate that this ESI isn't cached by the HTTP cache. The second ESI has a similar response. -#### 3rd ESI +#### 3rd ESI ```bash $ curl -IXGET --resolve www.staging.foobar.com.us-2.platformsh.site:443:1.2.3.4 --header "Surrogate-Capability: abc=ESI/1.0" --header "x-user-context-hash: daea248406c0043e62997b37292bf93a8c91434e8661484983408897acd93814" 'https://www.staging.foobar.com.us-2.platformsh.site//_fragment?_hash=lnKTnmv6bb1XpaMPWRjV3sNazbn9rDXskhjGae1BDw8%3D&_path=locationId%3D2%26contentId%3D52%26blockId%3D13%26versionNo%3D3%26languageCode%3Deng-GB%26serialized_siteaccess%3D%257B%2522name%2522%253A%2522site%2522%252C%2522matchingType%2522%253A%2522default%2522%252C%2522matcher%2522%253Anull%252C%2522provider%2522%253Anull%257D%26serialized_siteaccess_matcher%3Dnull%26_format%3Dhtml%26_locale%3Den_GB%26_controller%3DEzSystems%255CCustomBundle%255CController%255CFooController%253A%253AcustomAction' From 0f31d0e3700371df32c058307d9ea8a880660924 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Thu, 22 Jan 2026 10:59:45 +0100 Subject: [PATCH 3/3] reverse_proxy.md: Use latest_tag_5_0 in GitHub links --- .../cache/http_cache/reverse_proxy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md b/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md index 41c7e57755..c672765d53 100644 --- a/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md +++ b/docs/infrastructure_and_maintenance/cache/http_cache/reverse_proxy.md @@ -48,9 +48,9 @@ Using a different proxy is highly recommended as they provide better performance For reverse proxies to work properly with your installation, you need to add the corresponding VCL files for your HTTP Cache. - Varnish config can be found in `vendor/ibexa/http-cache/docs/varnish/vcl`: - - use [parameters.vcl](https://github.com/ibexa/http-cache/blob/main/docs/varnish/vcl/parameters.vcl) for installation specific settings + - use [parameters.vcl](https://github.com/ibexa/http-cache/blob/v[[= latest_tag_5_0 =]]/docs/varnish/vcl/parameters.vcl) for installation specific settings - plus one of the `varnish*.vcl` corresponding to your Varnish version - - For example, [varnish7.vcl](https://github.com/ibexa/http-cache/blob/main/docs/varnish/vcl/varnish7.vcl) when using Varnish 7 + - For example, [varnish7.vcl](https://github.com/ibexa/http-cache/blob/v[[= latest_tag_5_0 =]]/docs/varnish/vcl/varnish7.vcl) when using Varnish 7 - Fastly config can be found in `vendor/ibexa/fastly/fastly`. You must install the following to use Fastly: - `ibexa_main.vcl` as the **main** custom VCL - `ibexa_user_hash.vcl` as another custom VCL