Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — Add an item under a new key on a specific server
Beschreibung
string
$server_key,string
$key,mixed
$value,int
$expiration = ?): bool
Memcached::addByKey() is functionally equivalent to
Memcached::add(), 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 already exists.
Siehe auch
- Memcached::add() - Add an item under a new key
- Memcached::set() - Store an item
- Memcached::replace() - Replace the item under an existing key
