Заменяет существующую запись с заданным ключом на указанном сервере

# Memcached::replaceByKey

(PECL memcached >= 0.1.0)

Memcached::replaceByKey — Заменяет существующую запись с заданным ключом на указанном сервере

### Описание

public function Memcached::replaceByKey(
string `$server_key`,
string `$key`,
mixed `$value`,
int `$expiration` = 0
): 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() - Добавляет элемент с новым ключом

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open