指定したサーバにアイテムを格納する

説明

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

Memcached::setByKey() は機能的に Memcached::set() と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバに関連付けることができます。これは、関連するキーを特定のサーバに置き続けたいときなどに便利です。

パラメータ

server_key: 値を格納するサーバを表すキー。
key: 値の格納先のキー。
value: 格納する値。
expiration: 期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限を参照ください。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。必要に応じて Memcached::getResultCode() を使用しましょう。

例

例1 Memcached::setByKey() の例


<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

/* IP ブロック情報を特定のサーバ上に保持します */
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>

参考

Memcached::set() - アイテムを格納する