Memcached::getByKey

(PECL memcached >= 0.1.0)

Memcached::getByKey — Recupera item de um servidor específico

Descrição

public Memcached::getByKey(
    string $server_key,
    string $key,
    ?callable $cache_cb = null,
    int $get_flags = 0
): mixed

Memcached::getByKey() é funcionalmente equivalente a Memcached::get(), exceto que a forma livre server_key pode ser usada para mapear a key para um servidor específico.

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 key do item a ser recuperado.

cache_cb

Callback de cache de leitura ou null

get_flags

Flags para controlar o resultado retornado. Quando o valor de Memcached::GET_EXTENDED for fornecido, retornará o token CAS.

Valor Retornado

Retorna o valor armazenado no cache ou false caso contrário. O Memcached::getResultCode() retornará Memcached::RES_NOTFOUND se a key não existir.

Registro de Alterações

Versão Descrição
PECL memcached 3.0.0 O parâmetro &cas_token foi removido. Em vez disso, o parâmetro get_flags foi adicionado e quando é fornecido o valor Memcached::GET_EXTENDED, ele garantirá que o token CAS seja obtido.

Veja Também