(PECL memcached >= 0.1.0)
Memcached::addByKey — Add an item under a new key on a specific server
$server_key
, string $key
, mixed $value
[, int $expiration
] )
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.
server_keyA chave identificando o servidor onde armazenar ou recuperar o valor. Em vez de fazer o hash do item, é feito o hash da chave do servidor quando decidindo com qual servidor memcached conectar. Isto permite que itens relacionados sejam agrupados em um único servidor para maior eficiência de operações múltiplas.
keyA chave sobre a qual guardar o valor.
valueO valor para guardar.
expirationO tempo de expiração, padrão é 0. Veja Tempos de Expiração para maiores informações.
Retorna TRUE em caso de sucesso ou FALSE em caso de falha.
The Memcached::getResultCode() will return
Memcached::RES_NOTSTORED if the key already exists.