Memcached::getByKey
(PECL memcached >= 0.1.0)
Memcached::getByKey — Retrieve an item from a specific server
Beschreibung
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_EXTENDEDis 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.
|
Siehe auch
- Memcached::get() - Retrieve an item
- Memcached::getMulti() - Retrieve multiple items
- Memcached::getDelayed() - Request multiple items
