Memcached::setByKey
(PECL memcached >= 0.1.0)
Memcached::setByKey — Store an item on a specific server
Description
public bool Memcached::setByKey
( string $server_key
, string $key
, mixed $value
[, int $expiration
] )
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
-
The key identifying the server to store the value on.
- key
-
The key under which to store the value.
- value
-
The value to store.
- expiration
-
The expiration time, defaults to 0. See Expiration Times for more info.
Return Values
Returns TRUE on success or FALSE on failure. Use Memcached::getResultCode() if necessary.
Examples
Example #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);
?>