apcu_add
(PECL apcu >= 4.0.0)
apcu_add — 快取一個新變數到儲存中
說明
將一個從未被快取過的變數新增到到儲存中。
注意: 與 PHP 中常見的變數生命週期不同的是，通過 apcu_add() 儲存的變數可以在多個 request 之間共享（直到該變數從 cache 中被刪除）。
參數
-
key -
使用此名稱儲存變數。
key必須是唯一的，因此如果用 apcu_add() 儲存變數時指定的 key 已經存在， 就會直接返回false，不會覆寫已有的數據。（這也是 apcu_add() 和 apcu_store() 之間唯一的區別。） -
var -
被儲存的變數
-
ttl -
變數生存時間（Time To Live）；被儲存的
var經過ttl秒后，會從儲存中被刪除（下一次請求時）。如果沒提供ttl（或ttl為0），該變數會一直存在直到手動刪除它，或者其他原因導致該變數從快取中消失（清除，重啟等等。）。 -
values -
陣列索引作為 key，陣列值作為被儲存的 var。
返回值
變數被成功新增時返回 TRUE，否則返回 FALSE。第二種語法返回包含新增失敗的 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";
?>
以上例程會輸出：
string(3) "BAR" string(3) "BAR"
參見
- apcu_store() - 快取一個變數到儲存中
- apcu_fetch() - Fetch a stored variable from the cache
- apcu_delete() - Removes a stored variable from the cache