apcu_fetch

(PECL apcu >= 4.0.0)

apcu_fetch — Fetch a stored variable from the cache

apcu_fetch(mixed $key, bool &$success = ?): mixed

Fetches an entry from the cache.

key: The key used to store the value (with apcu_store()). If an array is passed then each element is fetched and returned.
success: Set to true in success and false in failure.

The stored variable or array of variables on success; false on failure

Version	Description
PECL apcu 3.0.17	The `success` parameter was added.

Example #1 A apcu_fetch() example

<?php
$bar = 'BAR';
apcu_store('foo', $bar);
var_dump(apcu_fetch('foo'));
?>

The above example will output:

string(3) "BAR"

down

1 year ago

Note that $success is set to false if no cached entry with given key exists.
So "failure" tells you if the cache was hit or not.