This document describes CacheTagsBundle, a Symfony bundle that allows tagging responses in order to invalidate specific cache fragments. It works by integrating with Edge Side Includes (ESI) and Varnish to cache fragments independently. The bundle allows tagging responses with plain cache tags or based on request attributes. Tags can then be invalidated through a console command or from controllers.

1. CacheTagsBundle
by Marcin Chyłek

2. Edge Side Includes (ESI)
BackendVarnish
WWW
article 1
article 2
article 3
article 4
Request content
Response content
Request/Response
content

3. ESI + CacheTagsBundle
BackendVarnish
WWW
article 1 (tag: tag_1)
article 2 (tag: tag_2)
article 3 (tag: tag_3)
article 4 (tag: tag_4)
Request content
Response content
Request/Response
content

4. What is CacheTagsBundle?

5. What is CacheTagsBundle?
● Tagging Response

6. What is CacheTagsBundle?
● Tagging Response
● Simple annotation configuration

7. What is CacheTagsBundle?
● Tagging Response
● Simple annotation configuration
● Cache Invalidation

8. How to Use CacheTagsBundle
● Plain cache tag

9. How to Use CacheTagsBundle
● Plain cache tag
● Request attribute tag

10. How to Use CacheTagsBundle
● Plain cache tag
Add annotation @CacheTagPlain to controller
use lbarulskiCacheTagsBundleAnnotationCacheTagPlain;
/**
* @CacheTagPlain("article_name")
**/
public function articleAction(Request $request)
{
}

11. How to Use CacheTagsBundle
● Plain cache tag
Prepare response
$response = new Response('...');
$response->setPublic();
$response->setTtl(3600);

12. How to Use CacheTagsBundle
● Request attribute tag
Implements TagInterface in model
use lbarulskiCacheTagsBundleTagTagInterface;
class Article implements TagInterface
{
public function getTag()
{
return 'article_'.$this->getId();
}
}

13. How to Use CacheTagsBundle
● Plain cache tag
Add annotation @CacheTagRequestAttribute to controller
use lbarulskiCacheTagsBundleAnnotationCacheTagRequestAttribute;
/**
* @ParamConverter("article")
* @CacheTagRequestAttribute("article")
**/
public function articleAction(Article $article)
{
}

14. How to Use CacheTagsBundle
● View Template: use esi controller
{{ render_esi(controller('MainBundle:Article:article', { article:
article.id })}}

15. How to Invalidate CacheTagsBundle
● Invalidate cache tags console
$ ./app/console cache_tags:invalidate tag-name

16. How to Invalidate CacheTagsBundle
● Invalidate cache tags in controller
use lbarulskiCacheTagsBundleTagPlain;
public function updateArticleAction(Article $article)
{
$tag = 'article_name';
$this->get('cache_tags.invalidator')->invalidate(new Plain($tag));
}

17. Link
● https://github.com/lbarulski/CacheTagsBundle
● https://www.varnish-cache.org/

18. marcin@chylek.pl
THANK YOU