大网数据广告活动
PHP 语言与运行手册

apcu_add · 缓存一个新变量到存储中

· 52CE 我爱测

注意: 与 PHP 中常见的变量生命周期不同的是,通过 apcu_add() 存储的变量可以在多个 request 之间共享(直到该变量从 cache 中被删除)。

apcu_add

(PECL apcu >= 4.0.0)

apcu_add — 缓存一个新变量到存储中

说明

function apcu_add(string $key, mixed $var, int $ttl = 0): bool
function apcu_add(array $values, mixed $unused = NULL, int $ttl = 0): array

将一个从未被缓存过的变量添加到到存储中。

注意:

与 PHP 中常见的变量生命周期不同的是,通过 apcu_add() 存储的变量可以在多个 request 之间共享(直到该变量从 cache 中被删除)。

参数

key

使用此名称存储变量。key 必须是唯一的,因此如果用 apcu_add() 存储变量时指定的 key 已经存在, 就会直接返回 false,不会覆写已有的数据。(这也是 apcu_add() 和 apcu_store() 之间唯一的区别。)

var

被存储的变量

ttl

变量生存时间(Time To Live);被存储的 var 经过 ttl 秒后,会从存储中被删除(下一次请求时)。如果没提供 ttl (或 ttl 为 0 ),该变量会一直存在直到手动删除它,或者其他原因导致该变量从缓存中消失(清除,重启等等。)。

values

数组索引作为 key,数组值作为被存储的 var。

返回值

变量被成功添加时返回 TRUE,否则返回 FALSE。第二种语法返回包含添加失败的 key 的数组。

示例

示例 #1 apcu_add() 示例

<?php
$bar = 'BAR';
apcu_add('foo', $bar);
var_dump(apcu_fetch('foo'));
echo "\n";
$bar = 'NEVER GETS SET';
apcu_add('foo', $bar);
var_dump(apcu_fetch('foo'));
echo "\n";
?>

以上示例会输出:

string(3) "BAR"
string(3) "BAR"

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。