(PECL memcached >= 0.1.0)
Memcached::deleteByKey — 從特定伺服器刪除項目
Memcached::deleteByKey() 的功能與 Memcached::delete() 相同,不同之處在於可以使用自由格式的 server_key 將 key 對應到特定伺服器。
server_key用於識別儲存或擷取值的伺服器的鍵值。我們在決定要與哪個 memcached 伺服器通訊時,會對伺服器鍵值進行雜湊,而不是對項目的實際鍵值進行雜湊。這允許相關的項目被群組在單個伺服器上,以提高多個操作的效率。
鍵值(key)要刪除的鍵值。
時間(time)伺服器等待刪除項目時間的長度。
注意:從 memcached 1.3.0 版(2009 年發布)開始,不再支援此功能。傳遞非零的
time參數將導致刪除失敗。Memcached::getResultCode() 將返回MEMCACHED_INVALID_ARGUMENTS。
成功時傳回 true,失敗時傳回 false。如果鍵值不存在,Memcached::getResultCode() 將傳回 Memcached::RES_NOTFOUND。