array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'memcached.setbykey.php', 1 => 'Memcached::setByKey', 2 => 'Сохраняет элемент на конкретном сервере', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.set.php', 1 => 'Memcached::set', ), 'next' => array ( 0 => 'memcached.setencodingkey.php', 1 => 'Memcached::setEncodingKey', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/memcached/memcached/setbykey.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKey — Сохраняет элемент на конкретном сервере

Описание

public 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);

?>

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