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', false, 30);

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

?>

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

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