Memcache::get

memcache_get

(PECL memcache >= 0.2.0)

Memcache::get -- memcache_get — Извлекает элемент с сервера

Описание

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() возвращает данные элемента с ключом key, если сервер содержит такой ключ.

При передаче в метод Memcache::get() массива ключей возвращается массив значений. В массив с результатами добавляются только те пары «ключ — значение», которые содержит кеш сервера, остальные игнорируются.

Список параметров

key: Ключ или массив ключей для извлечения элементов.
flags: При вызове метода с этим аргументом параметр заполняется флагами, которые метод извлёк вместе со значениями. Это в точности те флаги, которые указывают, например, при вызове метода Memcache::set(). Младший байт каждого целочисленного значения резервируется для внутренних целей модуля pecl/memcache, например, чтобы указать статус сжатия или сериализации.

Возвращаемые значения

Метод возвращает значение, которое связали с ключом key, или массив найденных пар «ключ — значение», если в параметр key передали массив. Метод возвращает значение false, если возникла ошибка, сервер не нашёл ключ key или с ключом key связали пустой массив.

Примеры

Пример #1 Пример извлечения записи кеша методом Memcache::get()

<?php

/* Процедурный API */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, 'some_key');

/* Объектно-ориентированный API */
$memcache_obj = new Memcache();
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get('some_key');

/*
Параметр также принимает массив ключей.
В массив с результатами добавляются только те элементы,
которые содержит кеш сервера, остальные игнорируются
*/

/* Процедурный API */
$memcache_obj = memcache_connect('memcache_host', 11211);
$var = memcache_get($memcache_obj, Array('some_key', 'another_key'));

/* Объектно-ориентированный API */
$memcache_obj = new Memcache();
$memcache_obj->connect('memcache_host', 11211);
$var = $memcache_obj->get(array('some_key', 'second_key'));

?>