apc_add

apc_add

(PECL apc >= 3.0.13)

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

描述

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

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

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

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

参数

key

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

var

要存储的变量

ttl

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

values

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

返回值

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

例子

Example #1 A apc_add() example

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

上面的例子将输出：

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