phpBB API Documentation
Class

phpbb\cache\driver\null

class null extends base

ACM Null Caching

Properties

$vars
$is_modified
$sql_rowset
$sql_row_pointer
$cache_dir

Methods

null purge()

Purge cache data
null unload()

Unload cache object
int|bool sql_load(string $query)

Load result of an SQL query from cache.
bool sql_exists(int $query_id)

Check if result for a given SQL query exists in cache.
array|bool sql_fetchrow(int $query_id)

Fetch row from cache (database)
string|bool sql_fetchfield(int $query_id, string $field)

Fetch a field from the current row of a cached database result (database)
bool sql_rowseek(int $rownum, int $query_id)

Seek a specific row in an a cached database result (database)
bool sql_freeresult(int $query_id)

Free memory used for a cached database result (database)
bool remove_file(string $filename, bool $check = false)

Removes/unlinks file

 from base
__construct()

Set cache path
mixed load()

Load global cache
null save()

Save modified objects
null tidy()

Tidy cache
mixed get(string $var_name)

Get saved cache object
null put(string $var_name, mixed $var, int $ttl)

Put data into cache
null destroy(string $var_name, string $table = '')

Destroy cache data
bool _exists(string $var_name)

Check if a given cache entry exists
int|mixed sql_save(driver_interface $db, string $query, mixed $query_result, int $ttl)

Save result of an SQL query in cache.

Details

at line 77
public null purge()

Purge cache data

Return Value

null

at line 39
public null unload()

Unload cache object

Return Value

null

at line 99
public int|bool sql_load(string $query)

Load result of an SQL query from cache.

Parameters

string $query SQL query

Return Value

int|bool Query ID (integer) if cache contains a rowset for the specified query. False otherwise.

at line 115
public bool sql_exists(int $query_id)

Check if result for a given SQL query exists in cache.

Parameters

int $query_id

Return Value

bool

at line 123
public array|bool sql_fetchrow(int $query_id)

Fetch row from cache (database)

Parameters

int $query_id

Return Value

array|bool The query result if found in the cache, otherwise false.

at line 131
public string|bool sql_fetchfield(int $query_id, string $field)

Fetch a field from the current row of a cached database result (database)

Parameters

int $query_id
string $field The name of the column.

Return Value

string|bool The field of the query result if found in the cache, otherwise false.

at line 139
public bool sql_rowseek(int $rownum, int $query_id)

Seek a specific row in an a cached database result (database)

Parameters

int $rownum Row to seek to.
int $query_id

Return Value

bool

at line 147
public bool sql_freeresult(int $query_id)

Free memory used for a cached database result (database)

Parameters

int $query_id

Return Value

bool

in base at line 182
public bool remove_file(string $filename, bool $check = false)

Removes/unlinks file

Parameters

string $filename Filename to remove
bool $check Check file permissions

Return Value

bool True if the file was successfully removed, otherwise false

at line 24
public __construct()

Set cache path

at line 31
public mixed load()

Load global cache

Return Value

mixed False if an error was encountered, otherwise the data type of the cached data

at line 46
public null save()

Save modified objects

Return Value

null

at line 53
public null tidy()

Tidy cache

Return Value

null

at line 62
public mixed get(string $var_name)

Get saved cache object

Parameters

string $var_name Cache key

Return Value

mixed False if an error was encountered, otherwise the saved cached object

at line 70
public null put(string $var_name, mixed $var, int $ttl)

Put data into cache

Parameters

string $var_name Cache key
mixed $var Cached data to store
int $ttl Time-to-live of cached data

Return Value

null

at line 84
public null destroy(string $var_name, string $table = '')

Destroy cache data

Parameters

string $var_name Cache key
string $table Table name

Return Value

null

at line 91
public bool _exists(string $var_name)

Check if a given cache entry exists

Parameters

string $var_name Cache key

Return Value

bool True if cache file exists and has not expired. False otherwise.

at line 107
public int|mixed sql_save(driver_interface $db, string $query, mixed $query_result, int $ttl)

Save result of an SQL query in cache.

In persistent cache stores, this function stores the query result to persistent storage. In other words, there is no need to call save() afterwards.

Parameters

driver_interface $db Database connection
string $query SQL query, should be used for generating storage key
mixed $query_result The result from \dbal::sqlquery, to be passed to \dbal::sqlfetchrow to get all rows and store them in cache.
int $ttl Time to live, after this timeout the query should expire from the cache.

Return Value

int|mixed If storing in cache succeeded, an integer $queryid representing the query should be returned. Otherwise the original $queryresult should be returned.