Memcached::casByKey
(PECL memcached >= 0.1.0)
Memcached::casByKey — Compara e troca um item em um servidor específico
Descrição
string|int|float
$cas_token
,string
$server_key
,string
$key
,mixed
$value
,int
$expiration
= 0): bool
Memcached::casByKey() é funcionalmente equivalente a
Memcached::cas(), 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
cas_token
-
Valor exclusivo associado ao item existente. Gerado por memcache.
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.
O Memcached::getResultCode() retornará
Memcached::RES_DATA_EXISTS
se o item que você
está tentando armazenar tiver sido modificado desde a última vez que você o buscou.