(PECL memcached >= 0.1.0)
Memcached::replaceByKey — Replace the item under an existing key on a specific server
$server_key
, string $key
, mixed $value
[, int $expiration
] )
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.
server_key
A 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.
key
A chave sobre a qual guardar o valor.
value
O valor para guardar.
expiration
O 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 does not exist.