Memcache::add
(PECL memcache >= 0.2.0)
Memcache::add — Добавить элемент с указанным ключем
Описание
Memcache::add() записывает элемент
var с указанным ключем key только
если указанный ключ еще не существует на сервере.
Также вы можете использовать функцию memcache_add().
Список параметров
-
key -
Ключ, с которым будет связан элемент.
-
var -
Переменная для сохранения. Строковые и числовые значения сохраняются как есть, а остальные типы сериализируются.
-
flag -
Используйте
MEMCACHE_COMPRESSEDдля записи элемента со сжатием (используется zlib). -
expire -
Время жизни элемента. Если равно нулю, элемент никогда не устаревает. Также вы можете использовать метку времени Unix или число секунд, начиная с текущего момента, однако, в этом случае число секунд не может быть больше 2592000 (30 дней).
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Возвращает false, если такой ключ уже существует. В остальных случаях поведение
Memcache::add() аналогично Memcache::set().
Примеры
Пример #1 Пример использования Memcache::add()
<?php
$memcache_obj = memcache_connect("localhost", 11211);
/* процедурное API */
memcache_add($memcache_obj, 'var_key', 'test variable', false, 30);
/* объектно-ориентированное API */
$memcache_obj->add('var_key', 'test variable', false, 30);
?>
Смотрите также
- Memcache::set() - Сохранить данные на сервере
- Memcache::replace() - Заменить значение существующего элемента