Memcached::append

(PECL memcached >= 0.1.0)

Memcached::append — Добавляет данные к существующей записи

Описание

public Memcached::append(string $key, string $value): ?bool

Метод Memcached::append() добавляет к существующей записи строку, которую передали в аргументе value. Причина, по которой значение value приводится к строке, состоит в неопределённости добавления смешанных типов.

Замечание:

При установке параметра Memcached::OPT_COMPRESSION операция завершается ошибкой и выводится предупреждение, потому что добавление сжатых данных к записи, которую уже сжали, невозможно.

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

key

Ключ, под которым сохраняется значение.

value

Строка, которую требуется добавить.

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка. Метод возвращает null, если сжатие включено.

Ошибки

Метод возвращает null и выдаёт ошибку уровня E_WARNING, если сжатие включено.

Примеры

Пример #1 Пример добавления данных методом Memcached::append()

<?php

$m = new Memcached();
$m->addServer('localhost', 11211);
$m->setOption(Memcached::OPT_COMPRESSION, false);

$m->set('foo', 'abc');
$m->append('foo', 'def');

var_dump($m->get('foo'));

?>

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

string(6) "abcdef"

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

  • Memcached::appendByKey() - Добавляет данные к существующей записи на заданном сервере
  • Memcached::prepend() - Добавляет данные в начало существующей записи