apcu_store
変数をデータ領域にキャッシュする
説明
bool apcu_store(string $key
, mixed $var
, int $ttl
= 0)
array apcu_store(array $values
, mixed $unused
= NULL, int $ttl
= 0)
注意:
PHP の他の多くの仕組みと異なり、apcu_store
を用いて格納された変数はリクエストを超えて
(その値がキャッシュから取り除かれるまで)持続します。
パラメータ
-
key
-
この名前を用いて変数を格納します。key
は
キャッシュ内で一意です。そのため、同一の key
で新しい値を格納すると、元の値は上書きされます。
-
var
-
格納する変数。
-
ttl
-
有効期間。var
は、キャッシュに
ttl
秒間だけ格納されます。
ttl
が経過すると、格納されている変数は
(次のリクエスト時に)キャッシュから削除されます。
ttl
が指定されていない(あるいは
ttl
が 0
の場合)は、
キャッシュから手動で削除される・あるいはキャッシュに存在できなくなる
(clear, restart など)まで値が持続します。
-
values
-
名前をキー、変数を値に指定します。
戻り値
成功した場合に true
を、失敗した場合に false
を返します。
二番目の構文は、エラーになったキーを含む配列を返します。
例
例1 apcu_store の例
<?php
$bar = 'BAR';
apcu_store('foo', $bar);
var_dump(apcu_fetch('foo'));
?>
参考
- apcu_add
- apcu_fetch
- apcu_delete