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