class DatabaseStorageExpirable
Same name in other branches
- 9 core/lib/Drupal/Core/KeyValueStore/DatabaseStorageExpirable.php \Drupal\Core\KeyValueStore\DatabaseStorageExpirable
- 8.9.x core/lib/Drupal/Core/KeyValueStore/DatabaseStorageExpirable.php \Drupal\Core\KeyValueStore\DatabaseStorageExpirable
- 11.x core/lib/Drupal/Core/KeyValueStore/DatabaseStorageExpirable.php \Drupal\Core\KeyValueStore\DatabaseStorageExpirable
Defines a default key/value store implementation for expiring items.
This key/value store implementation uses the database to store key/value data with an expire date.
Hierarchy
- class \Drupal\Core\KeyValueStore\StorageBase implements \Drupal\Core\KeyValueStore\KeyValueStoreInterface
- class \Drupal\Core\KeyValueStore\DatabaseStorage extends \Drupal\Core\KeyValueStore\StorageBase uses \Drupal\Core\DependencyInjection\DependencySerializationTrait
- class \Drupal\Core\KeyValueStore\DatabaseStorageExpirable extends \Drupal\Core\KeyValueStore\DatabaseStorage implements \Drupal\Core\KeyValueStore\KeyValueStoreExpirableInterface
- class \Drupal\Core\KeyValueStore\DatabaseStorage extends \Drupal\Core\KeyValueStore\StorageBase uses \Drupal\Core\DependencyInjection\DependencySerializationTrait
Expanded class hierarchy of DatabaseStorageExpirable
1 file declares its use of DatabaseStorageExpirable
- GarbageCollectionTest.php in core/
tests/ Drupal/ KernelTests/ Core/ KeyValueStore/ GarbageCollectionTest.php
File
-
core/
lib/ Drupal/ Core/ KeyValueStore/ DatabaseStorageExpirable.php, line 15
Namespace
Drupal\Core\KeyValueStoreView source
class DatabaseStorageExpirable extends DatabaseStorage implements KeyValueStoreExpirableInterface {
/**
* Overrides Drupal\Core\KeyValueStore\StorageBase::__construct().
*
* @param string $collection
* The name of the collection holding key and value pairs.
* @param \Drupal\Component\Serialization\SerializationInterface $serializer
* The serialization class to use.
* @param \Drupal\Core\Database\Connection $connection
* The database connection to use.
* @param \Drupal\Component\Datetime\TimeInterface|string|null $time
* The time service.
* @param string $table
* The name of the SQL table to use, defaults to key_value_expire.
*/
public function __construct($collection, SerializationInterface $serializer, Connection $connection, TimeInterface|string|null $time = NULL, $table = 'key_value_expire') {
if (is_null($time)) {
@trigger_error('Calling ' . __METHOD__ . ' without the $time argument is deprecated in drupal:10.3.0 and it will be required in drupal:11.0.0. See https://www.drupal.org/node/3387233', E_USER_DEPRECATED);
$this->time = \Drupal::time();
}
elseif (is_string($time)) {
@trigger_error('Calling ' . __METHOD__ . ' with the $table as 4th argument is deprecated in drupal:10.3.0 and it will be the 5th argument in drupal:11.0.0. See https://www.drupal.org/node/3387233', E_USER_DEPRECATED);
$table = $time;
$this->time = \Drupal::time();
}
parent::__construct($collection, $serializer, $connection, $table);
}
/**
* {@inheritdoc}
*/
public function has($key) {
try {
return (bool) $this->connection
->query('SELECT 1 FROM {' . $this->connection
->escapeTable($this->table) . '} WHERE [collection] = :collection AND [name] = :key AND [expire] > :now', [
':collection' => $this->collection,
':key' => $key,
':now' => $this->time
->getRequestTime(),
])
->fetchField();
} catch (\Exception $e) {
$this->catchException($e);
return FALSE;
}
}
/**
* {@inheritdoc}
*/
public function getMultiple(array $keys) {
try {
$values = $this->connection
->query('SELECT [name], [value] FROM {' . $this->connection
->escapeTable($this->table) . '} WHERE [expire] > :now AND [name] IN ( :keys[] ) AND [collection] = :collection', [
':now' => $this->time
->getRequestTime(),
':keys[]' => $keys,
':collection' => $this->collection,
])
->fetchAllKeyed();
return array_map([
$this->serializer,
'decode',
], $values);
} catch (\Exception $e) {
// @todo Perhaps if the database is never going to be available,
// key/value requests should return FALSE in order to allow exception
// handling to occur but for now, keep it an array, always.
// https://www.drupal.org/node/2787737
$this->catchException($e);
}
return [];
}
/**
* {@inheritdoc}
*/
public function getAll() {
try {
$values = $this->connection
->query('SELECT [name], [value] FROM {' . $this->connection
->escapeTable($this->table) . '} WHERE [collection] = :collection AND [expire] > :now', [
':collection' => $this->collection,
':now' => $this->time
->getRequestTime(),
])
->fetchAllKeyed();
return array_map([
$this->serializer,
'decode',
], $values);
} catch (\Exception $e) {
$this->catchException($e);
}
return [];
}
/**
* Saves a value for a given key with a time to live.
*
* This will be called by setWithExpire() within a try block.
*
* @param string $key
* The key of the data to store.
* @param mixed $value
* The data to store.
* @param int $expire
* The time to live for items, in seconds.
*/
protected function doSetWithExpire($key, $value, $expire) {
$this->connection
->merge($this->table)
->keys([
'name' => $key,
'collection' => $this->collection,
])
->fields([
'value' => $this->serializer
->encode($value),
'expire' => $this->time
->getRequestTime() + $expire,
])
->execute();
}
/**
* {@inheritdoc}
*/
public function setWithExpire($key, $value, $expire) {
try {
$this->doSetWithExpire($key, $value, $expire);
} catch (\Exception $e) {
// If there was an exception, then try to create the table.
if ($this->ensureTableExists()) {
$this->doSetWithExpire($key, $value, $expire);
}
else {
throw $e;
}
}
}
/**
* Sets a value for a given key with a time to live if it does not yet exist.
*
* This will be called by setWithExpireIfNotExists() within a try block.
*
* @param string $key
* The key of the data to store.
* @param mixed $value
* The data to store.
* @param int $expire
* The time to live for items, in seconds.
*
* @return bool
* TRUE if the data was set, or FALSE if it already existed.
*/
protected function doSetWithExpireIfNotExists($key, $value, $expire) {
if (!$this->has($key)) {
$this->setWithExpire($key, $value, $expire);
return TRUE;
}
return FALSE;
}
/**
* {@inheritdoc}
*/
public function setWithExpireIfNotExists($key, $value, $expire) {
try {
return $this->doSetWithExpireIfNotExists($key, $value, $expire);
} catch (\Exception $e) {
// If there was an exception, try to create the table.
if ($this->ensureTableExists()) {
return $this->doSetWithExpireIfNotExists($key, $value, $expire);
}
else {
throw $e;
}
}
}
/**
* {@inheritdoc}
*/
public function setMultipleWithExpire(array $data, $expire) {
foreach ($data as $key => $value) {
$this->setWithExpire($key, $value, $expire);
}
}
/**
* {@inheritdoc}
*/
public function deleteMultiple(array $keys) {
parent::deleteMultiple($keys);
}
/**
* Defines the schema for the key_value_expire table.
*/
public static function schemaDefinition() {
return [
'description' => 'Generic key/value storage table with an expiration.',
'fields' => [
'collection' => [
'description' => 'A named collection of key and value pairs.',
'type' => 'varchar_ascii',
'length' => 128,
'not null' => TRUE,
'default' => '',
],
'name' => [
// KEY is an SQL reserved word, so use 'name' as the key's field name.
'description' => 'The key of the key/value pair.',
'type' => 'varchar_ascii',
'length' => 128,
'not null' => TRUE,
'default' => '',
],
'value' => [
'description' => 'The value of the key/value pair.',
'type' => 'blob',
'not null' => TRUE,
'size' => 'big',
],
'expire' => [
'description' => 'The time since Unix epoch in seconds when this item expires. Defaults to the maximum possible time.',
'type' => 'int',
'not null' => TRUE,
'default' => 2147483647,
],
],
'primary key' => [
'collection',
'name',
],
'indexes' => [
'expire' => [
'expire',
],
],
];
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
DatabaseStorage::$connection | protected | property | The database connection. | ||
DatabaseStorage::$serializer | protected | property | The serialization class to use. | ||
DatabaseStorage::$table | protected | property | The name of the SQL table to use. | ||
DatabaseStorage::catchException | protected | function | Act on an exception when the table might not have been created. | ||
DatabaseStorage::deleteAll | public | function | Deletes all items from the key/value store. | Overrides KeyValueStoreInterface::deleteAll | |
DatabaseStorage::doSet | protected | function | Saves a value for a given key. | ||
DatabaseStorage::doSetIfNotExists | public | function | Saves a value for a given key if it does not exist yet. | ||
DatabaseStorage::ensureTableExists | protected | function | Check if the table exists and create it if not. | ||
DatabaseStorage::rename | public | function | Renames a key. | Overrides KeyValueStoreInterface::rename | |
DatabaseStorage::set | public | function | Saves a value for a given key. | Overrides KeyValueStoreInterface::set | |
DatabaseStorage::setIfNotExists | public | function | Saves a value for a given key if it does not exist yet. | Overrides KeyValueStoreInterface::setIfNotExists | |
DatabaseStorageExpirable::deleteMultiple | public | function | Deletes multiple items from the key/value store. | Overrides DatabaseStorage::deleteMultiple | |
DatabaseStorageExpirable::doSetWithExpire | protected | function | Saves a value for a given key with a time to live. | ||
DatabaseStorageExpirable::doSetWithExpireIfNotExists | protected | function | Sets a value for a given key with a time to live if it does not yet exist. | ||
DatabaseStorageExpirable::getAll | public | function | Returns all stored key/value pairs in the collection. | Overrides DatabaseStorage::getAll | |
DatabaseStorageExpirable::getMultiple | public | function | Returns the stored key/value pairs for a given set of keys. | Overrides DatabaseStorage::getMultiple | |
DatabaseStorageExpirable::has | public | function | Returns whether a given key exists in the store. | Overrides DatabaseStorage::has | |
DatabaseStorageExpirable::schemaDefinition | public static | function | Defines the schema for the key_value_expire table. | Overrides DatabaseStorage::schemaDefinition | |
DatabaseStorageExpirable::setMultipleWithExpire | public | function | Saves an array of values with a time to live. | Overrides KeyValueStoreExpirableInterface::setMultipleWithExpire | |
DatabaseStorageExpirable::setWithExpire | public | function | Saves a value for a given key with a time to live. | Overrides KeyValueStoreExpirableInterface::setWithExpire | |
DatabaseStorageExpirable::setWithExpireIfNotExists | public | function | Sets a value for a given key with a time to live if it does not yet exist. | Overrides KeyValueStoreExpirableInterface::setWithExpireIfNotExists | |
DatabaseStorageExpirable::__construct | public | function | Overrides Drupal\Core\KeyValueStore\StorageBase::__construct(). | Overrides DatabaseStorage::__construct | |
DependencySerializationTrait::$_entityStorages | protected | property | |||
DependencySerializationTrait::$_serviceIds | protected | property | |||
DependencySerializationTrait::__sleep | public | function | 1 | ||
DependencySerializationTrait::__wakeup | public | function | 2 | ||
StorageBase::$collection | protected | property | The name of the collection holding key and value pairs. | ||
StorageBase::delete | public | function | Deletes an item from the key/value store. | Overrides KeyValueStoreInterface::delete | 1 |
StorageBase::get | public | function | Returns the stored value for a given key. | Overrides KeyValueStoreInterface::get | 1 |
StorageBase::getCollectionName | public | function | Returns the name of this collection. | Overrides KeyValueStoreInterface::getCollectionName | |
StorageBase::setMultiple | public | function | Saves key/value pairs. | Overrides KeyValueStoreInterface::setMultiple | 1 |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.