apcu_add

apcu_add

(PECL apcu >= 4.0.0)

apcu_add - 缓存数据存储中的新变量

描述

bool apcu_add ( string $key , mixed $var [, int $ttl = 0 ] )

array apcu_add ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] )

只有在数据存储尚未存储时才在数据存储中缓存变量。

注意：与 PHP 中的许多其他机制不同，使用 apcu_add（）存储的变量将在请求之间持续存在（直到从缓存中删除该值）。

参数

key

使用这个名称存储变量。key是缓存唯一的，所以试图使用apcu_add（）来存储已存在的键的数据不会覆盖现有的数据，而是返回FALSE。（这是apcu_add（）和 apcu_store（）之间的唯一区别。）

var

要存储的变量

ttl

生存时间; var在缓存中存储ttl几秒钟。在ttl通过之后，存储的变量将从缓存中删除（在下一个请求中）。如果ttl提供了 no （或者如果该ttl值为0），则该值将一直保持到手动将其从缓存中移除，否则将无法存在于缓存中（清除，重新启动等）。

values

键中的名称，值中的变量。

返回值

如果某些内容已被有效地添加到缓存中，则返回 TRUE ; 否则返回 FALSE 。第二个语法返回带有错误键的数组。

例子

Example #1 A apcu_add() example

<?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"