{"componentChunkName":"component---src-templates-post-jsx","path":"/en/cache-api","result":{"data":{"markdownRemark":{"html":"

Drupal 8 arrived with several performance improvements — and performance means caching.

\n

In this article we will look in detail at the cache types provided by Drupal, and how to use them in our custom modules to ensure optimal performance for users.

\n

Before diving into the varieties of cache backends, I want to mention that Drupal 8 provides several modules installed by default:

\n\n

Below is a demonstration of how BigPipe works:

\n\"Alt

\n

Drupal's cache API uses several bins tied to cache tables in the database (prefixed with cache_). You must first request a specific cache bin to interact with the cache API.

\n
$render_cache = \\Drupal::cache('render');
\n

The $render_cache variable above represents a render cache bin object. Note that in this example the cache is called statically. When working within classes — as is standard in custom Drupal modules — it is recommended to use dependency injection by injecting the cache service (cache.render in our example).

\n

The cache API (backend) is based on three fundamental principles that must be well understood to use effectively in custom module development:

\n\n

Cache Tags

\n

Cache tags work on a simple principle: they allow you to tag cached content and render elements with specific tags, which are later invalidated after a defined action.

\n

Example: Imagine a simple Article content type displayed on its own detail page, listing page, or other pages. If we don't manage the cache in the render array that displays content, items will be cached and we may end up showing stale content to users.\nWe can use the node_list tag on all render arrays that display content, ensuring that whenever content is modified, all render arrays tagged with node_list are invalidated and rebuilt with fresh content.

\n\n

( ! ) Note

\n

Cache tags in Drupal 8 do not support tags by bundle. This issue will be resolved in future versions. In the meantime, the Handy Cache Tags module handles this limitation efficiently, allowing bundle-level tags (e.g., handy_cache_tags:node:article).

\n
\n

Cache Contexts

\n

As the name implies, a cache context is based on contexts defined by Drupal — in other words, cache contexts allow you to vary cache in a render array by path, user, language, theme, or other contexts.

\n\n

Cache Max Age

\n

Cache Max-Age lets you cache a render array for a specific duration. It takes a positive integer representing seconds (0, 60, 100, etc.).

\n

Example usage of cache in render arrays:

\n
  //Case of render array\n  $build['#cache']['max-age'] = 0;\n\t\n  //Case of plugin bloc (OOP way)\n  public function getCacheMaxAge()\n  {\n    return 0;\n  }
\n

As mentioned at the beginning of this article, Drupal has the Internal Dynamic Page Cache (manages cache for authenticated users) and Internal Page Cache (manages cache for anonymous users). The latter does not recognize cache max-age — meaning that if you add a max-age in a render array, it will still be cached indefinitely for anonymous users due to Internal Page Cache ignoring max-age.

\n

It is therefore not recommended to use cache max-age in custom development. It is not used in Drupal Core source code either.

","excerpt":"Drupal 8 arrived with several performance improvements — and performance means caching. In this article we will look in detail at the cache types provided by…","frontmatter":{"date":"2020-01-20","metaDate":"2020-01-20","title":"Cache API","tags":["Cache","Performance","Module development","Drupal 8"],"path":"/cache-api","cover":{"childImageSharp":{"fluid":{"base64":"data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAANABQDASIAAhEBAxEB/8QAGAAAAwEBAAAAAAAAAAAAAAAAAAMEAgX/xAAXAQADAQAAAAAAAAAAAAAAAAAAAQIE/9oADAMBAAIQAxAAAAHkUT61w4QI/8QAFxABAQEBAAAAAAAAAAAAAAAAABECAf/aAAgBAQABBQJitZvaqv/EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQMBAT8BP//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQIBAT8BP//EABgQAAIDAAAAAAAAAAAAAAAAAAABIDEy/9oACAEBAAY/AizSh//EABoQAQACAwEAAAAAAAAAAAAAAAEAESFBUXH/2gAIAQEAAT8hK5AKqnsFXLvMsbg4pZ//2gAMAwEAAgADAAAAEMQ//8QAFhEBAQEAAAAAAAAAAAAAAAAAAQAR/9oACAEDAQE/EELL/8QAGBEAAgMAAAAAAAAAAAAAAAAAAAERIVH/2gAIAQIBAT8Qll6f/8QAGhABAAMBAQEAAAAAAAAAAAAAAQARITFxkf/aAAgBAQABPxBLpfGogq/QokeJLcTYKxQ+2/ZaFn//2Q==","aspectRatio":1.5025484199796126,"src":"/static/ef64ba6bb722b02d93e341af50253a73/7b269/speed.jpg","srcSet":"/static/ef64ba6bb722b02d93e341af50253a73/0b320/speed.jpg 480w,\n/static/ef64ba6bb722b02d93e341af50253a73/60b32/speed.jpg 960w,\n/static/ef64ba6bb722b02d93e341af50253a73/7b269/speed.jpg 1474w","srcWebp":"/static/ef64ba6bb722b02d93e341af50253a73/a4c59/speed.webp","srcSetWebp":"/static/ef64ba6bb722b02d93e341af50253a73/bc3bf/speed.webp 480w,\n/static/ef64ba6bb722b02d93e341af50253a73/39337/speed.webp 960w,\n/static/ef64ba6bb722b02d93e341af50253a73/a4c59/speed.webp 1474w","sizes":"(max-width: 1474px) 100vw, 1474px"},"resize":{"src":"/static/ef64ba6bb722b02d93e341af50253a73/c4f3a/speed.jpg"}}}}}},"pageContext":{"isCreatedByStatefulCreatePages":false,"pathSlug":"/cache-api","locale":"en","prev":{"fields":{"locale":"en"},"frontmatter":{"path":"/event-api","title":"Event API","tags":["Event API","Hooks","Drupal 8","Module development"]}},"next":{"fields":{"locale":"en"},"frontmatter":{"path":"/drupal-behaviors","title":"Drupal Behaviors","tags":["jQuery","JavaScript","Module development","Performance","Ajax"]}}}}}