PHPackages thijsferyn/edgestash-twig-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. thijsferyn/edgestash-twig-bundle ActiveSymfony-bundle[Templating & Views](/categories/templating) thijsferyn/edgestash-twig-bundle ================================ The EdgestashTwig Symfony bundle adds Edgestash support to Twig. Edgestash is a Varnish Enterprise module that processes Mustache templates in the edge. v1.0.5(6y ago)216MITPHPPHP ^7.2 Since Sep 4Pushed 6y ago2 watchersCompare [ Source](https://github.com/ThijsFeryn/EdgestashTwigBundle)[ Packagist](https://packagist.org/packages/thijsferyn/edgestash-twig-bundle)[ RSS](/packages/thijsferyn-edgestash-twig-bundle/feed)WikiDiscussions master Synced today READMEChangelog (6)Dependencies (2)Versions (8)Used By (0) ThijsFerynEdgestashTwigBundle ============================= [](#thijsferynedgestashtwigbundle) The *ThijsFerynEdgestashTwigBundle* is a Symfony bundle that adds *Edgestash* support to Twig. [Edgestash](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash/) is a [Varnish Enterprise](https://www.varnish-software.com/solutions/varnish-enterprise/) module that processes [Mustache templates](https://mustache.github.io/) on the edge. Edgestash allows for JSON data to be composed into a response using Mustache syntax, ex: `{{variable}}`. Each response can be assigned its own JSON object for truly dynamic responses. JSON can either be fetched from a backend or generated via VCL and any number of JSONs can be assigned to a template. This bundle offers a couple of custom Twig functions and filters that facilitate the use of Edgestash in an unobtrusive way, allowing you to efficiently cache personalized data. Installing `ThijsFerynEdgestashTwigBundle` ------------------------------------------ [](#installing-thijsferynedgestashtwigbundle) `ThijsFerynEdgestashTwigBundle` is available on [Packagist](https://packagist.org/packages/thijsferyn/edgestash-twig-bundle) and can be installed using Composer with the following command: ``` composer require thijsferyn/edgestash-twig-bundle ``` How does Edgestash work? ------------------------ [](#how-does-edgestash-work) [The VCL example on the Edgestash documentation page](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash/#vcl-example) shows how the Mustache template and the JSON data are cached separately. > VCL stands for [*Varnish Configuration Language*](https://varnish-cache.org/docs/trunk/reference/vcl.html) and is the domain-specific programming language that controls the behavior of Varnish. The `edgestash.parse_response()` method will process the template and identify the placeholders that require parsing. Edgestash offers 3 different ways to ingest JSON data used to replace the template placeholders: - [add\_json\_url](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash/#add-json-url): Pass a URL that refers to a JSON endpoint - [add\_json\_url\_csv](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash/#add-json-url-csv): Pass a CSV-style list of URLs that refer to multiple JSON endpoints - [add\_json](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash/#add-json): Pass the JSON as a string Once the JSON is injected, the `edgestash.execute()` method is executed, the turn the JSON and the template into personalized output. How do you trigger Edgestash from Twig templates? ------------------------------------------------- [](#how-do-you-trigger-edgestash-from-twig-templates) ### Edgestash function [](#edgestash-function) The custom `edgestash` Twig function will emit an unparsed Mustache variable, will perform the content negotiation with Varnish and will automatically provide the JSON endpoint. Here's an example: ``` {{ edgestash('username','/session') }} ``` This example will emit a `{{ username }}` variable. Although Twig has similar syntax to Mustache, the variable will not be parsed by Twig. The `/session` endpoint containing JSON data will be sent to Varnish. Varnish will process that JSON data, look for the `username` property and parse it into the `{{ username }}` variable. ### Edgestash filter [](#edgestash-filter) The `edgestash` function is also available as a custom Twig filter. This means you can pipe data to it. Here's an example: ``` {{ username | edgestash('username','/session') }} ``` In this example, Twig will parse the `{{ username }}` variable if the Symfony bundle didn't detect an Edgestash-supported Varnish server. However, if this bundle did detect an Edgestash-supported Varnish server, it will output `{{ username }}` and and send the `/session` endpoint to Varnish. ### The `isEdgestash` function [](#the-isedgestash-function) Although the `edgestash` filter is an ideal way to introduce Edgestash in a non-obtrusive way, unfortunately sometimes Edgestash integration requires some custom template code. Fortunately, the `isEdgestash()` Twig function allows you to detect whether or not the application sits behind and Edgestash-supported Varnish server. This is the same logic that both the `edgestash` filter and function use under the hood for detection. Here's an example: ``` {% if isEdgestash() %} //Edgestash-supported logic {% else %} //Regular Twig logic {% endif %} ``` ### Conditions and loops [](#conditions-and-loops) [Edgestash supports the full Mustache syntax](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash/#variables-and-expressions) and can handle conditions and loops. Here's an example of an if-else-statement using Edgestash: ``` {{ edgestash('#username', '/session') }} Welcome {{ edgestash('username') }} {{ edgestash('/username') }} {{ edgestash('^username') }} Welcome guest {{ edgestash('/username') }} ``` So if the `username` property is detected in the JSON data, the username will be printed. If not, we'll refer to the user as a *guest*. > Please not that a JSON endpoint should only be registered once. Subsequently, the `url` argument can be left blank. However, if the same endpoint is registered multiple times, it will cause no harm since duplicates are removed. Here's an example of a loop using Edgestash: ``` {{ edgestash('#.', '/users') }} {{ edgestash('username') }} {{ edgestash('/.') }} ``` In this example, we loop over a collection of user objects and list the usernames. The output of the `/users` endpoint could look like this: ``` [ {"username":"user 1"}, {"username":"user 2"}, {"username":"user 3"} ] ``` The final output would then be: ``` user 1 user 2 user 3 ``` ### Multiple JSON endpoints [](#multiple-json-endpoints) This Edgestash integration allows for multiple JSON endpoints. Duplicate values are removed and the output of all endpoints is merged into a single JSON object. Here's an example: ``` {{ username | edgestash('username','/session') }} {{ items_in_cart | edgestash('items_in_cart','/cart') }} ``` How does the `ThijsFerynEdgestashTwigBundle` interact with Varnish? ------------------------------------------------------------------- [](#how-does-the-thijsferynedgestashtwigbundle-interact-with-varnish) As previously mentioned, the `edgestash` filter works in a non-obtrusive way. This means it can detect whether or not it sits behind an Edgestash-supported Varnish server. ### Edgestash detection [](#edgestash-detection) In order to announce Edgestash support, Varnish will send the following request header to your origin server containing the application: `Surrogate-Capability: edgestash="EDGESTASH/2.1"` This Symfony bundle looks for this header and if it finds it, Edgestash is supported. On the way back, Varnish needs to know when it should consider the output to be a Mustache template. The `ThijsFerynEdgestashTwigBundle` bundle does this by sending the following response header back to Varnish: `Surrogate-Control: edgestash="EDGESTASH/2.1"` When Varnish detects this response header, it executes the `edgestash.parse_response()` method internally. > Detection happens automatically and the header negotiation is done in [EdgestashTwigSubscriber.php](/EventSubscriber/EdgestashTwigSubscriber.php) ### Processing JSON endpoints [](#processing-json-endpoints) When the `edgestash` function or filter is invoked with a valid URL argument, the URL is added as an internal HTTP request argument in [TwigExtension.php](/TwigExtension.php). The argument is processed by [EdgestashTwigSubscriber.php](/EventSubscriber/EdgestashTwigSubscriber.php) and the URL (or URLs) are exposed using a `Link` header. Here's an example of such a `Link` header: ``` Link: ; rel=edgestash ``` The link header has a `rel=edgestash` property, making it easy to find when the `Link` header contains other non-related data. This is what it would look like when multiple JSON endpoints are registered: ``` Link: ; rel=edgestash, ; rel=edgestash ``` When Edgestash output is detected by Varnish and the `Link` header is parsed, Varnish will trigger the `edgestash.add_json_url_csv` method to retrieve the JSON data through the endpoints. And finally the `edgestash.execute()` method is executed that parses the JSON and adds it to the cached template's placeholders. Varnish requirements -------------------- [](#varnish-requirements) [Edgestash](https://docs.varnish-software.com/varnish-cache-plus/vmods/edgestash) is a proprietary VMOD that is developed and maintained by [Varnish Software](https://www.varnish-software.com). This module is automatically packaged when you sign-up for [Varnish Enterprise](https://www.varnish-software.com/solutions/varnish-enterprise/). If you do not have a *Varnish Enterprise* license, you can also try out Varnish Enterprise and Edgestash using one of our [Cloud images](https://www.varnish-software.com/products/varnish-cloud/) on AWS, Azure or Google Cloud. The minimal VCL required to use the `ThijsFerynEdgestashTwigBundle` is stored in [Resources/Config/default.vcl](/Resources/Config/default.vcl) ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 7 Last Release 2440d ago Major Versions v0.1.2 → v1.0.32019-09-05 ### Community Maintainers ![](https://www.gravatar.com/avatar/b85b8fbf4d63e6e3d86bfbf62dcbc7f968c831bc12564ec9b366c4fb144b55f6?d=identicon)[ThijsFeryn](/maintainers/ThijsFeryn) --- Top Contributors [![ThijsFeryn](https://avatars.githubusercontent.com/u/603546?v=4)](https://github.com/ThijsFeryn "ThijsFeryn (11 commits)") --- Tags symfonytwigcachingmustachevarnishedgestash ### Embed Badge ![Health badge](/badges/thijsferyn-edgestash-twig-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/thijsferyn-edgestash-twig-bundle/health.svg)](https://phpackages.com/packages/thijsferyn-edgestash-twig-bundle) ``` ### Alternatives [craue/twigextensions-bundle Useful Twig extensions for your Symfony project. 81212.3k1](/packages/craue-twigextensions-bundle)[boekkooi/jquery-validation-bundle Jquery form validation bundle for symfony 2 2773.9k1](/packages/boekkooi-jquery-validation-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)