Memcached::setByKey
(PECL memcached >= 0.1.0)
Memcached::setByKey — Store an item on a specific server
Descrição
$server_key
, string $key
, mixed $value
, int $expiration = ?
) : bool
Memcached::setByKey() is functionally equivalent to
Memcached::set(), 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.
Use Memcached::getResultCode() se necessário.
Exemplos
Exemplo #1 Memcached::setByKey() example
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
/* keep IP blocks on a certain server */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>
add a note
