array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'memcache.set.php', 1 => 'Memcache::set', 2 => 'Сохраняет данные на сервере', ), 'up' => array ( 0 => 'class.memcache.php', 1 => 'Memcache', ), 'prev' => array ( 0 => 'memcache.replace.php', 1 => 'Memcache::replace', ), 'next' => array ( 0 => 'memcache.setcompressthreshold.php', 1 => 'Memcache::setCompressThreshold', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/memcache/memcache/set.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcache::set

memcache_set

(PECL memcache >= 0.2.0)

Memcache::set -- memcache_set — Сохраняет данные на сервере

Описание

Memcache::set(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
memcache_set(
    Memcache $memcache,
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool

Метод Memcache::set() записывает элемент со значением var на сервере memcache с ключом key. Параметр expire определяет время жизни элемента. При установке для параметра значения 0 элемент никогда не устареет, но сервер memcached не гарантирует постоянное хранение элемента в кеше, при этом элемент доступен для удаления, чтобы освободить место для новых элементов. При передаче в параметр flag флага MEMCACHE_COMPRESSED элемент сжимается "на лету" средствами библиотеки zlib.

Замечание: Обратите внимание: ресурсы наподобие дескрипторов файлов или подключений нельзя сохранять в кеше, поскольку ресурсы невозможно адекватно представить в сериализованном виде.

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

key
Ключ, с которым свяжется элемент.
var
Переменная, которую требуется сохранить. Строковые и числовые значения сохраняются как есть, а остальные типы сериализуются.
flag
При передаче флага MEMCACHE_COMPRESSED элемент сохраняется в сжатом виде. Модуль сжимает элемент средствами библиотеки zlib.
expire
Время жизни элемента. При передаче значения 0 элемент никогда не устаревает. Параметр также принимает метку времени Unix или число секунд, начиная с текущего момента, но тогда числу секунд нельзя превышать значение 2592000, что эквивалентно 30 дням.

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Примеры

Пример #1 Пример сохранения данных на сервере методом Memcache::set()

<?php

/* Процедурный API */

/* Подключение к серверу memcached */
$memcache_obj = memcache_connect('memcache_host', 11211);

/**
* Установка значения для элемента с ключом 'var_key'.
* При установке для параметра flag значения 0 элемент не сжимается.
* Временем жизни элемента составит 30 секунд
*/
memcache_set($memcache_obj, 'var_key', 'some variable', 0, 30);

echo memcache_get($memcache_obj, 'var_key');

?>

Пример #2 Пример сохранения данных на сервере методом Memcache::set()

<?php

/* Объектно-ориентированный API */

$memcache_obj = new Memcache();

/* Подключение к серверу memcached */
$memcache_obj->connect('memcache_host', 11211);

/**
* Установка значения для элемента с ключом 'var_key',
* активация сжатия "на лету" и установка времени жизни в 50 секунд
*/
$memcache_obj->set('var_key', 'some really big variable', MEMCACHE_COMPRESSED, 50);

echo $memcache_obj->get('var_key');

?>

Смотрите также