Memcache::get

memcache_get

(PECL memcache >= 0.2.0)

Memcache::get -- memcache_getRecupera item do servidor

Descrição

Memcache::get(string $key, int &$flags = ?): string
Memcache::get(array $keys, array &$flags = ?): array
memcache_get(Memcache $memcache, string $key, int &$flags = ?): string
memcache_get(Memcache $memcache, array $keys, array &$flags = ?): array

Memcache::get() retorna dados armazenados anteriormente de um item, se a chave informada em key existir no servidor no momento.

Pode ser passado um array de chaves para Memcache::get() para obter array de valores. O array resultante conterá apenas pares de chave-valor encontrados.

Parâmetros

key

A chave ou conjunto de chaves a serem buscadas.

flags

Se presente, os sinalizadores buscados junto com os valores serão gravados neste parâmetro. Esses sinalizadores são os mesmos que os fornecidos para, por exemplo, Memcache::set(). O byte menos significativo do inteiro é reservado para uso interno pecl/memcache (por exemplo, para indicar o status de compressão e serialização).

Valor Retornado

Retorna o valor associado à chave informada em key ou um array de pares de chave-valor encontrados quando key é um array. Retorna false em caso de falha, key não é encontrado ou key é um array vazio.

Exemplos

Exemplo #1 Exemplo de Memcache::get()

<?php

/* API procedural */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, 'some_key');

/* API orientada a objeto */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get('some_key');

/*
Também pode ser usado um array de chaves como parâmetro.
Se tal item não foi encontrado no servidor, o array de resultados
simplesmente não incluirá tal chave.
*/

/* API procedural */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, Array('some_key', 'another_key'));

/* API orientada a objeto */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get(Array('some_key', 'second_key'));

?>