(PECL apcu >= 4.0.0)
apcu_add — 緩存一個(gè)新變量到存儲中
將一個(gè)從未被緩存過(guò)的變量添加到到存儲中。
注意: 與 PHP 中常見(jiàn)的變量生命周期不同的是,通過(guò) apcu_add() 存儲的變量可以在多個(gè) request 之間共享(直到該變量從 cache 中被刪除)。
key
使用此名稱(chēng)存儲變量。key
必須是唯一的,因此如果用 apcu_add() 存儲變量時(shí)指定的 key 已經(jīng)存在, 就會(huì )直接返回 false
,不會(huì )覆寫(xiě)已有的數據。(這也是 apcu_add() 和 apcu_store() 之間唯一的區別。)
var
被存儲的變量
ttl
變量生存時(shí)間(Time To Live);被存儲的 var
經(jīng)過(guò) ttl
秒后,會(huì )從存儲中被刪除(下一次請求時(shí))。如果沒(méi)提供 ttl
(或 ttl
為 0
),該變量會(huì )一直存在直到手動(dòng)刪除它,或者其他原因導致該變量從緩存中消失(清除,重啟等等。)。
values
數組索引作為 key,數組值作為被存儲的 var。
變量被成功添加時(shí)返回 TRUE,否則返回 FALSE。第二種語(yǔ)法返回包含添加失敗的 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";
?>
以上例程會(huì )輸出:
string(3) "BAR" string(3) "BAR"