wincache_ucache_get()

(PECL wincache >= 1.1.0)

Gets a variable stored in the user cache

说明

wincache_ucache_get(mixed $key[,bool &$success]): mixed

Gets a variable stored in the user cache.

参数

$key: The$keythat was used to store the variable in the cache.$keyis case sensitive.$keycan be an array of keys. In this case the return value will be an array of values of each element in the$keyarray. If an object, or an array containing objects, is returned, then the objects will be unserialized. See __wakeup() for details on unserializing objects.
$success: Will be set to TRUE on success and FALSE on failure.

返回值

If$keyis a string, the function returns the value of the variable stored with that key. The$successis set to TRUE on success and to FALSE on failure.

The$keyis an array, the parameter$successis always set to TRUE. The returned array(name => value pairs)will contain only those name => value pairs for which the get operation in user cache was successful. If none of the keys in the key array finds a match in the user cache an empty array will be returned.

范例

Example #1 wincache_ucache_get() with$keyas a string

<?php
wincache_ucache_add('color', 'blue');
var_dump(wincache_ucache_get('color', $success));
var_dump($success);
?>

以上例程会输出：

string(4) "blue"
bool(true)

Example #2 wincache_ucache_get() with$keyas an array

<?php
$array1 = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
wincache_ucache_set($array1);
$array2 = array('green', 'Blue', 'yellow', 'cyan');
var_dump(wincache_ucache_get($array2, $success));
var_dump($success);
?>

以上例程会输出：

array(4) { ["green"]=> string(1) "5" 
           ["Blue"]=> string(1) "6" 
           ["yellow"]=> string(1) "7" 
           ["cyan"]=> string(1) "8" } 
bool(true)

参见

wincache_ucache_add()Adds a variable in user cache only if variable does not already exist in the cache
wincache_ucache_set()Adds a variable in user cache and overwrites a variable if it already exists in the cache
wincache_ucache_delete()Deletes variables from the user cache
wincache_ucache_clear()Deletes entire content of the user cache
wincache_ucache_exists()Checks if a variable exists in the user cache
wincache_ucache_meminfo()Retrieves information about user cache memory usage
wincache_ucache_info()Retrieves information about data stored in the user cache
__wakeup()

As per documentation PHP 5.2 doesn't support serialization of PHP internal classes. This means code below will not work:
<?php
$d = new DateTime();
$d->format(DateTime::W3C);
wincache_ucache_set( 'q1', $d );
var_dump( wincache_ucache_get( 'q1' )->format(DATE_ATOM));
?>
The output of above code will be (as of PHP5.2.13):
[11-Feb-2010 08:35:29] PHP Warning: DateTime::format() [<a href='datetime.format'>datetime.format</a>]: The DateTime object has not been correctly initialized by its constructor in C:\inetpub\wwwroot\phptest\tests\ucache\wincache8.php on line 5
And last var_dump will return bool(false).