Memcached::increment

    (PECL memcached >= 0.1.0)

    Memcached::increment — Увеличивает числовое значение записи

    Описание

    publicMemcached::increment(
        string$key,
        int$offset = 1,
        int$initial_value = 0,
        int$expiry = 0
    ): int|false

    Memcached::increment() увеличивает числовое значение записи на величину, указанную в параметре offset. Если запись содержит не числовое значение, то будет возвращена ошибка. Метод Memcached::increment() установит записи значение, переданное в initial_value, если записи с указанным ключом не существует.

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

    key

    Ключ увеличиваемой записи.

    offset

    Величина на которую происходит увеличение значения записи.

    initial_value

    Инициирующее значение, которое будет установлено записи, если переданного ключа не существует.

    expiry

    Время, когда срок действия записи истекает.

    Возвращаемые значения

    Возвращает новое значение записи в случае успешного выполнения или false, если возникла ошибка.

    Примеры

    Пример #1 Пример использования Memcached::increment()

    <?php
    $m     = new Memcached();
    $m->addServer('localhost', 11211);

    $m->set('counter', 0);
    $m->increment('counter');
    $n = $m->increment('counter', 10);
    var_dump($n);

    $m->set('counter', 'abc');
    $n = $m->increment('counter');
    // Завершится неудачей т.к. значение записи не является числовым
    var_dump($n);
    ?>

    Результат выполнения приведённого примера: 

    int(11) bool(false)

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

    • Memcached::decrement() - Уменьшает числовое значение записи
    • Memcached::decrementByKey() - Уменьшает числовое значение записи, хранящееся на определённом сервере
    • Memcached::incrementByKey() - Увеличивает числовое значение записи, хранимой на указанном сервере
    To Top