array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'memcache.get.php', 1 => 'Memcache::get', 2 => 'Извлекает элемент с сервера', ), 'up' => array ( 0 => 'class.memcache.php', 1 => 'Memcache', ), 'prev' => array ( 0 => 'memcache.flush.php', 1 => 'Memcache::flush', ), 'next' => array ( 0 => 'memcache.getextendedstats.php', 1 => 'Memcache::getExtendedStats', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/memcache/memcache/get.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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'));

?>