= 4.0.0)apcu_add — 緩存一個新變量到存儲中 說明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 — 緩存一個新變量到存儲中

說明

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

將一個從未被緩存過的變量添加到到存儲中。

注意: 與 PHP 中常見的變量生命周期不同的是，通過 apcu_add() 存儲的變量可以在多個 request 之間共享（直到該變量從 cache 中被刪除）。

參數(shù)

key

使用此名稱存儲變量。key 必須是唯一的，因此如果用 apcu_add() 存儲變量時指定的 key 已經存在， 就會直接返回 false，不會覆寫已有的數(shù)據(jù)。（這也是 apcu_add() 和 apcu_store() 之間唯一的區(qū)別。）

var

被存儲的變量

ttl

變量生存時間（Time To Live）；被存儲的 var 經過 ttl 秒后，會從存儲中被刪除（下一次請求時）。如果沒提供 ttl （或 ttl 為 0 ），該變量會一直存在直到手動刪除它，或者其他原因導致該變量從緩存中消失（清除，重啟等等。）。

values

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

返回值

變量被成功添加時返回 TRUE，否則返回 FALSE。第二種語法返回包含添加失敗的 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";
?>

以上例程會輸出：

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

參見