php8.5
Home/ Manual/ memcached / memcached/ Memcached::setByKey

Memcached::setByKey

PHP function Edit on GitHub ✎

(PECL memcached >= 0.1.0)

Store an item on a specific server

Description

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.

Parameters

server_key

Server_key

key

Key

value

Value

expiration

Expiration

Return Values

Success Getresultcode

Examples

Memcached::setByKey() example

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

See Also

  • Memcached::set

Source: reference/memcached/memcached/setbykey.xml · from the official PHP manual (php/doc-en)