PHP8 wincache_ucache_get — 获取存储在用户缓存中的变量
(PECL wincache >= 1.1.0)
wincache_ucache_get — 获取存储在用户缓存中的变量。
说明
wincache_ucache_get(mixed $key, bool &$success = ?): mixed
获取存储在用户缓存中的变量。
参数
key
用于在缓存中存储变量的key。key区分大小写。key可以是一个键数组。在这种情况下,返回值将是键数组中每个元素的值数组。如果返回对象或包含对象的数组,那么对象将被反序列化。有关反序列化对象的详细信息,请参阅
__wakeup()
。success
在成功时将设置为
true
,在失败时将设置为false
。
返回值
如果key
是一个字符串,该函数将返回与该键存储的变量的值。如果成功,success
将设置为true
;如果失败,将设置为false
。
如果key
是一个数组,参数success
始终设置为true
。返回的数组(名称 => 值对)将仅包含在用户缓存中get
操作成功的那些名称 => 值对。如果key
数组中的键都在用户缓存中找不到匹配,将返回一个空数组。
示例
示例 #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);
?>
以上示例会输出:
string(4) "blue"
bool(true)
示例 #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);
?>
以上示例会输出:
array(4) { ["green"]=> string(1) "5"
["Blue"]=> string(1) "6"
["yellow"]=> string(1) "7"
["cyan"]=> string(1) "8" }
bool(true)
参见
- wincache_ucache_add() - 仅在变量尚不存在于缓存中时将变量添加到用户缓存中。
- wincache_ucache_set() - 将变量添加到用户缓存中,如果变量已存在于缓存中,则覆盖该变量。
- wincache_ucache_delete() - 从用户缓存中删除变量。
- wincache_ucache_clear() - 删除用户缓存的全部内容。
- wincache_ucache_exists() - 检查变量是否存在于用户缓存中。
- wincache_ucache_meminfo() - 获取有关用户缓存内存使用情况的信息。
- wincache_ucache_info() - 获取有关存储在用户缓存中的数据的信息。
- __wakeup()