= 4.0.0)apcu_add — 緩存一個(gè)新變量到存儲(chǔ)中 說(shuō)明apcu_add(string $key, mixed $var, int $ttl = 0): boolapcu_add(array $values, mixed $unused = NULL">

apcu_add

(PECL apcu >= 4.0.0)

apcu_add 緩存一個(gè)新變量到存儲(chǔ)中

說(shuō)明

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

將一個(gè)從未被緩存過(guò)的變量添加到到存儲(chǔ)中。

注意: 與 PHP 中常見(jiàn)的變量生命周期不同的是,通過(guò) apcu_add() 存儲(chǔ)的變量可以在多個(gè) request 之間共享(直到該變量從 cache 中被刪除)。

參數(shù)

key

使用此名稱存儲(chǔ)變量。key 必須是唯一的,因此如果用 apcu_add() 存儲(chǔ)變量時(shí)指定的 key 已經(jīng)存在, 就會(huì)直接返回 false,不會(huì)覆寫(xiě)已有的數(shù)據(jù)。(這也是 apcu_add()apcu_store() 之間唯一的區(qū)別。)

var

被存儲(chǔ)的變量

ttl

變量生存時(shí)間(Time To Live);被存儲(chǔ)的 var 經(jīng)過(guò) ttl 秒后,會(huì)從存儲(chǔ)中被刪除(下一次請(qǐng)求時(shí))。如果沒(méi)提供 ttl (或 ttl0 ),該變量會(huì)一直存在直到手動(dòng)刪除它,或者其他原因?qū)е略撟兞繌木彺嬷邢Вㄇ宄貑⒌鹊?。)?

values

數(shù)組索引作為 key,數(shù)組值作為被存儲(chǔ)的 var。

返回值

變量被成功添加時(shí)返回 TRUE,否則返回 FALSE。第二種語(yǔ)法返回包含添加失敗的 key 的數(shù)組。

范例

示例 #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";
?>

以上例程會(huì)輸出:

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

參見(jiàn)