Memcached::deleteByKey

(PECL memcached >= 0.1.0)

Memcached::deleteByKey — Удаляет запись с указанного сервера

Описание

public Memcached::deleteByKey(string $server_key, string $key, int $time = 0): bool

Memcached::deleteByKey() работает аналогично Memcached::delete(), за исключением того, что произвольный server_key может быть использован для определения сервера и установки значения с ключом key на конкретный сервер.

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

server_key

Ключ, идентифицирующий сервер, на котором хранится значение. Вместо хеширования по ключу самого элемента, мы хешируем по ключу сервера при выборе подключаемого сервера memcached. Данный подход позволяет группировать связанные элементы вместе на одном сервере, что улучшает эффективность групповых операций.

key

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

time

Период времени, в течение которого сервер ожидает удаления записи.

Замечание: Начиная с версии memcached 1.3.0 (выпущена в 2009 году), функция больше не поддерживается. Передача ненулевого параметра time приведёт к возникновению ошибки при удалении. Метод Memcached::getResultCode() вернёт MEMCACHED_INVALID_ARGUMENTS.

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

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки. Метод Memcached::getResultCode() возвращает Memcached::RES_NOTFOUND если указанный ключ не существует.

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