class CachePluginBase
Same name in other branches
- 9 core/modules/views/src/Plugin/views/cache/CachePluginBase.php \Drupal\views\Plugin\views\cache\CachePluginBase
- 8.9.x core/modules/views/src/Plugin/views/cache/CachePluginBase.php \Drupal\views\Plugin\views\cache\CachePluginBase
- 10 core/modules/views/src/Plugin/views/cache/CachePluginBase.php \Drupal\views\Plugin\views\cache\CachePluginBase
The base plugin to handle caching.
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements \Drupal\Component\Plugin\PluginInspectionInterface, \Drupal\Component\Plugin\DerivativeInspectionInterface
- class \Drupal\Core\Plugin\PluginBase extends \Drupal\Component\Plugin\PluginBase uses \Drupal\Core\StringTranslation\StringTranslationTrait, \Drupal\Core\DependencyInjection\DependencySerializationTrait, \Drupal\Core\Messenger\MessengerTrait
- class \Drupal\views\Plugin\views\PluginBase extends \Drupal\Core\Plugin\PluginBase implements \Drupal\Core\Plugin\ContainerFactoryPluginInterface, \Drupal\views\Plugin\views\ViewsPluginInterface, \Drupal\Component\Plugin\DependentPluginInterface, \Drupal\Core\Security\TrustedCallbackInterface
- class \Drupal\views\Plugin\views\cache\CachePluginBase extends \Drupal\views\Plugin\views\PluginBase
- class \Drupal\views\Plugin\views\PluginBase extends \Drupal\Core\Plugin\PluginBase implements \Drupal\Core\Plugin\ContainerFactoryPluginInterface, \Drupal\views\Plugin\views\ViewsPluginInterface, \Drupal\Component\Plugin\DependentPluginInterface, \Drupal\Core\Security\TrustedCallbackInterface
- class \Drupal\Core\Plugin\PluginBase extends \Drupal\Component\Plugin\PluginBase uses \Drupal\Core\StringTranslation\StringTranslationTrait, \Drupal\Core\DependencyInjection\DependencySerializationTrait, \Drupal\Core\Messenger\MessengerTrait
Expanded class hierarchy of CachePluginBase
Related topics
8 files declare their use of CachePluginBase
- DisplayKernelTest.php in core/
modules/ views/ tests/ src/ Kernel/ Plugin/ DisplayKernelTest.php - media_library.module in core/
modules/ media_library/ media_library.module - Contains hook implementations for the media_library module.
- test_basetheme.theme in core/
modules/ system/ tests/ themes/ test_basetheme/ test_basetheme.theme - test_subtheme.theme in core/
modules/ system/ tests/ themes/ test_subtheme/ test_subtheme.theme - ViewExecutableTest.php in core/
modules/ views/ tests/ src/ Unit/ ViewExecutableTest.php
File
-
core/
modules/ views/ src/ Plugin/ views/ cache/ CachePluginBase.php, line 29
Namespace
Drupal\views\Plugin\views\cacheView source
abstract class CachePluginBase extends PluginBase {
/**
* Contains all data that should be written/read from cache.
*
* @var array
*/
public $storage = [];
/**
* Which cache bin to store query results in.
*
* @var string
*/
protected $resultsBin = 'data';
/**
* Stores the cache ID used for the results cache.
*
* The cache ID is stored in generateResultsKey() got executed.
*
* @var string
*
* @see \Drupal\views\Plugin\views\cache\CachePluginBase::generateResultsKey()
*/
protected $resultsKey;
/**
* Returns the resultsKey property.
*
* @return string
* The resultsKey property.
*/
public function getResultsKey() {
return $this->resultsKey;
}
/**
* Returns a string to display as the clickable title for the access control.
*/
public function summaryTitle() {
return $this->t('Unknown');
}
/**
* Determine the expiration time of the cache type, or NULL if no expire.
*
* Plugins must override this to implement expiration.
*
* @param $type
* The cache type, either 'query', 'result'.
*/
protected function cacheExpire($type) {
}
/**
* Determine cache expiration time.
*
* Plugins must override this to implement expiration in the cache table. The
* default is CACHE_PERMANENT, indicating that the item will not be removed
* automatically from cache.
*
* @param string $type
* The cache type.
*/
protected function cacheSetMaxAge($type) {
return Cache::PERMANENT;
}
/**
* Save data to the cache.
*
* A plugin should override this to provide specialized caching behavior.
*
* @param $type
* The cache type, either 'query', 'result'.
*/
public function cacheSet($type) {
switch ($type) {
case 'query':
// Not supported currently, but this is certainly where we'd put it.
break;
case 'results':
$data = [
'result' => $this->prepareViewResult($this->view->result),
'total_rows' => $this->view->total_rows ?? 0,
'current_page' => $this->view
->getCurrentPage(),
];
$expire = $this->cacheSetMaxAge($type) === Cache::PERMANENT ? Cache::PERMANENT : (int) $this->view
->getRequest()->server
->get('REQUEST_TIME') + $this->cacheSetMaxAge($type);
\Drupal::cache($this->resultsBin)
->set($this->generateResultsKey(), $data, $expire, $this->getCacheTags());
break;
}
}
/**
* Retrieve data from the cache.
*
* A plugin should override this to provide specialized caching behavior.
*
* @param $type
* The cache type, either 'query', 'result'.
*
* @return bool
* TRUE if data has been taken from the cache, otherwise FALSE.
*/
public function cacheGet($type) {
$cutoff = $this->cacheExpire($type);
switch ($type) {
case 'query':
// Not supported currently, but this is certainly where we'd put it.
return FALSE;
case 'results':
// Values to set: $view->result, $view->total_rows, $view->execute_time,
// $view->current_page.
if ($cache = \Drupal::cache($this->resultsBin)
->get($this->generateResultsKey())) {
if (!$cutoff || $cache->created > $cutoff) {
$this->view->result = $cache->data['result'];
// Load entities for each result.
$this->view->query
->loadEntities($this->view->result);
$this->view->total_rows = $cache->data['total_rows'];
$this->view
->setCurrentPage($cache->data['current_page']);
$this->view->execute_time = 0;
return TRUE;
}
}
return FALSE;
}
}
/**
* Clear out cached data for a view.
*/
public function cacheFlush() {
Cache::invalidateTags($this->view->storage
->getCacheTagsToInvalidate());
}
/**
* Post process any rendered data.
*
* This can be valuable to be able to cache a view and still have some level
* of dynamic output. In an ideal world, the actual output will include HTML
* comment based tokens, and then the post process can replace those tokens.
*
* Example usage. If it is known that the view is a node view and that the
* primary field will be a nid, you can do something like this:
* @code
* <!--post-FIELD-NID-->
* @endcode
*
* And then in the post render, create an array with the text that should
* go there:
*
* @code
* strtr($output, ['<!--post-FIELD-1-->', 'output for FIELD of nid 1']);
* @endcode
*
* All of the cached result data will be available in $view->result, as well,
* so all ids used in the query should be discoverable.
*/
public function postRender(&$output) {
}
/**
* Calculates and sets a cache ID used for the result cache.
*
* @return string
* The generated cache ID.
*/
public function generateResultsKey() {
if (!isset($this->resultsKey)) {
$build_info = $this->view->build_info;
foreach ([
'query',
'count_query',
] as $index) {
// If the default query back-end is used generate SQL query strings from
// the query objects.
if ($build_info[$index] instanceof SelectInterface) {
$query = clone $build_info[$index];
$query->preExecute();
$build_info[$index] = [
'query' => (string) $query,
'arguments' => $query->getArguments(),
];
}
}
$key_data = [
'build_info' => $build_info,
];
// @todo https://www.drupal.org/node/2433591 might solve it to not require
// the pager information here.
$key_data['pager'] = [
'page' => $this->view
->getCurrentPage(),
'items_per_page' => $this->view
->getItemsPerPage(),
'offset' => $this->view
->getOffset(),
];
$key_data += \Drupal::service('cache_contexts_manager')->convertTokensToKeys($this->displayHandler
->getCacheMetadata()
->getCacheContexts())
->getKeys();
$this->resultsKey = $this->view->storage
->id() . ':' . $this->displayHandler->display['id'] . ':results:' . hash('sha256', serialize($key_data));
}
return $this->resultsKey;
}
/**
* Gets an array of cache tags for the current view.
*
* @return string[]
* An array of cache tags based on the current view.
*/
public function getCacheTags() {
$tags = $this->view->storage
->getCacheTags();
// The list cache tags for the entity types listed in this view.
$entity_information = $this->view
->getQuery()
->getEntityTableInfo();
if (!empty($entity_information)) {
// Add the list cache tags for each entity type used by this view.
foreach ($entity_information as $metadata) {
$tags = Cache::mergeTags($tags, \Drupal::entityTypeManager()->getDefinition($metadata['entity_type'])
->getListCacheTags());
}
}
$tags = Cache::mergeTags($tags, $this->view
->getQuery()
->getCacheTags());
return $tags;
}
/**
* Gets the max age for the current view.
*
* @return int
*/
public function getCacheMaxAge() {
$max_age = $this->getDefaultCacheMaxAge();
$max_age = Cache::mergeMaxAges($max_age, $this->view
->getQuery()
->getCacheMaxAge());
return $max_age;
}
/**
* Returns the default cache max age.
*/
protected function getDefaultCacheMaxAge() {
// The default cache backend is not caching anything.
return 0;
}
/**
* Prepares the view result before putting it into cache.
*
* @param \Drupal\views\ResultRow[] $result
* The result containing loaded entities.
*
* @return \Drupal\views\ResultRow[]
* The result without loaded entities.
*/
protected function prepareViewResult(array $result) {
$return = [];
// Clone each row object and remove any loaded entities, to keep the
// original result rows intact.
foreach ($result as $key => $row) {
$clone = clone $row;
$clone->resetEntityData();
$return[$key] = $clone;
}
return $return;
}
/**
* Alters the cache metadata of a display upon saving a view.
*
* @param \Drupal\Core\Cache\CacheableMetadata $cache_metadata
* The cache metadata.
*/
public function alterCacheMetadata(CacheableMetadata $cache_metadata) {
}
/**
* Returns the row cache tags.
*
* @param \Drupal\views\ResultRow $row
* A result row.
*
* @return string[]
* The row cache tags.
*/
public function getRowCacheTags(ResultRow $row) {
$tags = !empty($row->_entity) ? $row->_entity
->getCacheTags() : [];
if (!empty($row->_relationship_entities)) {
foreach ($row->_relationship_entities as $entity) {
$tags = Cache::mergeTags($tags, $entity->getCacheTags());
}
}
return $tags;
}
/**
* Returns the row cache keys.
*
* @param \Drupal\views\ResultRow $row
* A result row.
*
* @return string[]
* The row cache keys.
*/
public function getRowCacheKeys(ResultRow $row) {
return [
'views',
'fields',
$this->view
->id(),
$this->view->current_display,
$this->getRowId($row),
];
}
/**
* Returns a unique identifier for the specified row.
*
* @param \Drupal\views\ResultRow $row
* A result row.
*
* @return string
* The row identifier.
*/
public function getRowId(ResultRow $row) {
// Here we compute a unique identifier for the row by computing the hash of
// its data. We exclude the current index, since the same row could have a
// different result index depending on the user permissions. We exclude also
// entity data, since serializing entity objects is very expensive. Instead
// we include entity cache tags, which are enough to identify all the
// entities associated with the row.
$row_data = array_diff_key((array) $row, array_flip([
'index',
'_entity',
'_relationship_entities',
])) + $this->getRowCacheTags($row);
// This ensures that we get a unique identifier taking field handler access
// into account: users having access to different sets of fields will get
// different row identifiers.
$field_ids = array_keys($this->view->field);
$row_data += array_flip($field_ids);
// Finally we compute a hash of row data and return it as row identifier.
return hash('sha256', serialize($row_data));
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
CachePluginBase::$resultsBin | protected | property | Which cache bin to store query results in. | ||
CachePluginBase::$resultsKey | protected | property | Stores the cache ID used for the results cache. | ||
CachePluginBase::$storage | public | property | Contains all data that should be written/read from cache. | ||
CachePluginBase::alterCacheMetadata | public | function | Alters the cache metadata of a display upon saving a view. | ||
CachePluginBase::cacheExpire | protected | function | Determine the expiration time of the cache type, or NULL if no expire. | 2 | |
CachePluginBase::cacheFlush | public | function | Clear out cached data for a view. | ||
CachePluginBase::cacheGet | public | function | Retrieve data from the cache. | 1 | |
CachePluginBase::cacheSet | public | function | Save data to the cache. | 1 | |
CachePluginBase::cacheSetMaxAge | protected | function | Determine cache expiration time. | 1 | |
CachePluginBase::generateResultsKey | public | function | Calculates and sets a cache ID used for the result cache. | ||
CachePluginBase::getCacheMaxAge | public | function | Gets the max age for the current view. | ||
CachePluginBase::getCacheTags | public | function | Gets an array of cache tags for the current view. | ||
CachePluginBase::getDefaultCacheMaxAge | protected | function | Returns the default cache max age. | 2 | |
CachePluginBase::getResultsKey | public | function | Returns the resultsKey property. | ||
CachePluginBase::getRowCacheKeys | public | function | Returns the row cache keys. | ||
CachePluginBase::getRowCacheTags | public | function | Returns the row cache tags. | ||
CachePluginBase::getRowId | public | function | Returns a unique identifier for the specified row. | ||
CachePluginBase::postRender | public | function | Post process any rendered data. | ||
CachePluginBase::prepareViewResult | protected | function | Prepares the view result before putting it into cache. | ||
CachePluginBase::summaryTitle | public | function | Returns a string to display as the clickable title for the access control. | Overrides PluginBase::summaryTitle | 3 |
DerivativeInspectionInterface::getBaseId | public | function | Gets the base_plugin_id of the plugin instance. | 1 | |
DerivativeInspectionInterface::getDerivativeId | public | function | Gets the derivative_id of the plugin instance. | 1 | |
PluginBase::$definition | public | property | Plugins' definition. | ||
PluginBase::$displayHandler | public | property | The display object this plugin is for. | ||
PluginBase::$options | public | property | Options for this plugin will be held here. | ||
PluginBase::$position | public | property | The handler position. | ||
PluginBase::$renderer | protected | property | Stores the render API renderer. | 3 | |
PluginBase::$usesOptions | protected | property | Denotes whether the plugin has an additional options form. | 8 | |
PluginBase::$view | public | property | The top object of a view. | 1 | |
PluginBase::buildOptionsForm | public | function | Overrides ViewsPluginInterface::buildOptionsForm | 16 | |
PluginBase::calculateDependencies | public | function | Overrides DependentPluginInterface::calculateDependencies | 14 | |
PluginBase::create | public static | function | Overrides ContainerFactoryPluginInterface::create | 61 | |
PluginBase::defineOptions | protected | function | Information about options for all kinds of purposes will be held here. | 18 | |
PluginBase::destroy | public | function | Overrides ViewsPluginInterface::destroy | 2 | |
PluginBase::doFilterByDefinedOptions | protected | function | Do the work to filter out stored options depending on the defined options. | ||
PluginBase::filterByDefinedOptions | public | function | Overrides ViewsPluginInterface::filterByDefinedOptions | ||
PluginBase::getAvailableGlobalTokens | public | function | Overrides ViewsPluginInterface::getAvailableGlobalTokens | ||
PluginBase::getProvider | public | function | Overrides ViewsPluginInterface::getProvider | ||
PluginBase::getRenderer | protected | function | Returns the render API renderer. | 1 | |
PluginBase::globalTokenForm | public | function | Overrides ViewsPluginInterface::globalTokenForm | ||
PluginBase::globalTokenReplace | public | function | Overrides ViewsPluginInterface::globalTokenReplace | ||
PluginBase::INCLUDE_ENTITY | constant | Include entity row languages when listing languages. | |||
PluginBase::INCLUDE_NEGOTIATED | constant | Include negotiated languages when listing languages. | |||
PluginBase::init | public | function | Overrides ViewsPluginInterface::init | 6 | |
PluginBase::listLanguages | protected | function | Makes an array of languages, optionally including special languages. | ||
PluginBase::pluginTitle | public | function | Overrides ViewsPluginInterface::pluginTitle | ||
PluginBase::preRenderAddFieldsetMarkup | public static | function | Overrides ViewsPluginInterface::preRenderAddFieldsetMarkup | ||
PluginBase::preRenderFlattenData | public static | function | Overrides ViewsPluginInterface::preRenderFlattenData | ||
PluginBase::query | public | function | Overrides ViewsPluginInterface::query | 8 | |
PluginBase::queryLanguageSubstitutions | public static | function | Returns substitutions for Views queries for languages. | ||
PluginBase::setOptionDefaults | protected | function | Fills up the options of the plugin with defaults. | ||
PluginBase::submitOptionsForm | public | function | Overrides ViewsPluginInterface::submitOptionsForm | 16 | |
PluginBase::themeFunctions | public | function | Overrides ViewsPluginInterface::themeFunctions | 1 | |
PluginBase::trustedCallbacks | public static | function | Overrides TrustedCallbackInterface::trustedCallbacks | 6 | |
PluginBase::unpackOptions | public | function | Overrides ViewsPluginInterface::unpackOptions | ||
PluginBase::usesOptions | public | function | Overrides ViewsPluginInterface::usesOptions | 8 | |
PluginBase::validate | public | function | Overrides ViewsPluginInterface::validate | 6 | |
PluginBase::validateOptionsForm | public | function | Overrides ViewsPluginInterface::validateOptionsForm | 15 | |
PluginBase::viewsTokenReplace | protected | function | Replaces Views' tokens in a given string. | 1 | |
PluginBase::VIEWS_QUERY_LANGUAGE_SITE_DEFAULT | constant | Query string to indicate the site default language. | |||
PluginBase::__construct | public | function | Constructs a PluginBase object. | 19 | |
PluginInspectionInterface::getPluginDefinition | public | function | Gets the definition of the plugin implementation. | 6 | |
PluginInspectionInterface::getPluginId | public | function | Gets the plugin ID of the plugin instance. | 2 | |
TrustedCallbackInterface::THROW_EXCEPTION | constant | Untrusted callbacks throw exceptions. | |||
TrustedCallbackInterface::TRIGGER_SILENCED_DEPRECATION | constant | Untrusted callbacks trigger silenced E_USER_DEPRECATION errors. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.