Memcached::replaceByKey
(PECL memcached >= 0.1.0)
Memcached::replaceByKey — Заменяет существующую запись с заданным ключом на указанном сервере
Описание
$server_key
, string $key
, mixed $value
, int $expiration = ?
) : bool
Memcached::replaceByKey() работает аналогично
Memcached::replace(), за исключением того, что произвольный
server_key может быть использован для определения сервера и установки
значения с ключом key на конкретный сервер. Это полезно когда необходимо держать
несколько связанных значений на конкретном сервере.
Список параметров
-
server_key -
Ключ, идентифицирующий сервер, на котором хранится значение. Вместо хэширования по ключу самого элемента, мы хэшируем по ключу сервера при выборе подключаемого сервера memcached. Данный подход позволяет группировать связанные элементы вместе на одном сервере, что улучшает эффективность групповых операций.
-
key -
Ключ, под которым сохраняется значение.
-
value -
Сохраняемое значение.
-
expiration -
Время хранения объекта, по умолчанию равно 0. Для более подробной информации смотрите Время хранения объекта.
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Метод Memcached::getResultCode() возвращает
Memcached::RES_NOTSTORED если указанного ключа не существует.
Смотрите также
- Memcached::replace() - Заменяет существующую запись с указанным ключом
- Memcached::set() - Сохраняет запись
- Memcached::add() - Добавляет элемент с новым ключом