array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.wincache-ucache-get.php', 1 => 'wincache_ucache_get', ), 'up' => array ( 0 => 'ref.wincache.php', 1 => 'WinCache 関数', ), 'prev' => array ( 0 => 'function.wincache-ucache-exists.php', 1 => 'wincache_ucache_exists', ), 'next' => array ( 0 => 'function.wincache-ucache-inc.php', 1 => 'wincache_ucache_inc', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/wincache/functions/wincache-ucache-get.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL wincache >= 1.1.0)
wincache_ucache_get — ユーザーキャッシュに格納された変数を取得する
key
変数をキャッシュに格納するときに使ったキーの名前。
key
は大文字小文字を区別します。
key
にはキーの配列を指定することもできます。
その場合の戻り値は、key
配列の各要素の値の配列となります。
オブジェクト、あるいはオブジェクトを含む配列が返されるときには、
オブジェクトがアンシリアライズされます。シリアライズしたオブジェクトの復元についての詳細は
__wakeup() を参照ください。
success
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)