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