Documentation

ArrayAdapter
in package
implements AdapterInterface, CacheInterface, LoggerAwareInterface, ResettableInterface Uses LoggerAwareTrait

An in-memory cache storage.

Acts as a least-recently-used (LRU) storage when configured with a maximum number of items.

Tags
author

Nicolas Grekas p@tchwork.com

Interfaces, Classes and Traits

AdapterInterface
Interface for adapters managing instances of Symfony's CacheItem.
CacheInterface
Covers most simple to advanced caching needs.
LoggerAwareInterface
Describes a logger-aware instance.
ResettableInterface
Resets a pool's local state.

Table of Contents

$logger  : LoggerInterface|null
The logger instance.
$createCacheItem  : mixed
$defaultLifetime  : mixed
$expiries  : mixed
$maxItems  : mixed
$maxLifetime  : mixed
$storeSerialized  : mixed
$values  : mixed
__construct()  : mixed
clear()  : bool
Deletes all items in the pool.
commit()  : bool
{@inheritdoc}
delete()  : bool
Removes an item from the pool.
deleteItem()  : bool
{@inheritdoc}
deleteItems()  : bool
{@inheritdoc}
get()  : mixed
Fetches a value from the pool or computes it if not found.
getItem()  : CacheItem
Returns a Cache Item representing the specified key.
getItems()  : Traversable<string, CacheItem>
Returns a traversable set of cache items.
getValues()  : array<string|int, mixed>
Returns all cached values, with cache miss as null.
hasItem()  : bool
{@inheritdoc}
reset()  : mixed
{@inheritdoc}
save()  : bool
{@inheritdoc}
saveDeferred()  : bool
{@inheritdoc}
setLogger()  : mixed
Sets a logger.
freeze()  : mixed
generateItems()  : Generator
unfreeze()  : mixed
validateKeys()  : bool

Properties

Methods

__construct()

public __construct(int $defaultLifetime[, bool $storeSerialized = true ], float $maxLifetime, int $maxItems) : mixed
Parameters
$defaultLifetime : int
$storeSerialized : bool = true

Disabling serialization can lead to cache corruptions when storing mutable values but increases performance otherwise

$maxLifetime : float
$maxItems : int
Return values
mixed

clear()

Deletes all items in the pool.

public clear([string $prefix = '' ]) : bool
Parameters
$prefix : string = ''
Return values
bool

commit()

{@inheritdoc}

public commit() : bool
Return values
bool

delete()

Removes an item from the pool.

public delete(string $key) : bool
Parameters
$key : string

The key to delete

Return values
bool

True if the item was successfully removed, false if there was any error

deleteItem()

{@inheritdoc}

public deleteItem(mixed $key) : bool
Parameters
$key : mixed
Return values
bool

deleteItems()

{@inheritdoc}

public deleteItems(array<string|int, mixed> $keys) : bool
Parameters
$keys : array<string|int, mixed>
Return values
bool

get()

Fetches a value from the pool or computes it if not found.

public get(string $key, callable $callback[, float|null $beta = null ][, array<string|int, mixed>|null &$metadata = null ]) : mixed
Parameters
$key : string

The key of the item to retrieve from the cache

$callback : callable

Should return the computed value for the given key/item

$beta : float|null = null

A float that, as it grows, controls the likeliness of triggering early expiration. 0 disables it, INF forces immediate expiration. The default (or providing null) is implementation dependent but should typically be 1.0, which should provide optimal stampede protection. See https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration

$metadata : array<string|int, mixed>|null = null

The metadata of the cached item ItemInterface::getMetadata()

Return values
mixed

getItem()

Returns a Cache Item representing the specified key.

public getItem(mixed $key) : CacheItem
Parameters
$key : mixed
Return values
CacheItem

getItems()

Returns a traversable set of cache items.

public getItems([array<string|int, mixed> $keys = [] ]) : Traversable<string, CacheItem>
Parameters
$keys : array<string|int, mixed> = []
Return values
Traversable<string, CacheItem>

getValues()

Returns all cached values, with cache miss as null.

public getValues() : array<string|int, mixed>
Return values
array<string|int, mixed>

hasItem()

{@inheritdoc}

public hasItem(mixed $key) : bool
Parameters
$key : mixed
Return values
bool

reset()

{@inheritdoc}

public reset() : mixed
Return values
mixed

freeze()

private freeze(mixed $value, string $key) : mixed
Parameters
$value : mixed
$key : string
Return values
mixed

generateItems()

private generateItems(array<string|int, mixed> $keys, float $now, Closure $f) : Generator
Parameters
$keys : array<string|int, mixed>
$now : float
$f : Closure
Return values
Generator

unfreeze()

private unfreeze(string $key, bool &$isHit) : mixed
Parameters
$key : string
$isHit : bool
Return values
mixed

validateKeys()

private validateKeys(array<string|int, mixed> $keys) : bool
Parameters
$keys : array<string|int, mixed>
Return values
bool

Search results