Memcached::getByKey
(PECL memcached >= 0.1.0)
Memcached::getByKey — Recupera item de um servidor específico
Descrição
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_EXTENDEDfor 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
- Memcached::get() - Recupera um item
- Memcached::getMulti() - Recupera vários itens
- Memcached::getDelayed() - Solicita vários itens
add a note
