Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKey — Armazena um item em um servidor específico

Descrição

public Memcached::setByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = ?
): 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 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() 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);
?>

Veja Também

Memcached::set() - Armazena um item

＋add a note

User Contributed Notes

There are no user contributed notes for this page.