Memcached::replaceByKey
(PECL memcached >= 0.1.0)
Memcached::replaceByKey — Replace the item under an existing key on a specific server
Beschreibung
string
$server_key
,string
$key
,mixed
$value
,int
$expiration
= ?): bool
Memcached::replaceByKey() is functionally equivalent to
Memcached::replace(), except that the free-form
server_key
can be used to map the
key
to a specific server. This is useful if you need
to keep a bunch of related keys on a certain 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
-
Der Schlüssel, unter dem der Wert abgelegt werden soll.
-
value
-
Der zu speichernde Wert.
-
expiration
-
Die Verfallszeit, Vorgabewert ist 0. Siehe Verfallszeiten für weiterführende Informationen.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
The Memcached::getResultCode() will return
Memcached::RES_NOTSTORED
if the key does not exist.
Siehe auch
- Memcached::replace() - Replace the item under an existing key
- Memcached::set() - Store an item
- Memcached::add() - Add an item under a new key