Memcached::getByKey
(PECL memcached >= 0.1.0)
Memcached::getByKey — 指定したサーバーからアイテムを取得する
説明
public Memcached::getByKey
( string
$server_key
, string $key
[, callable $cache_cb
[, int $flags
]] ) : mixed
Memcached::getByKey() は機能的に
Memcached::get() と同等です。しかし、自由形式の
server_key を使用して、
key を特定のサーバーに関連付けることができます。
パラメータ
-
server_key -
値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
-
key -
取得したいアイテムのキー。
-
cache_cb -
Read-through キャッシュコールバック、あるいは
NULL。 -
flags -
Flags to control the returned result. When value of
Memcached::GET_EXTENDEDis given will return the CAS token.
返り値
キャッシュに格納された値、あるいは FALSE を返します。
キーが存在しない場合、
Memcached::getResultCode() は
Memcached::RES_NOTFOUND を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 3.0.0 |
&cas_token パラメータは削除されました。
Instead flags was added and when it is given the value of Memcached::GET_EXTENDED it will ensure the CAS token to be fetched.
|
参考
- Memcached::get() - アイテムを取得する
- Memcached::getMulti() - 複数のアイテムを取得する
- Memcached::getDelayed() - 複数のアイテムを要求する