PHP8 wincache_ucache_add — 在用户缓存中只有在该变量尚未存在于缓存中时才添加变量
(PECL wincache >= 1.1.0)
wincache_ucache_add — 在用户缓存中只有在该变量尚未存在于缓存中时才添加变量。
说明
wincache_ucache_add(string $key, mixed $value, int $ttl = 0): boolwincache_ucache_add(array $values, mixed $unused = NULL, int $ttl = 0): bool将变量添加到用户缓存中，仅当此变量在缓存中尚不存在时。添加的变量将保留在用户缓存中，除非其生存时间到期，或者使用 `wincache_ucache_delete()` 或 `wincache_ucache_clear()` 函数将其删除。
参数
key使用此键名存储变量。如果已经存在具有相同键的变量，则该函数将失败并返回 false。键区分大小写。如果要覆盖即使键已存在的值，请改用 `wincache_ucache_set()` 函数。键还可以接受名称 => 值对的数组，其中名称将用作键。这可以用于在一次操作中将多个值添加到缓存中，从而避免竞态条件。
value要存储的变量的值。值支持除资源（如文件句柄）之外的所有数据类型。如果第一个参数是一个数组，则此参数将被忽略。一般建议在使用数组作为键时将值传递为 null。如果值是一个对象，或包含对象的数组，则对象将被序列化。有关对象序列化的详细信息，请参阅 `__sleep()`。
values关联数组，包含键和值。
ttl变量在缓存中存活的时间，以秒为单位。在 ttl 中指定的值经过后，存储的变量将从缓存中删除。此参数的默认值为 0，这意味着变量将一直保留在缓存中，除非通过使用 `wincache_ucache_delete()` 或 `wincache_ucache_clear()` 函数明确删除。
返回值
如果键是字符串，该函数在成功时返回 true，在失败时返回 false。
如果键是一个数组，该函数返回以下值：
- 如果数组中的所有名称 => 值对都可以设置，函数返回一个空数组。
- 如果数组中的所有名称 => 值对都无法设置，函数返回 false。
- 如果有些可以设置而其他一些无法设置，函数将返回一个数组，其中包含在用户缓存中添加失败的名称 => 值对。
示例
示例 #1 wincache_ucache_add() with key as a string
<?php
$bar = 'BAR';
var_dump(wincache_ucache_add('foo', $bar));
var_dump(wincache_ucache_add('foo', $bar));
var_dump(wincache_ucache_get('foo'));
?>以上示例会输出：
bool(true)
bool(false)
string(3) "BAR"
示例 #2 wincache_ucache_add() with key as an array
<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_add($colors_array));
var_dump(wincache_ucache_add($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>以上示例会输出：
array(0) { }
array(4) {
["green"]=> int(-1)
["Blue"]=> int(-1)
["yellow"]=> int(-1)
["cyan"]=> int(-1)
}
string(1) "6"
参见
- wincache_ucache_set() - 在用户缓存中添加变量，并在已存在于缓存中的情况下覆盖变量
- wincache_ucache_get() - 获取存储在用户缓存中的变量
- wincache_ucache_delete() - 从用户缓存中删除变量
- wincache_ucache_clear() - 删除用户缓存的全部内容
- wincache_ucache_exists() - 检查用户缓存中是否存在变量
- wincache_ucache_meminfo() - 获取用户缓存内存使用情况的信息
- wincache_ucache_info() - 获取存储在用户缓存中的数据信息
- __sleep() - 魔术方法，用于对象序列化时的自定义操作