wincache_ucache_get
(PECL wincache >= 1.1.0)
wincache_ucache_get — Gets a variable stored in the user cache
Description
Gets a variable stored in the user cache.
Parameters
-
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 thekeyarray. 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
TRUEon success andFALSEon failure.
Return Values
If key is a string, the function returns the value of the variable stored with that key.
The success is set to TRUE on success and
to FALSE on failure.
The key is an array, the parameter success
is 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.
Examples
Example #1 wincache_ucache_get() with key as a string
<?php
wincache_ucache_add('color', 'blue');
var_dump(wincache_ucache_get('color', $success));
var_dump($success);
?>
The above example will output:
string(4) "blue" bool(true)
Example #2 wincache_ucache_get() with key as 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);
?>
The above example will output:
array(4) { ["green"]=> string(1) "5"
["Blue"]=> string(1) "6"
["yellow"]=> string(1) "7"
["cyan"]=> string(1) "8" }
bool(true)
See Also
- 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()
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Изменение поведения PHP
- Windows Cache for PHP
- wincache_fcache_fileinfo
- wincache_fcache_meminfo
- wincache_lock
- wincache_ocache_fileinfo
- wincache_ocache_meminfo
- wincache_refresh_if_changed
- wincache_rplist_fileinfo
- wincache_rplist_meminfo
- wincache_scache_info
- wincache_scache_meminfo
- wincache_ucache_add
- wincache_ucache_cas
- wincache_ucache_clear
- wincache_ucache_dec
- wincache_ucache_delete
- wincache_ucache_exists
- wincache_ucache_get
- wincache_ucache_inc
- wincache_ucache_info
- wincache_ucache_meminfo
- wincache_ucache_set
- wincache_unlock
Коментарии
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).