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