Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

EZEE-1901: Implement Fastly Shielding #1848

Merged
merged 5 commits into from
Jan 11, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions docs/guide/cache/symfony_reverse_proxy.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,22 @@ Using a different proxy is highly recommended as they provide better performance

Use of Varnish or Fastly is a requirement for a [Clustering](../clustering.md) setup, as Symfony Proxy does not support sharing cache between several application servers.

## Recommended VCL base files
## VCL base files

For reverse proxies to work properly with your installation, you need to adapt one of the provided VCL files as the basis:
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/ezsystems/ezplatform-http-cache/blob/2.0/docs/varnish/vcl/varnish5.vcl)
- Fastly VCL can be found in `vendor/ezsystems/ezplatform-http-cache-fastly/fastly`
- [Varnish VCL xkey example](https://github.com/ezsystems/ezplatform-http-cache/tree/2.3/docs/varnish/vcl)
- Fastly VCLs can be found in `vendor/ezsystems/ezplatform-http-cache-fastly/fastly`
- `ez_main.vcl` needs to installed as the main custom VCL
- `ez_user_hash.vcl` also needs to be installed as custom VCL
- `snippet_re_enable_shielding.vcl` needs to be installed as snippet. See comments in the .vcl file itself for
instructions on how to install it.

The provided .vcl files will work both with [Fastly Shielding](https://docs.fastly.com/en/guides/shielding) enabled and without it.

!!! tip
Support for Fastly Shielding was added in Ibexa DXP v3.3.24 and V4.1.6

!!! tip

Expand Down