Memcached::setByKey
(PECL memcached >= 0.1.0)
Memcached::setByKey — Armazena um item em um servidor específico
Descrição
string
$server_key,string
$key,mixed
$value,int
$expiration = 0): bool
Memcached::setByKey() é funcionalmente equivalente a
Memcached::set(), exceto que a forma livre
server_key pode ser usada para mapear a
key para um servidor específico. Isso é útil se você
precisar manter várias keys relacionadas em um determinado servidor.
Parâmetros
-
server_key -
A chave que identifica o servidor no qual armazenar o valor ou de onde recuperá-lo. Em vez de fazer o hash na chave real do item, o hash é feito na chave do servidor ao decidir com qual servidor memcached se comunicar. Isso permite que itens relacionados sejam agrupados em um único servidor para eficiência com múltiplas operações.
-
key -
A chave sob a qual armazenar o valor.
-
value -
O valor a ser armazenado.
-
expiration -
O tempo de expiração padrão é 0. Consulte Tempos de Expiração para mais 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() exemplo
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
/* manter blocos de IP em um determinado servidor */
$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
