apc_cache_info
(PECL apc >= 2.0.0)
apc_cache_info — Retrieves cached information from APC's data store
Description
$cache_type = ""
[, bool $limited = FALSE
]] ) : arrayRetrieves cached information and meta-data from APC's data store.
Parameters
-
cache_type -
If
cache_typeis "user", information about the user cache will be returned.If
cache_typeis "filehits", information about which files have been served from the bytecode cache for the current request will be returned. This feature must be enabled at compile time using --enable-filehits.If an invalid or no
cache_typeis specified, information about the system cache (cached files) will be returned. -
limited -
If
limitedisTRUE, 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: apc_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 |
|---|---|
| 3.0.11 |
The limited parameter was introduced.
|
| 3.0.16 |
The "filehits" option for the
cache_type parameter was introduced.
|
Examples
Example #1 A apc_cache_info() example
<?php
print_r(apc_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/apc_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
- APC configuration directives
- APCIterator::getTotalSize() - Get total cache size
- APCIterator::getTotalHits() - Get total cache hits
- APCIterator::getTotalCount() - Get total count
add a note
