(PECL apcu >= 4.0.0)
apcu_add — 緩存一個(gè)新變量到存儲(chǔ)中
將一個(gè)從未被緩存過(guò)的變量添加到到存儲(chǔ)中。
注意: 與 PHP 中常見(jiàn)的變量生命周期不同的是,通過(guò) apcu_add() 存儲(chǔ)的變量可以在多個(gè) request 之間共享(直到該變量從 cache 中被刪除)。
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
(或 ttl
為 0
),該變量會(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"