phpday 2025 - Call For Papers

apcu_cache_info

(PECL apcu >= 4.0.0)

apcu_cache_info Retrieves cached information from APCu's data store

Description

apcu_cache_info(bool $limited = false): array|false

Retrieves cached information and meta-data from APC's data store.

Parameters

limited

If limited is true, the return value will exclude the individual list of cache entries. This is useful when trying to optimize calls for statistics gathering.

Return Values

Array of cached data (and meta-data) or false on failure

Note: apcu_cache_info() will raise a warning if it is unable to retrieve APC cache data. This typically occurs when APC is not enabled.

Changelog

Version Description
PECL apcu 3.0.11 The limited parameter was introduced.
PECL apcu 3.0.16 The "filehits" option for the cache_type parameter was introduced.

Examples

Example #1 A apcu_cache_info() example

<?php
print_r
(apcu_cache_info());
?>

The above example will output something similar to:

Array
(
    [num_slots] => 2000
    [ttl] => 0
    [num_hits] => 9
    [num_misses] => 3
    [start_time] => 1123958803
    [cache_list] => Array
        (
            [0] => Array
                (
                    [filename] => /path/to/apcu_test.php
                    [device] => 29954
                    [inode] => 1130511
                    [type] => file
                    [num_hits] => 1
                    [mtime] => 1123960686
                    [creation_time] => 1123960696
                    [deletion_time] => 0
                    [access_time] => 1123962864
                    [ref_count] => 1
                    [mem_size] => 677
                )
            [1] => Array (...iterates for each cached file)
)

See Also

add a note

User Contributed Notes 1 note

up
0
RQuadling at GMail dot com
2 years ago
If you get the following warning when using APCu functions via PHP's CLI SAPI:

PHP Warning: apcu_cache_info(): No APC info available. Perhaps APC is not enabled? Check apc.enabled in your ini file

then check the status of `apc.enable_cli`. This is a separate INI entry for enabling APC via the CLI SAPI.
To Top