Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — Add an item under a new key on a specific server
Descrierea
$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.
Parametri
-
server_key -
Cheia ce identifică serverul pe care se înscrie, sau de pe care se citește valoarea. În loc de a efectua hash asupra cheii nemijlocite a elementului, se efectuaează hash asupra cheii serverului, atunci când se decide cu care server memcached să se comunice. Aceasta permite ca elementele asociate să fie grupate împreună pe un singur server pentru a mări eficiența operațiilor multiple.
-
key -
Cheia sub care se stochează valoarea.
-
value -
Valoarea pentru a fi stocată.
-
expiration -
Timpul expirării, implicit este 0. Accesați Timpurile de expirare pentru informații suplimentare.
Valorile întoarse
Întoarce valoarea true în cazul
succesului sau false în cazul eșecului.
The Memcached::getResultCode() will return
Memcached::RES_NOTSTORED if the key already exists.
A se vedea și
- Memcached::add() - Add an item under a new key
- Memcached::set() - Store an item
- Memcached::replace() - Replace the item under an existing key
add a note
