Добавляет элемент с заданным ключом

# Memcache::add

# memcache_add

(PECL memcache >= 0.2.0)

Memcache::add -- memcache_add — Добавляет элемент с заданным ключом

### Описание

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

Метод Memcache::add() записывает элемент `var` с ключом `key`, только если сервер ещё не содержит ключ.

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

`key`
  Ключ, с которым свяжется элемент.
`var`
  Переменная для сохранения. Строковые и числовые значения сохраняются как есть, а остальные типы сериализируются.
`flag`
  При передаче флага `MEMCACHE_COMPRESSED` элемент сохраняется в сжатом виде. Модуль сжимает элемент средствами библиотеки zlib.
`expire`
  Время жизни элемента. При передаче значения 0 элемент никогда не устаревает. Параметр также принимает метку времени 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() - Заменяет значение элемента кеша

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open