Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — Добавляет новый элемент на заданный сервер
Описание
string
$server_key,string
$key,mixed
$value,int
$expiration = 0): 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() - Заменяет существующую запись с указанным ключом
add a note
