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 = null,int
$get_flags = 0): 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 ausfindig zu machen, mit dem gesprochen werden soll. 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 -
get_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 get_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
add a note
