(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);
?>