Php/docs/memcache.get

提供:Dev Guides
< Php
移動先:案内検索

Memcache::get

(PECL memcache >= 0.2.0)

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


説明

Memcache::get ( string $key [, int &$flags ] ) : string

Memcache::get ( array $keys [, array &$flags ] ) : array

その時点でサーバー上の 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'));?>