Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — 指定したサーバーにアイテムを新しいキーで追加する
説明
public Memcached::addByKey(
string
string
mixed
int
): bool
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
User Contributed Notes
There are no user contributed notes for this page.
