Memcache::get
Retrieve item from the server
Description
string Memcache::get(string $key
, int &$flags
= ?)
array Memcache::get(array $keys
, array &$flags
= ?)
You can pass array of keys to Memcache::get to get
array of values. The result array will contain only found key-value pairs.
Parameters
-
key
-
The key or array of keys to fetch.
-
flags
-
If present, flags fetched along with the values will be written to this parameter. These
flags are the same as the ones given to for example Memcache::set.
The lowest byte of the int is reserved for pecl/memcache internal usage (e.g. to indicate
compression and serialization status).
Return Values
Returns the value associated with the key
or
an array of found key-value pairs when key
is an array.
Returns false
on failure, key
is not found or
key
is an empty array.
Examples
Example #1 Memcache::get example
<?php
/* procedural API */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, 'some_key');
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get('some_key');
/*
You also can use array of keys as a parameter.
If such item wasn't found at the server, the result
array simply will not include such key.
*/
/* procedural API */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, Array('some_key', 'another_key'));
/* OO API */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get(Array('some_key', 'second_key'));
?>