Memcache::get

サーバーから項目を取得する

説明

string Memcache::get(string $key, int &$flags = ?)

array Memcache::get(array $keys, array &$flags = ?)

その時点でサーバー上の key にそのようなキーが存在する場合、 Memcache::get は、前に格納されていたデータを返します。

Memcache::get にキーの配列を渡すことにより、値の配列を取得することができます。この配列には、サーバー上で見つかったキーと値のペアのみが含まれます。

パラメータ

key: 取得したいキー (あるいはキーの配列)。
flags: 存在した場合は、値とともに取得したフラグをここに書き込みます。これらのフラグは、たとえば Memcache::set に渡すものと同じです。int の最下位バイトは pecl/memcache で内部的に使用するために予約されています (たとえば圧縮やシリアライズに関する状態を表します)。

戻り値

key に関連付けられた値を返します。 key が配列の場合は、見つかったキー・値のペアを配列で返します。取得に失敗したり key が見つからなかったり、あるいは key が空だったりした場合は false を返します。

例

例1 Memcache::get の例

<?php

/* 手続き型の API */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, 'some_key');

/* オブジェクト指向の API */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get('some_key');

/* 
キーの配列をパラメータとして使用することもできます。
もしキーに対応する項目がサーバー上で見つからなければ、
結果の配列の中にはそのキーは含まれません。
*/

/* 手続き型の API */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, Array('some_key', 'another_key'));

/* オブジェクト指向の API */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get(Array('some_key', 'second_key'));

?>