Memcached::addByKey
指定したサーバーにアイテムを新しいキーで追加する
説明
public bool Memcached::addByKey(
string $server_key,
string $key,
mixed $value,
int $expiration = 0
)
パラメータ
-
server_key
-
値を格納したりデータを取得したりするサーバーを表すキー。
アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。
これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
-
key
-
値の格納先のキー。
-
value
-
格納する値。
-
expiration
-
期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。
戻り値
成功した場合に true を、失敗した場合に false を返します。
キーが既に存在する場合は、 Memcached::getResultCode は
Memcached::RES_NOTSTORED を返します。
参考
- Memcached::add
- Memcached::set
- Memcached::replace