« apcu_sma_info
APCUIterator »

apcu_store

(PECL apcu >= 4.0.0)

apcu_store — 変数をデータ領域にキャッシュする

説明

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

変数をデータ領域にキャッシュします。

注意:

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'));
?>

上の例の出力は以下となります。

string(3) "BAR"

参考

  • apcu_add() - 新規の変数をデータ領域にキャッシュする
  • apcu_fetch() - 格納されている変数をキャッシュから取得する
  • apcu_delete() - 格納されている変数をキャッシュから取り除く
関連キーワード:
キャッシュ   apcu   変数   格納   store   領域   mixed   values   リクエスト   持続   キー   fetch   info   APCUIterator   APCu   unused   仕組み   一意   有効期間   秒間   経過   手動   clear   restart   成功
関連する関数・ページ:
function.apcu-add   function.apcu-fetch   function.apcu-delete   function.apcu-key-info   ref.apcu   book.apcu