Memcached::replaceByKey
(PECL memcached >= 0.1.0)
Memcached::replaceByKey — Replace the item under an existing key on a specific server
Descrição
$server_key
, string $key
, mixed $value
, int $expiration = ?
) : bool
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.
Parâmetros
-
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.
Valor Retornado
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.
Veja Também
- Memcached::replace() - Replace the item under an existing key
- Memcached::set() - Store an item
- Memcached::add() - Add an item under a new key
add a note
