abstract class PurgerBase in Purge 8.3
Provides a base class for all purgers - the cache invalidation executors.
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\purge\Plugin\Purge\Purger\PurgerBase implements PurgerInterface uses PurgeLoggerAwareTrait
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of PurgerBase
1 file declares its use of PurgerBase
- NullPurgerBase.php in tests/
modules/ purge_purger_test/ src/ Plugin/ Purge/ Purger/ NullPurgerBase.php
File
- src/
Plugin/ Purge/ Purger/ PurgerBase.php, line 12
Namespace
Drupal\purge\Plugin\Purge\PurgerView source
abstract class PurgerBase extends PluginBase implements PurgerInterface {
use PurgeLoggerAwareTrait;
/**
* Unique instance ID for this purger.
*
* @var string
*/
protected $id;
/**
* The runtime measurement counter.
*
* @var null|\Drupal\purge\Plugin\Purge\Purger\RuntimeMeasurementInterface
*/
protected $runtimeMeasurement = NULL;
/**
* Construct a PurgerBase derivative.
*
* @param array $configuration
* A configuration array containing information about the plugin instance.
* @param string $plugin_id
* The plugin_id for the plugin instance.
* @param mixed $plugin_definition
* The plugin implementation definition.
*
* @throws \LogicException
* Thrown if $configuration['id'] is missing, see Purger\Service::createId.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition) {
if (!is_string($configuration['id']) || empty($configuration['id'])) {
throw new \LogicException('Purger cannot be constructed without ID.');
}
$this->id = $configuration['id'];
unset($configuration['id']);
parent::__construct($configuration, $plugin_id, $plugin_definition);
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition);
}
/**
* {@inheritdoc}
*/
public function delete() {
if ($this->pluginDefinition['multi_instance']) {
throw new \LogicException('Plugin is multi-instantiable, ::delete() not implemented!');
}
}
/**
* {@inheritdoc}
*/
public function getCooldownTime() {
return $this
->getPluginDefinition()['cooldown_time'];
}
/**
* {@inheritdoc}
*/
public function getIdealConditionsLimit() {
// We don't know how much invalidations our derivatives can process under
// ideal circumstances, it can range from low numbers on inefficient CDNs to
// literally thousands when connecting to efficient systems over a local
// socket. Purger implementations are definitely encouraged to overload this
// method with a value that is as accurately approached as possible.
return 100;
}
/**
* {@inheritdoc}
*/
public function getId() {
return $this->id;
}
/**
* {@inheritdoc}
*/
public function getLabel() {
$label = $this
->getPluginDefinition()['label'];
if ($this
->getPluginDefinition()['multi_instance']) {
return $this
->t('@label @id', [
'@label' => $label,
'@id' => $this->id,
]);
}
else {
return $label;
}
}
/**
* {@inheritdoc}
*/
public function getRuntimeMeasurement() {
return $this->runtimeMeasurement;
}
/**
* {@inheritdoc}
*/
public function getTimeHint() {
if (!$this
->hasRuntimeMeasurement()) {
throw new \LogicException('Since ::hasRuntimeMeasurement() returns FALSE, ::getTimeHint() needs to be implemented! Please read the PurgerCapacityDataInterface::hasRuntimeMeasurement() documentation.');
}
// Return the measured number of seconds, if stored of course.
if (!is_null($this->runtimeMeasurement)) {
if (($measured_time = $this->runtimeMeasurement
->get()) > 0.0) {
return $measured_time;
}
}
// A single invalidation lasting 4.0 seconds is quite terrible, but a safe
// default to use as hint when no measurement was stored yet.
return 4.0;
}
/**
* {@inheritdoc}
*/
public function getTypes() {
return $this
->getPluginDefinition()['types'];
}
/**
* {@inheritdoc}
*/
public function routeTypeToMethod($type) {
return 'invalidate';
}
/**
* {@inheritdoc}
*/
public function setRuntimeMeasurement(RuntimeMeasurementInterface $measurement) {
$this->runtimeMeasurement = $measurement;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
PurgeLoggerAwareTrait:: |
protected | property | Channel logger. | |
PurgeLoggerAwareTrait:: |
public | function | ||
PurgerBase:: |
protected | property | Unique instance ID for this purger. | |
PurgerBase:: |
protected | property | The runtime measurement counter. | |
PurgerBase:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
PurgerBase:: |
public | function |
The current instance of this purger plugin is about to be deleted. Overrides PurgerInterface:: |
1 |
PurgerBase:: |
public | function |
Get the time in seconds to wait after invalidation. Overrides PurgerCapacityDataInterface:: |
|
PurgerBase:: |
public | function |
Retrieve the unique instance ID for this purger instance. Overrides PurgerInterface:: |
|
PurgerBase:: |
public | function |
Get the maximum number of invalidations that this purger can process. Overrides PurgerCapacityDataInterface:: |
1 |
PurgerBase:: |
public | function |
Retrieve the user-readable label for this purger instance. Overrides PurgerInterface:: |
|
PurgerBase:: |
public | function |
Get the runtime measurement counter. Overrides PurgerCapacityDataInterface:: |
|
PurgerBase:: |
public | function |
Get the maximum number of seconds, processing a single invalidation takes. Overrides PurgerCapacityDataInterface:: |
|
PurgerBase:: |
public | function |
Retrieve the list of supported invalidation types. Overrides PurgerInterface:: |
|
PurgerBase:: |
public | function |
Route certain type of invalidations to other methods. Overrides PurgerInterface:: |
|
PurgerBase:: |
public | function |
Inject the runtime measurement counter. Overrides PurgerCapacityDataInterface:: |
|
PurgerBase:: |
public | function |
Construct a PurgerBase derivative. Overrides PluginBase:: |
|
PurgerCapacityDataInterface:: |
public | function | Indicates whether your purger utilizes dynamic runtime measurement. | 1 |
PurgerInterface:: |
public | function | Invalidate content from external caches. | 1 |
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |