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 andFALSE
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 cachewincache_ucache_set()
Adds a variable in user cache and overwrites a variable if it already exists in the cachewincache_ucache_delete()
Deletes variables from the user cachewincache_ucache_clear()
Deletes entire content of the user cachewincache_ucache_exists()
Checks if a variable exists in the user cachewincache_ucache_meminfo()
Retrieves information about user cache memory usagewincache_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).