Memcached::setByKey
(PECL memcached >= 0.1.0)
Memcached::setByKey — Сохраняет запись на указанном сервере
Описание
string
$server_key,string
$key,mixed
$value,int
$expiration = 0): bool
Memcached::setByKey() работает аналогично
Memcached::set(), за исключением того, что произвольный
server_key может быть использован для определения сервера и установки
значения с ключом key на конкретный сервер. Это полезно когда необходимо держать
несколько связанных значений на конкретном сервере.
Список параметров
-
server_key -
Ключ, идентифицирующий сервер, на котором хранится значение. Вместо хеширования по ключу самого элемента, при выборе подключаемого сервера memcached хешируют по ключу сервера. Такой метод разрешает группировать связанные элементы вместе на одном сервере, что повышает эффективность групповых операций.
-
key -
Ключ, под которым сохраняется значение.
-
value -
Сохраняемое значение.
-
expiration -
Время хранения объекта, по умолчанию равно 0. Для более подробной информации смотрите Время хранения объекта.
Возвращаемые значения
Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.
Используйте при необходимости Memcached::getResultCode().
Примеры
Пример #1 Пример использования Memcached::setByKey()
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
/* Хранение блоков IP адресов на определённом сервере */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>
add a note
