Aplus Framework Docs
FilesCache
extends Cache
in package
Class FilesCache.
Table of Contents
Properties
- $autoClose : bool
- $baseDirectory : string|null
- $configs : array<string, mixed>
- Files Cache handler configurations.
- $debugCollector : CacheCollector
- $defaultTtl : int
- The default Time To Live value.
- $logger : Logger|null
- The Logger instance if is set.
- $prefix : string|null
- Keys prefix.
- $serializer : Serializer
- Data serializer.
Methods
- __construct() : mixed
- FilesCache constructor.
- __destruct() : mixed
- close() : bool
- Close the cache storage.
- 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.
- gc() : bool
- Garbage collector.
- get() : mixed
- Gets one item from the cache storage.
- getDefaultTtl() : int
- Get the default Time To Live value in seconds.
- getMulti() : array<string, mixed>
- Gets multi items from the cache storage.
- getSerializer() : Serializer
- increment() : int
- Increments the value of one item.
- isAutoClose() : bool
- set() : bool
- Sets one item to the cache storage.
- setAutoClose() : static
- setDebugCollector() : static
- setDefaultTtl() : static
- Set the default Time To Live value in seconds.
- setMulti() : array<string, bool>
- Sets multi items to the cache storage.
- setValue() : bool
- addDebugDelete() : bool
- addDebugFlush() : bool
- addDebugGet() : mixed
- addDebugSet() : bool
- closeDir() : void
- createSubDirectory() : void
- deleteAll() : bool
- deleteExpired() : bool
- deleteFile() : bool
- getContents() : mixed
- initialize() : void
- Initialize Cache handlers and configurations.
- log() : void
- makeTtl() : int
- Make the Time To Live value.
- openDir() : false|resource
- renderFilepath() : string
- renderKey() : string
- serialize() : string
- setBaseDirectory() : void
- setConfigs() : static
- setGC() : void
- setSerializer() : static
- unserialize() : mixed
Properties
$autoClose
protected
bool
$autoClose
= true
$baseDirectory
protected
string|null
$baseDirectory
$configs
Files Cache handler configurations.
protected
array<string, mixed>
$configs
= ['directory' => null, 'files_permission' => 0644, 'gc' => 1]
$debugCollector
protected
CacheCollector
$debugCollector
$defaultTtl
The default Time To Live value.
protected
int
$defaultTtl
= 60
Used when set methods has the $ttl param as null.
$logger
The Logger instance if is set.
protected
Logger|null
$logger
$prefix
Keys prefix.
protected
string|null
$prefix
= null
$serializer
Data serializer.
protected
Serializer
$serializer
Methods
__construct()
FilesCache constructor.
public
__construct([array<string, mixed>|null $configs = [] ][, string|null $prefix = null ][, Serializer|string $serializer = Serializer::PHP ][, Logger|null $logger = null ]) : mixed
Parameters
- $configs : array<string, mixed>|null = []
-
Driver specific configurations
- $prefix : string|null = null
-
Keys prefix
- $serializer : Serializer|string = Serializer::PHP
-
Data serializer
- $logger : Logger|null = null
-
Logger instance
__destruct()
public
__destruct() : mixed
close()
Close the cache storage.
public
close() : bool
Tags
Return values
bool —TRUE on success, otherwise FALSE
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
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
flush() : bool
Return values
bool —TRUE if all items are deleted, otherwise FALSE
gc()
Garbage collector.
public
gc() : bool
Deletes all expired items.
Return values
bool —TRUE if all expired items was deleted, FALSE if a fail occurs
get()
Gets one item from the cache storage.
public
get(string $key) : mixed
Parameters
- $key : string
-
The item name
Return values
mixed —The item value or null if not found
getDefaultTtl()
Get the default Time To Live value in seconds.
public
getDefaultTtl() : int
Attributes
- #[Pure]
Return values
intgetMulti()
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
getSerializer()
public
getSerializer() : Serializer
Return values
Serializerincrement()
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
isAutoClose()
public
isAutoClose() : bool
Tags
Return values
boolset()
Sets one item to the cache storage.
public
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
setAutoClose()
public
setAutoClose(bool $autoClose) : static
Parameters
- $autoClose : bool
-
True to enable auto close, false to disable
Tags
Return values
staticsetDebugCollector()
public
setDebugCollector(CacheCollector $debugCollector) : static
Parameters
- $debugCollector : CacheCollector
Return values
staticsetDefaultTtl()
Set the default Time To Live value in seconds.
public
setDefaultTtl(int $seconds) : static
Parameters
- $seconds : int
-
An integer greater than zero
Return values
staticsetMulti()
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
setValue()
public
setValue(string $key, mixed $value[, int|null $ttl = null ]) : bool
Parameters
- $key : string
- $value : mixed
- $ttl : int|null = null
Return values
booladdDebugDelete()
protected
addDebugDelete(string $key, float $start, bool $status) : bool
Parameters
- $key : string
- $start : float
- $status : bool
Return values
booladdDebugFlush()
protected
addDebugFlush(float $start, bool $status) : bool
Parameters
- $start : float
- $status : bool
Return values
booladdDebugGet()
protected
addDebugGet(string $key, float $start, mixed $value) : mixed
Parameters
- $key : string
- $start : float
- $value : 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
boolcloseDir()
protected
closeDir(resource $resource) : void
Parameters
- $resource : resource
createSubDirectory()
protected
createSubDirectory(string $filepath) : void
Parameters
- $filepath : string
deleteAll()
protected
deleteAll(string $baseDirectory) : bool
Parameters
- $baseDirectory : string
Return values
booldeleteExpired()
protected
deleteExpired(string $baseDirectory) : bool
Parameters
- $baseDirectory : string
Return values
booldeleteFile()
protected
deleteFile(string $filepath) : bool
Parameters
- $filepath : string
Return values
boolgetContents()
protected
getContents(string $filepath) : mixed
Parameters
- $filepath : string
initialize()
Initialize Cache handlers and configurations.
protected
initialize() : void
log()
protected
log(string $message[, LogLevel $level = LogLevel::ERROR ]) : void
Parameters
- $message : string
- $level : LogLevel = LogLevel::ERROR
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
Attributes
- #[Pure]
Return values
int —The input $seconds or the $defaultTtl as integer
openDir()
protected
openDir(string $dirpath) : false|resource
Parameters
- $dirpath : string
Return values
false|resourcerenderFilepath()
protected
renderFilepath(string $key) : string
Parameters
- $key : string
Attributes
- #[Pure]
Return values
stringrenderKey()
protected
renderKey(string $key) : string
Parameters
- $key : string
Attributes
- #[Pure]
Return values
stringserialize()
protected
serialize(mixed $value) : string
Parameters
- $value : mixed
Tags
Return values
stringsetBaseDirectory()
protected
setBaseDirectory() : void
setConfigs()
protected
setConfigs(array<string, mixed> $configs) : static
Parameters
- $configs : array<string, mixed>
Tags
Return values
staticsetGC()
protected
setGC(int $gc) : void
Parameters
- $gc : int
setSerializer()
protected
setSerializer(Serializer|string $serializer) : static
Parameters
- $serializer : Serializer|string
Tags
Return values
staticunserialize()
protected
unserialize(string $value) : mixed
Parameters
- $value : string