array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'memcached.addbykey.php', 1 => 'Memcached::addByKey', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.add.php', 1 => 'Memcached::add', ), 'next' => array ( 0 => 'memcached.addserver.php', 1 => 'Memcached::addServer', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/memcached/memcached/addbykey.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL memcached >= 0.1.0)
Memcached::addByKey — 指定したサーバーにアイテムを新しいキーで追加する
$server_key
,$key
,$value
,$expiration
= 0
Memcached::addByKey() は機能的に
Memcached::add() と同等です。しかし、自由形式の
server_key
を使用して、
key
を特定のサーバーに関連付けることができます。
これは、関連するキーを特定のサーバーに置き続けたいときなどに便利です。
server_key
値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。
key
値の格納先のキー。
value
格納する値。
expiration
期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。
成功した場合に true
を、失敗した場合に false
を返します。
キーが既に存在する場合は、Memcached::getResultCode() は
Memcached::RES_NOTSTORED
を返します。