Adapter

The cache frontend.

Properties

options

protected array $options

useCache

protected bool $useCache = true

backend

protected Backend $backend

excludeKeys

private array $excludeKeys

Methods

__construct

Cache object constructor.

public __construct(null $backend, array $config, string $namespace = 'default'): void

Parameters

Parameter	Type	Description
$backend	null	The name of the backend to use. Currently 'apc', 'file', 'memcached', 'session' and 'sqlite' are supported.
$config	array
$namespace	string	The namespace to use for grouping stored data

__destruct

Destructor method for the cache adapter.

public __destruct(): void

Closes the backend connection when the adapter is destroyed.

__isset

public __isset(string $key): bool

Parameters

Parameter	Type	Description
$key	string

__set

public __set(string $key, mixed $value): void

Parameters

Parameter	Type	Description
$key	string
$value	mixed

__unset

public __unset(string $key): void

Parameters

Parameter	Type	Description
$key	string

getBackend

public getBackend(): Backend

setBackendOption

public setBackendOption(string $key, mixed $value): void

Parameters

Parameter	Type	Description
$key	string
$value	mixed

lock

public lock(string $key): bool

Parameters

Parameter	Type	Description
$key	string

unlock

public unlock(string $key): bool

Parameters

Parameter	Type	Description
$key	string

exclude

Excludes the specified keys from some cache operations.

public exclude(mixed $keys): void

Accepts a variable number of arguments, which can be individual keys or arrays of keys. If an argument is an array, it recursively processes its elements. The final list of excluded keys is stored in the $excludeKeys property.

Parameters

Parameter	Type	Description
$keys	mixed

get

Retrieve a value from cache storage.

public get(string $key, mixed $default, bool $saveDefault, int $timeout): mixed

Parameters

Parameter	Type	Description
$key	string	The reference key used to store the value
$default	mixed	If the value doesn't exist, this default will be returned instead
$saveDefault	bool	If the value doesn't exist and a default is specified, save that default to cache
$timeout	int

set

Store a value in the cache using the current cache backend.

public set(string $key, mixed $value, int $timeout): bool

Parameters

Parameter	Type	Description
$key	string	The reference key under which to store the value
$value	mixed	The value that should be stored. Values can be pretty much anything including integers, booleans, strings and any object that can be serialised.
$timeout	int	The number of seconds after which the value becomes invalid. If not set the global 'ttl' option is used. Set a value of '-1' to indicate that the value should never timeout.

has

Check if a stored value exists.

public has(string $key, bool $checkEmpty): bool

Parameters

Parameter	Type	Description
$key	string	The value key to check for
$checkEmpty	bool	Normally this method will return try if the value exists with $key. Setting $checkEmpty looks at the value and will return false if it is an 'empty' value (ie: 0, null, [])

remove

Removes a stored value.

public remove(string $key): void

Parameters

Parameter	Type	Description
$key	string	The key of the value to remove

extend

Extend the cache with an array of key/value pairs.

public extend(array $array, bool $recursive): bool

Parameters

Parameter	Type	Description
$array	array	The array of key/value pairs to store in the cache
$recursive	bool

clear

public clear(): void

populate

Set multiple values in the cache.

public populate(array $values): bool

Parameters

Parameter	Type	Description
$values	array

pull

public pull(string $key): mixed

Parameters

Parameter	Type	Description
$key	string

toArray

Retrieve all values from the cache.

public toArray(): void

count

public count(): int

on

Disable the use of cache.

public on(): void

This allows a cache object to be disabled but still be used without having to modify existing application code. The application can still call the get() method but it will always return false, simulating a negative cache response. Calling set() will still have an affect however.

off

Enable the use of cache.

public off(): void

Cache is enabled by default. This is to allow cache to be re-enabled after calling off().

This method can also be used to force cache back on after being disabled by a "Pragma: no-cache" header in the case where the use_pragma setting is enabled (which is the default).

__get

public __get(string $key): mixed

Parameters

Parameter	Type	Description
$key	string

offsetExists

public offsetExists( $offset): bool

Parameters

Parameter	Type	Description
$offset	``````

offsetGet

public offsetGet( $offset): mixed

Parameters

Parameter	Type	Description
$offset	``````

offsetSet

public offsetSet( $offset,  $value): void

Parameters

Parameter	Type	Description
$offset	``````
$value	``````

offsetUnset

public offsetUnset( $offset): void

Parameters

Parameter	Type	Description
$offset	``````

increment

Increment key value.

public increment(string $key, int $amount = 1): int

This method will increment a cached integer value by a defined amount (default is 1). Once the value is incremented it will be stored back in the cache and the new value returned.

Parameters

Parameter	Type	Description
$key	string	The cache key
$amount	int	the amount to increment the value by

decrement

Decrement key value.

public decrement(string $key, int $amount = 1): int

This method will decrement a cached integer value by a defined amount (default is 1). Once the value is decremented it will be stored back in the cache and the new value returned.

Parameters

Parameter	Type	Description
$key	string	The cache key
$amount	int	the amount to decrement the value by

---

Generated by Hazaar API Doc Generator on Sun, 01 Mar 2026 09:22:26 +0000