wincache_ucache_set
変数をユーザーキャッシュに追加し、変数が既にキャッシュに存在する場合はそれを上書きする
説明
bool wincache_ucache_set(mixed $key, mixed $value, int $ttl = 0)
bool wincache_ucache_set(array $values, mixed $unused = NULL, int $ttl = 0)
パラメータ
-
key
-
変数を格納するときに、この名前のキーを使います。
同じキーで既に変数が格納されているときは、元の値を新しい値で上書きします。
key には name => value のペアの配列を渡すこともできます。
この場合は name がキーとなります。
この形式を使えば複数の値を一度の操作でキャッシュに格納できるので、競合状態になることを防げます。
-
value
-
格納したい変数の値。ファイルハンドルのようなリソース型以外のすべてのデータ型をサポートしています。
最初のパラメータが配列の場合は、このパラメータは無視されます。
一般的な指針として、key に配列を渡す場合は
value を null にしておきましょう。
value がオブジェクト、あるいはオブジェクトを含む配列である場合は、
オブジェクトがシリアライズされます。オブジェクトのシリアライズについての詳細は
__sleep() を参照ください。
-
values
-
キーと値の連想配列。
-
ttl
-
変数のキャッシュ内での生存時間を秒単位で指定します。
ttl で指定した秒数が経過すると、
格納されている変数はキャッシュから削除されます。
このパラメータのデフォルト値は 0 で、これは
wincache_ucache_delete
あるいは wincache_ucache_clear
で明示的に削除するまでキャッシュに残り続けることを意味します。
戻り値
key が文字列のときは、成功した場合に true、失敗した場合に false を返します。
key が配列のときの戻り値は、次のようになります。
-
配列内のすべての name => value ペアが設定できた場合は、空の配列を返します。
-
配列内の name => value ペアがひとつも設定できなかった場合は、
false を返します。
-
成功したペアと失敗したペアがある場合は、ユーザーキャッシュへの追加に失敗した name=>value ペアを含む配列を返します。
例
例1 wincache_ucache_set で key を文字列にする例
<?php
$bar = 'BAR';
var_dump(wincache_ucache_set('foo', $bar));
var_dump(wincache_ucache_get('foo'));
$bar1 = 'BAR1';
var_dump(wincache_ucache_set('foo', $bar1));
var_dump(wincache_ucache_get('foo'));
?>
bool(true)
string(3) "BAR"
bool(true)
string(3) "BAR1"
例2 wincache_ucache_set で key を配列にする例
<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>
array(0) {}
array(0) {}
string(1) "6"
参考
- wincache_ucache_add
- wincache_ucache_get
- wincache_ucache_delete
- wincache_ucache_clear
- wincache_ucache_exists
- wincache_ucache_meminfo
- wincache_ucache_info
- __sleep()