apcu_add 函数

适用 PHP 版本

适用于 PHP 5.5.0 及以上版本。

函数说明

apcu_add 函数用于将一个变量添加到 APC（Alternative PHP Cache）缓存中。与 apcu_store 不同，apcu_add 只有在缓存中没有指定的键时才会将数据添加到缓存中，如果指定的键已经存在，则不会做任何操作。

函数语法

bool apcu_add(string $key, mixed $value, int $ttl = 0);

参数

• key (string): 要缓存的变量的键名。
• value (mixed): 要缓存的值。可以是任意类型的数据。
• ttl (int, 可选): 缓存项的存活时间（单位：秒）。默认值为 0，表示数据永不过期。

返回值

成功时返回 true，如果缓存键已存在，则返回 false。

示例

以下示例展示了如何使用 apcu_add 函数将数据添加到 APC 缓存中，并确保仅在缓存中没有指定的键时才添加数据：

示例代码

$key = 'user_data';
$value = ['name' => 'John', 'age' => 25];
<p>// 尝试添加数据到 APC 缓存中，如果键 'user_data' 已存在，则不进行任何操作<br>
if (apcu_add($key, $value)) {<br>
echo '数据已成功添加到缓存。';<br>
} else {<br>
echo '该键已存在，未进行任何操作。';<br>
}<br>

示例代码说明

在此示例中，我们首先定义了缓存的键名 $key 和要缓存的值 $value。然后使用 apcu_add 函数尝试将数据添加到缓存中。如果缓存中已经存在键 'user_data'，则 apcu_add 函数返回 false，不会进行任何修改；如果键不存在，则成功添加数据并返回 true。