(PECL wincache >= 1.1.0)
wincache_ucache_get — ユーザーキャッシュに格納された変数を取得する
key
変数をキャッシュに格納するときに使ったキーの名前。
key
は大文字小文字を区別します。
key
にはキーの配列を指定することもできます。
その場合の戻り値は、key
配列の各要素の値の配列となります。
オブジェクト、あるいはオブジェクトを含む配列が返されるときには、
オブジェクトがデシリアライズされます。シリアライズしたオブジェクトの復元についての詳細は
__wakeup() を参照ください。
success
成功した場合に true
、失敗した場合に false
が設定されます。
key
が文字列のときは、そのキーに格納された変数の値を返します。
success
には、成功した場合に true
、
失敗した場合に false
が設定されます。
key
が配列のときは、success
には常に
true
が設定されます。返される配列 (name => value のペア)
には、取得に成功したペアだけが含まれます。指定したキーがひとつもユーザーキャッシュから見つからなかった場合は
空の配列を返します。
例1 wincache_ucache_get() で key
に文字列を使う例
<?php
wincache_ucache_add('color', 'blue');
var_dump(wincache_ucache_get('color', $success));
var_dump($success);
?>
上の例の出力は以下となります。
string(4) "blue" bool(true)
例2 wincache_ucache_get() で key
に配列を使う例
<?php
$array1 = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
wincache_ucache_set($array1);
$array2 = array('green', 'Blue', 'yellow', 'cyan');
var_dump(wincache_ucache_get($array2, $success));
var_dump($success);
?>
上の例の出力は以下となります。
array(4) { ["green"]=> string(1) "5" ["Blue"]=> string(1) "6" ["yellow"]=> string(1) "7" ["cyan"]=> string(1) "8" } bool(true)