PHP Manual
Memcached
Retrieve an item from a specific server

Memcached::getByKey

(PECL memcached >= 0.1.0)

Memcached::getByKey — Retrieve an item from a specific server

Beschreibung

public Memcached::getByKey(
    string $server_key,
    string $key,
    callable $cache_cb = ?,
    int $flags = ?
): mixed

Memcached::getByKey() is functionally equivalent to Memcached::get(), except that the free-form server_key can be used to map the key to a specific server.

Parameter-Liste

server_key: Ein Schlüssel, der den Server bestimmt, auf dem die Daten abgelegt oder von dem Daten abgerufen werden sollen. Anstatt den tatsächlichen Schlüssel des Wertes zu hashen wird der Server-Key gehasht um den Memcached-Server mit dem gesprochen werden soll ausfindig zu machen. Dies erlaubt es alle zusammengehörigen Daten auf einem einzigen Server abzulegen um multiple Operationen effizienter zu gestalten.
key: The key of the item to fetch.
cache_cb: Read-through caching callback or null
flags: Flags to control the returned result. When value of Memcached::GET_EXTENDED is given will return the CAS token.

Rückgabewerte

Returns the value stored in the cache or false otherwise. The Memcached::getResultCode() will return Memcached::RES_NOTFOUND if the key does not exist.

Changelog

Version	Beschreibung
PECL memcached 3.0.0	The `&cas_token` parameter was removed. Instead `flags` was added and when it is given the value of `Memcached::GET_EXTENDED` it will ensure the CAS token to be fetched.