PHP Conference Nagoya 2025

Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKeyStore an item on a specific server

Опис

public Memcached::setByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = 0
): bool

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);
?>

Прогляньте також

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top