(PECL wincache >= 1.1.0)

wincache_ucache_set — 将一个变量添加到用户缓存中，并在缓存中已存在相同键的变量时覆盖它。

说明

wincache_ucache_set(mixed $key, mixed $value, int $ttl = 0): bool

wincache_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()