Aplus Framework Docs
Cache
in package
Class Cache.
Table of Contents
- $defaultTtl : int
- The default Time To Live value.
- $configs : array<string|int, mixed>
- Driver specific configurations.
- $debugCollector : CacheCollector
- $logger : Logger|null
- The Logger instance if is set.
- $prefix : string|null
- Keys prefix.
- $serializer : Serializer
- Data serializer.
- __construct() : mixed
- Cache constructor.
- decrement() : int
- Decrements the value of one item.
- delete() : bool
- Deletes one item from the cache storage.
- deleteMulti() : array<string, bool>
- Deletes multi items from the cache storage.
- flush() : bool
- Flush the cache storage.
- get() : mixed
- Gets one item from the cache storage.
- getMulti() : array<string, mixed>
- Gets multi items from the cache storage.
- increment() : int
- Increments the value of one item.
- set() : bool
- Sets one item to the cache storage.
- setDebugCollector() : static
- setMulti() : array<string, bool>
- Sets multi items to the cache storage.
- addDebugDelete() : bool
- addDebugFlush() : bool
- addDebugGet() : mixed
- addDebugSet() : bool
- initialize() : void
- Initialize Cache handlers and configurations.
- log() : void
- makeTtl() : int
- Make the Time To Live value.
- renderKey() : string
- serialize() : string
- unserialize() : mixed
Properties
$defaultTtl
The default Time To Live value.
public
int
$defaultTtl
= 60
Used when set methods has the $ttl param as null.
$configs
Driver specific configurations.
protected
array<string|int, mixed>
$configs
= []
$debugCollector
protected
CacheCollector
$debugCollector
$logger
The Logger instance if is set.
protected
Logger|null
$logger
$prefix
Keys prefix.
protected
string|null
$prefix
$serializer
Data serializer.
protected
Serializer
$serializer
Methods
__construct()
Cache constructor.
public
__construct([array<string, mixed>|null $configs = [] ][, string|null $prefix = null ][, Serializer $serializer = Serializer::PHP ][, Logger $logger = null ]) : mixed
Parameters
- $configs : array<string, mixed>|null = []
-
Driver specific configurations. Set null to not initialize and set a custom object.
- $prefix : string|null = null
-
Keys prefix
- $serializer : Serializer = Serializer::PHP
-
Data serializer
- $logger : Logger = null
Return values
mixed —decrement()
Decrements the value of one item.
public
decrement(string $key[, int $offset = 1 ][, int|null $ttl = null ]) : int
Parameters
- $key : string
-
The item name
- $offset : int = 1
-
The value to decrement
- $ttl : int|null = null
-
The Time To Live for the item or null to use the default
Return values
int —The current item value
delete()
Deletes one item from the cache storage.
public
abstract delete(string $key) : bool
Parameters
- $key : string
-
the item name
Return values
bool —TRUE if the item was deleted, FALSE if fail to delete
deleteMulti()
Deletes multi items from the cache storage.
public
deleteMulti(array<int, string> $keys) : array<string, bool>
Parameters
- $keys : array<int, string>
-
List of items names to be deleted
Return values
array<string, bool> —associative array with key names and respective delete status
flush()
Flush the cache storage.
public
abstract flush() : bool
Return values
bool —TRUE if all items are deleted, otherwise FALSE
get()
Gets one item from the cache storage.
public
abstract get(string $key) : mixed
Parameters
- $key : string
-
The item name
Return values
mixed —The item value or null if not found
getMulti()
Gets multi items from the cache storage.
public
getMulti(array<int, string> $keys) : array<string, mixed>
Parameters
- $keys : array<int, string>
-
List of items names to get
Return values
array<string, mixed> —associative array with key names and respective values
increment()
Increments the value of one item.
public
increment(string $key[, int $offset = 1 ][, int|null $ttl = null ]) : int
Parameters
- $key : string
-
The item name
- $offset : int = 1
-
The value to increment
- $ttl : int|null = null
-
The Time To Live for the item or null to use the default
Return values
int —The current item value
set()
Sets one item to the cache storage.
public
abstract set(string $key, mixed $value[, int|null $ttl = null ]) : bool
Parameters
- $key : string
-
The item name
- $value : mixed
-
The item value
- $ttl : int|null = null
-
The Time To Live for the item or null to use the default
Return values
bool —TRUE if the item was set, FALSE if fail to set
setDebugCollector()
public
setDebugCollector(CacheCollector $debugCollector) : static
Parameters
- $debugCollector : CacheCollector
Return values
static —setMulti()
Sets multi items to the cache storage.
public
setMulti(array<string, mixed> $data[, int|null $ttl = null ]) : array<string, bool>
Parameters
- $data : array<string, mixed>
-
Associative array with key names and respective values
- $ttl : int|null = null
-
The Time To Live for all the items or null to use the default
Return values
array<string, bool> —associative array with key names and respective set status
addDebugDelete()
protected
addDebugDelete(string $key, float $start, bool $status) : bool
Parameters
- $key : string
- $start : float
- $status : bool
Return values
bool —addDebugFlush()
protected
addDebugFlush(float $start, bool $status) : bool
Parameters
- $start : float
- $status : bool
Return values
bool —addDebugGet()
protected
addDebugGet(string $key, float $start, mixed $value) : mixed
Parameters
- $key : string
- $start : float
- $value : mixed
Return values
mixed —addDebugSet()
protected
addDebugSet(string $key, int|null $ttl, float $start, mixed $value, bool $status) : bool
Parameters
- $key : string
- $ttl : int|null
- $start : float
- $value : mixed
- $status : bool
Return values
bool —initialize()
Initialize Cache handlers and configurations.
protected
initialize() : void
Return values
void —log()
protected
log(string $message[, LogLevel $level = LogLevel::ERROR ]) : void
Parameters
- $message : string
- $level : LogLevel = LogLevel::ERROR
Return values
void —makeTtl()
Make the Time To Live value.
protected
makeTtl(int|null $seconds) : int
Parameters
- $seconds : int|null
-
TTL value or null to use the default
Return values
int —The input $seconds or the $defaultTtl as integer
renderKey()
protected
renderKey(string $key) : string
Parameters
- $key : string
Return values
string —serialize()
protected
serialize(mixed $value) : string
Parameters
- $value : mixed
Tags
Return values
string —unserialize()
protected
unserialize(string $value) : mixed
Parameters
- $value : string