PHP マニュアル: 指定したサーバーからアイテムを取得する

public mixed Memcached::getByKey(
    string $server_key,
    string $key,
    callablenull $cache_cb = null,
    int $get_flags = 0
)

Memcached::getByKey は機能的に Memcached::get と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバーに関連付けることができます。

server_key: 値を格納したりデータを取得したりするサーバーを表すキー。アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
key: 取得したいアイテムのキー。
cache_cb: Read-through キャッシュコールバック、あるいは null。
get_flags: 戻り値を制御するフラグ。 Memcached::GET_EXTENDED を渡すと、CASトークンを返します。

キャッシュに格納された値、あるいは false を返します。キーが存在しない場合、 Memcached::getResultCode は Memcached::RES_NOTFOUND を返します。

バージョン	説明
PECL memcached 3.0.0	`&cas_token` パラメータは削除されました。代替として `get_flags` が追加され、これに `Memcached::GET_EXTENDED` を渡すと、 CAS トークンも取得するようになりました。