apc_add
(PECL apc >= 3.0.13)
apc_add — 新規の変数をデータ領域にキャッシュする
説明
まだ保存されていない場合にのみ、変数をデータ領域にキャッシュします。
注意: PHP の他の多くの仕組みと異なり、apc_add() を用いて格納された変数はリクエストを超えて （その値がキャッシュから取り除かれるまで）持続します。
パラメータ
-
key -
この名前を用いて変数を格納します。
keyは キャッシュ内で一意です。そのため、apc_add() を使用して同一のkeyで新しい値を格納しようとしても、それは保存されません。 かわりにFALSEが返されます (これが、apc_add() と apc_store() の唯一の相違点です)。 -
var -
格納する変数。
-
ttl -
有効期間。
varは、キャッシュにttl秒間だけ格納されます。ttlが経過すると、格納されている変数は （次のリクエスト時に）キャッシュから削除されます。ttlが指定されていない（あるいはttlが 0 の場合）は、 キャッシュから手動で削除される・あるいはキャッシュに存在できなくなる （clear, restart など）まで値が持続します。 -
values -
名前をキー、変数を値に指定します。
返り値
何かがキャッシュに正しく追加されたときに TRUE、それ以外の場合に FALSE を返します。 二番目の構文は、エラーになったキーを含む配列を返します。
例
例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() - 変数をデータ領域にキャッシュする
- apc_fetch() - 格納されている変数をキャッシュから取得する
- apc_delete() - 格納されている変数をキャッシュから取り除く
忘却曲線を使ってこの関数を確実に記憶に残す
