# APCu

APCu is a shared memory key-value store for PHP. The memory is shared between PHP-FPM processes of the same pool. Stored data persists between requests.

# Iterating over Entries

The APCUIterator (opens new window) allows to iterate over entries in the cache:

foreach (new APCUIterator() as $entry) {
    print_r($entry);
}

The iterator can be initialized with an optional regular expression to select only entries with matching keys:

foreach (new APCUIterator($regex) as $entry) {
    print_r($entry);
}

Information about a single cache entry can be obtained via:

$key = '…';
$regex = '(^' . preg_quote($key) . '$)';
print_r((new APCUIterator($regex))->current());

# Simple storage and retrieval

apcu_store (opens new window) can be used to store, apcu_fetch (opens new window) to retrieve values:

$key = 'Hello';
$value = 'World';
apcu_store($key, $value);
print(apcu_fetch('Hello')); // 'World'

# Store information

apcu_cache_info (opens new window) provides information about the store and its entries:

print_r(apcu_cache_info());

Note that invoking `apcu_cache_info()` without limit will return the complete data currently stored.
To only get the meta data, use `apcu_cache_info(true)`.
To get information about certain cache entries better use `APCUIterator`.