Scrapbook

CacheItemInterface

CacheItemInterface defines an interface for interacting with objects inside a cache.

Each Item object MUST be associated with a specific key, which can be set according to the implementing system and is typically passed by the Cache\CacheItemPoolInterface object.

The Cache\CacheItemInterface object encapsulates the storage and retrieval of cache items. Each Cache\CacheItemInterface is generated by a Cache\CacheItemPoolInterface object, which is responsible for any required setup as well as associating the object with a unique Key. Cache\CacheItemInterface objects MUST be able to store and retrieve any type of PHP value defined in the Data section of the specification.

Calling Libraries MUST NOT instantiate Item objects themselves. They may only be requested from a Pool object via the getItem() method. Calling Libraries SHOULD NOT assume that an Item created by one Implementing Library is compatible with a Pool from another Implementing Library.

Table of Contents

Methods

expiresAfter()  : static
Sets the expiration time for this cache item.
expiresAt()  : static
Sets the expiration time for this cache item.
get()  : mixed
Retrieves the value of the item from the cache associated with this object's key.
getKey()  : string
Returns the key for the current cache item.
isHit()  : bool
Confirms if the cache item lookup resulted in a cache hit.
set()  : static
Sets the value represented by this cache item.

Methods

expiresAfter()

Sets the expiration time for this cache item.

public expiresAfter(int|DateInterval|null $time) : static
Parameters
$time : int|DateInterval|null

The period of time from the present after which the item MUST be considered expired. An integer parameter is understood to be the time in seconds until expiration. If null is passed explicitly, a default value MAY be used. If none is set, the value should be stored permanently or for as long as the implementation allows.

Return values
static

The called object.

expiresAt()

Sets the expiration time for this cache item.

public expiresAt(DateTimeInterface|null $expiration) : static
Parameters
$expiration : DateTimeInterface|null

The point in time after which the item MUST be considered expired. If null is passed explicitly, a default value MAY be used. If none is set, the value should be stored permanently or for as long as the implementation allows.

Return values
static

The called object.

get()

Retrieves the value of the item from the cache associated with this object's key.

public get() : mixed

The value returned must be identical to the value originally stored by set().

If isHit() returns false, this method MUST return null. Note that null is a legitimate cached value, so the isHit() method SHOULD be used to differentiate between "null value was found" and "no value was found."

Return values
mixed

The value corresponding to this cache item's key, or null if not found.

getKey()

Returns the key for the current cache item.

public getKey() : string

The key is loaded by the Implementing Library, but should be available to the higher level callers when needed.

Return values
string

The key string for this cache item.

isHit()

Confirms if the cache item lookup resulted in a cache hit.

public isHit() : bool

Note: This method MUST NOT have a race condition between calling isHit() and calling get().

Return values
bool

True if the request resulted in a cache hit. False otherwise.

set()

Sets the value represented by this cache item.

public set(mixed $value) : static

The $value argument may be any item that can be serialized by PHP, although the method of serialization is left up to the Implementing Library.

Parameters
$value : mixed

The serializable value to be stored.

Return values
static

The invoked object.


        
On this page

Search results