Memcache::add

(PECL memcache >= 0.2.0)

Memcache::addДобавить элемент с указанным ключем

Описание

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

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

/* объектно-ориентированное API */
$memcache_obj->add('var_key''test variable'false30);

?>

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

  • Memcache::set() - Сохранить данные на сервере
  • Memcache::replace() - Заменить значение существующего элемента