Memcached::casByKey
(PECL memcached >= 0.1.0)
Memcached::casByKey — Compare and swap an item on a specific server
Beschreibung
float
$cas_token
,string
$server_key
,string
$key
,mixed
$value
,int
$expiration
= ?): bool
Memcached::casByKey() is functionally equivalent to
Memcached::cas(), 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
-
cas_token
-
Unique value associated with the existing item. Generated by memcache.
-
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_DATA_EXISTS
if the item you are trying
to store has been modified since you last fetched it.