Memcache::add

memcache_add

(PECL memcache >= 0.2.0)

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

Описание

Memcache::add(
    string $key,
    mixed $var,
    int $flag = ?,
    int $expire = ?
): bool
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);

?>

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