Symfony Bundle for asm89/twig-cache-extension
Clone or download
Latest commit f5188a3 Jul 19, 2018

Twig cache extension Bundle

Build Status SensioLabs Insight Coverage Status Scrutinizer Code Quality Total Downloads

Symfony Bundle for asm89/twig-cache-extension.


Install bundle using Composer

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require emanueleminotto/twig-cache-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Add Bundle to AppKernel

Then, enable the bundle by adding the following line in the app/AppKernel.php file of your project:

// app/AppKernel.php

// ...
class AppKernel extends Kernel
    public function registerBundles()
        $bundles = array(
            // ...

            new EmanueleMinotto\TwigCacheBundle\TwigCacheBundle(),

Configure services

This bundle allows to easily configure the caching service the extension will use for the caching. The extension by default supports instances of Doctrine\Common\Cache\Cache but allows you to use packages that provide a psr/cache-implementation.

# app/config/config.yml
    service: cache_service # instance of Doctrine\Common\Cache\Cache or Psr\Cache\CacheItemPoolInterface

Configuring a PSR-6 Cache pool implementation is possible by changing the extension's default adapter class to the PsrCacheAdapter that is provided with the extension.

# parameters.yml
twig_cache.adapter.class: Asm89\Twig\CacheExtension\CacheProvider\PsrCacheAdapter

After that, you should install a package that provides a psr/cache-implementation. A wide variety of implementations already can be found at: After installing an adapter with composer, it can be configured to do the caching for this bundle. The CacheBundle allows easy configuration by creating a Symfony service for the cache pool adapter.

# config.yml
            factory: 'cache.factory.apcu'

    service: cache.provider.twig_apcu


The default strategy is the IndexedChainingCacheStrategy so you can use directly this code in your Twig templates.

{# delegate to lifetime strategy #}
{% cache 'v1/summary' {time: 300} %}
    {# heavy lifting template stuff here, include/render other partials etc #}
{% endcache %}

{# delegate to generational strategy #}
{% cache 'v1/summary' {gen: item} %}
    {# heavy lifting template stuff here, include/render other partials etc #}
{% endcache %}



This bundle is under the MIT license. See the complete license in the bundle: