= 0.1.0)Memcached::replaceByKey — Replace the item under an existing key on a specific server說明public Memcache">

Memcached::replaceByKey

(PECL memcached >= 0.1.0)

Memcached::replaceByKeyReplace the item under an existing key on a specific server

說明

public Memcached::replaceByKey(
    string $server_key,
    string $key,
    mixed $value,
    int $expiration = ?
): bool

除了可以使用server_key自由的將key映射到指定服務器外, Memcached::replaceByKey()在功能上等同于Memcached::replace()。 (譯注: 關于*ByKey系列方法及$server_key的工作原理請參照addByKey方法文檔)。

參數

server_key

本鍵名用于識別儲存和讀取值的服務器。沒有將實際的鍵名散列到具體的項目,而是在決定與哪一個 memcached 服務器通信時將其散列為服務器鍵名。這使得關聯(lián)的項目在單一的服務上被組合起來以提高多重操作的效率。

key

用于存儲值的鍵名。

value

存儲的值。

expiration

到期時間,默認為 0。 更多信息請參見到期時間

返回值

成功時返回 true, 或者在失敗時返回 false。 如果key不存在,Memcached::getResultCode()返回Memcached::RES_NOTSTORED。

參見