Memcached::get
(PECL memcached >= 0.1.0)
Memcached::get — Получение записи
Описание
Memcached::get() возвращает запись, которая ранее была
сохранена под ключом key. Если элемент не найден и
для параметра flags задано Memcached::GET_EXTENDED, то она также возвратит значение токена CAS для этой записи.
Обратитесь к документации по Memcached::cas() для получения информации об
использовании CAS токена. Чтение при помощи кэширующих callback-функций
может быть использовано с помощью параметра cache_cb.
Список параметров
-
key -
Ключ получаемой записи.
-
cache_cb -
Функция обратного вызова для кэшируемого чтения или
null. -
flags -
Флаги, определяющие возвращаемый результат. Если задана константа
Memcached::GET_EXTENDED, функция также возвратит токен CAS.
Возвращаемые значения
Возвращает значение хранимое в кеше или false в противном случае.
Если в flags установлена константа, Memcached::GET_EXTENDED,
возвращается массив, содержащий значение и токен CAS вместо единственного значения.
Метод Memcached::getResultCode() возвращает
Memcached::RES_NOTFOUND если переданный ключ не существует.
Примеры
Пример #1 Пример использования Memcached::get() #1
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('foo', 100);
var_dump($m->get('foo'));
?>
Результат выполнения данного примера:
int(100)
Пример #2 Пример использования Memcached::get() #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 */
/* ... */
}
}
?>
Список изменений
| Версия | Описание |
|---|---|
| PECL memcached 3.0.0 |
Удален параметр &cas_token.
Вместо недо добавлен параметр flags, в который можно
передать значение Memcached::GET_EXTENDED для того,
чтобы был возвращен токен CAS.
|
Смотрите также
- Memcached::getByKey() - Получает запись с определенного сервера
- Memcached::getMulti() - Получает несколько записей
- Memcached::getDelayed() - Запрашивает несколько записей