(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
]] )
僅僅在緩存變量不存在的情況下緩存變量到數據存儲中
Note: 與PHP中其他的機制不同,使用apc_add() 存儲變量 在不同的請求之間一直持久存在(直到從緩存系統中移除)
參數
key
存儲緩存變量使用的名稱key
s 是唯一的,
所以試圖使用 apc_add() 去添加一個名稱已經存在的緩存,
將不會覆蓋現有的緩存的值, 并且返回 FALSE
. (這個是 apc_add() 和
apc_store()之間唯一的不同.)
var
存儲的變量
ttl
生存時間;在緩存中存儲var
共ttl
秒,
在ttl
秒過去后,存儲的變量將會從緩存中擦除(在下一次請求時),
如果沒有設置ttl
(或者ttl
是0),
變量將一直存活到被手動移除為止,除此之外不在緩存中的可能原因是,緩存系統使用clear,或者restart等
values
Names in key, variables in value.
返回值
Returns TRUE if something has effectively been added into the cache, FALSE otherwise. Second syntax returns array with error keys.
范例
Example #1 apc_add() 例子
<?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"
參見
apc_store() - Cache a variable in the data store apc_fetch() - 從緩存中取出存儲的變量 apc_delete() - 從用戶緩存中刪除某個變量