public function RenderCache::getCacheableRenderArray in Drupal 8
Same name and namespace in other branches
- 9 core/lib/Drupal/Core/Render/RenderCache.php \Drupal\Core\Render\RenderCache::getCacheableRenderArray()
Gets a cacheable render array for a render array and its rendered output.
Given a render array and its rendered output (HTML string), return an array data structure that allows the render array and its associated metadata to be cached reliably (and is serialization-safe).
If Drupal needs additional rendering metadata to be cached at some point, consumers of this method will continue to work. Those who only cache certain parts of a render array will cease to work.
Parameters
array $elements: A render array, on which \Drupal\Core\Render\RendererInterface::render() has already been invoked.
Return value
array An array representing the cacheable data for this render array.
Overrides RenderCacheInterface::getCacheableRenderArray
2 calls to RenderCache::getCacheableRenderArray()
- PlaceholderingRenderCache::set in core/
lib/ Drupal/ Core/ Render/ PlaceholderingRenderCache.php - Caches the rendered output of a renderable array.
- RenderCache::set in core/
lib/ Drupal/ Core/ Render/ RenderCache.php - Caches the rendered output of a renderable array.
File
- core/
lib/ Drupal/ Core/ Render/ RenderCache.php, line 321
Class
- RenderCache
- Wraps the caching logic for the render caching system.
Namespace
Drupal\Core\RenderCode
public function getCacheableRenderArray(array $elements) {
$data = [
'#markup' => $elements['#markup'],
'#attached' => $elements['#attached'],
'#cache' => [
'contexts' => $elements['#cache']['contexts'],
'tags' => $elements['#cache']['tags'],
'max-age' => $elements['#cache']['max-age'],
],
];
// Preserve cacheable items if specified. If we are preserving any cacheable
// children of the element, we assume we are only interested in their
// individual markup and not the parent's one, thus we empty it to minimize
// the cache entry size.
if (!empty($elements['#cache_properties']) && is_array($elements['#cache_properties'])) {
$data['#cache_properties'] = $elements['#cache_properties'];
// Extract all the cacheable items from the element using cache
// properties.
$cacheable_items = array_intersect_key($elements, array_flip($elements['#cache_properties']));
$cacheable_children = Element::children($cacheable_items);
if ($cacheable_children) {
$data['#markup'] = '';
// Cache only cacheable children's markup.
foreach ($cacheable_children as $key) {
// We can assume that #markup is safe at this point.
$cacheable_items[$key] = [
'#markup' => Markup::create($cacheable_items[$key]['#markup']),
];
}
}
$data += $cacheable_items;
}
$data['#markup'] = Markup::create($data['#markup']);
return $data;
}