(PECL memcached >= 0.1.0)
Memcached::setByKey — 在特定伺服器上儲存項目
Memcached::setByKey() 的功能與 Memcached::set() 相同,差別在於它可以使用自訂的 server_key 將 key 映射到特定的伺服器。如果您需要將一堆相關的鍵值儲存在特定伺服器上,這個功能會很有用。
server_key用於識別儲存或擷取值的伺服器的鍵值。我們在決定要與哪個 memcached 伺服器通訊時,會根據這個 server key 進行雜湊,而不是根據實際的 item 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);
?>