(PECL memcached >= 0.1.0)
Memcached::setByKey — Store an item on a specific server
$server_key
, string $key
, mixed $value
[, int $expiration
] )
Memcached::setByKey() is functionally equivalent to
Memcached::set(), except that the free-form
server_key can be used to map the
key to a specific server. This is useful if you need
to keep a bunch of related keys on a certain server.
server_keyКлюч, идентифицирующий сервер, на котором хранится значение. Вместо хэширования по ключу самого элемента, мы хэшируем по ключу сервера при выборе подключаемого сервера memcached. Данный подход позволяет группировать связанные элементы вместе на одном сервере, что улучшает эффективность групповых операций.
keyКлюч, под которым сохраняется значение.
valueСохраняемое значение.
expirationВремя хранения объекта, по умолчанию равно 0. Для более подробной информации смотрите Время хранения объекта.
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Используйте при необходимости Memcached::getResultCode().
Пример #1 Memcached::setByKey() example
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
/* keep IP blocks on a certain server */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>