array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'memcached.get.php', 1 => 'Memcached::get', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.flush.php', 1 => 'Memcached::flush', ), 'next' => array ( 0 => 'memcached.getallkeys.php', 1 => 'Memcached::getAllKeys', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/memcached/memcached/get.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL memcached >= 0.1.0)
Memcached::get — Recupera um item
Memcached::get() retorna o item que foi armazenado anteriormente
na key
. Se o item for encontrado e
o get_flags
for fornecido como Memcached::GET_EXTENDED
,
ele também retornará o valor do token CAS para o item. Consulte
Memcached::cas() para saber como usar tokens CAS.
O callback de cache de leitura pode ser
especificado por meio do parâmetro cache_cb
.
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 Memcached::GET_EXTENDED
for fornecido, a função também retornará o token CAS.
Retorna o valor armazenado no cache ou false
caso contrário.
Se o parâmetro get_flags
for definido como Memcached::GET_EXTENDED
,
um array contendo o valor e o token CAS será retornado em vez de apenas o valor.
O Memcached::getResultCode() retornará
Memcached::RES_NOTFOUND
se a key não existir.
Versão | Descrição |
---|---|
PECL memcached 3.0.0 |
O parâmetro &cas_token foi removido.
Em vez disso, as get_flags foram adicionadas e, quando receber o valor de Memcached::GET_EXTENDED , garantirá que o token CAS seja buscado.
|
Exemplo #1 Memcached::get() exemplo #1
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('foo', 100);
var_dump($m->get('foo'));
?>
O exemplo acima produzirá:
int(100)
Exemplo #2 Memcached::get() exemplo #2
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
if (!($ip = $m->get('ip_block'))) {
if ($m->getResultCode() == Memcached::RES_NOTFOUND) {
$ip = array();
$m->set('ip_block', $ip);
} else {
/* log error */
/* ... */
}
}
?>