class AliasWhitelist extends CacheCollector implements AliasWhitelistInterface (View source)

Extends CacheCollector to build the path alias whitelist over time.

Properties

protected string $cid

The cache id that is used for the cache entry.

from  CacheCollector
protected array $tags

A list of tags that are used for the cache entry.

from  CacheCollector
protected CacheBackendInterface $cache

The cache backend that should be used.

from  CacheCollector
protected LockBackendInterface $lock

The lock backend that should be used.

from  CacheCollector
protected array $keysToPersist

An array of keys to add to the cache on service termination.

from  CacheCollector
protected array $keysToRemove

An array of keys to remove from the cache on service termination.

from  CacheCollector
protected array $storage

Storage for the data itself.

from  CacheCollector
protected int $cacheCreated

Stores the cache creation time.

from  CacheCollector
protected bool $cacheInvalidated

Flag that indicates of the cache has been invalidated.

from  CacheCollector
protected bool $cacheLoaded

Indicates if the collected cache was already loaded.

from  CacheCollector
protected StateInterface $state

The Key/Value Store to use for state.

protected AliasRepositoryInterface $pathAliasRepository

The path alias repository.

Methods

__construct(string $cid, CacheBackendInterface $cache, LockBackendInterface $lock, StateInterface $state, AliasRepositoryInterface $alias_repository)

Constructs an AliasWhitelist object.

string
getCid()

Gets the cache ID.

has(string $key)

Returns whether data exists for this key.

mixed
get($offset)

Gets value from the cache.

set(string $key, mixed $value)

Implements \Drupal\Core\Cache\CacheCollectorInterface::set().

delete(string $key)

Deletes the element.

persist(string $key, bool $persist = TRUE)

Flags an offset value to be written to the persistent cache.

mixed
resolveCacheMiss($root)

Resolves a cache miss.

updateCache(bool $lock = TRUE)

Writes a value to the persistent cache immediately.

string
normalizeLockName(string $cid)

Normalizes a cache ID in order to comply with database limitations.

reset()

Resets the local cache.

clear()

Clears the collected cache entry.

destruct()

Performs destruct operations.

lazyLoadCache()

Loads the cache if not already done.

invalidateCache()

Invalidate the cache.

loadMenuPathRoots()

Loads menu path roots to prepopulate cache.

Details

__construct(string $cid, CacheBackendInterface $cache, LockBackendInterface $lock, StateInterface $state, AliasRepositoryInterface $alias_repository)

Constructs an AliasWhitelist object.

Parameters

string $cid

The cid for the array being cached.

CacheBackendInterface $cache

The cache backend.

LockBackendInterface $lock

The lock backend.

StateInterface $state

The state keyvalue store.

AliasRepositoryInterface $alias_repository

The path alias repository.

protected string getCid()

Gets the cache ID.

Return Value

string

has(string $key)

Returns whether data exists for this key.

Parameters

string $key

Key that identifies the data.

mixed get($offset)

Gets value from the cache.

Parameters

$offset

Return Value

mixed

The corresponding cache data.

set(string $key, mixed $value)

Implements \Drupal\Core\Cache\CacheCollectorInterface::set().

This is not persisted by default. In practice this means that setting a value will only apply while the object is in scope and will not be written back to the persistent cache. This follows a similar pattern to static vs. persistent caching in procedural code. Extending classes may wish to alter this behavior, for example by adding a call to persist().

Parameters

string $key

Key that identifies the data.

mixed $value

The data to be set.

delete(string $key)

Deletes the element.

It depends on the specific case and implementation whether this has a permanent effect or if it just affects the current request.

Parameters

string $key

Key that identifies the data.

protected persist(string $key, bool $persist = TRUE)

Flags an offset value to be written to the persistent cache.

Parameters

string $key

The key that was requested.

bool $persist

(optional) Whether the offset should be persisted or not, defaults to TRUE. When called with $persist = FALSE the offset will be unflagged so that it will not be written at the end of the request.

mixed resolveCacheMiss($root)

Resolves a cache miss.

When an offset is not found in the object, this is treated as a cache miss. This method allows classes using this implementation to look up the actual value and allow it to be cached.

Parameters

$root

Return Value

mixed

The value of the offset, or NULL if no value was found.

protected updateCache(bool $lock = TRUE)

Writes a value to the persistent cache immediately.

Parameters

bool $lock

(optional) Whether to acquire a lock before writing to cache. Defaults to TRUE.

protected string normalizeLockName(string $cid)

Normalizes a cache ID in order to comply with database limitations.

Parameters

string $cid

The passed in cache ID.

Return Value

string

An ASCII-encoded cache ID that is at most 255 characters long.

reset()

Resets the local cache.

Does not clear the persistent cache.

clear()

Clears the collected cache entry.

destruct()

Performs destruct operations.

protected lazyLoadCache()

Loads the cache if not already done.

protected invalidateCache()

Invalidate the cache.

protected loadMenuPathRoots()

Loads menu path roots to prepopulate cache.