= 0.1.0)Memcached::addByKey — 在指定服務器上的一個新的key下增加一個元素說明public Memcached::addByKey( string $server_key, string">

Memcached::addByKey

(PECL memcached >= 0.1.0)

Memcached::addByKey — 在指定服務器上的一個新的key下增加一個元素

說明

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

Memcached::addByKey()在功能上等同于Memcached::add()， 不過這種方式可以自由的指定server_key用于將key 映射到特定的服務器。這在你需要將一些相關(guān)聯(lián)的key保存在一個特定的服務器時非常有用。(譯注: $server_key也是一個普通的key, *ByKey系列接口的工作過程是: 首先, 對$server_key進行hash, 得到$server_key應該存儲的服務器, 然后將相應的操作在 $server_key所在的服務器上進行.)

參數(shù)

server_key

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

key

用于存儲值的鍵名。

value

存儲的值。

expiration

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

返回值

成功時返回 true， 或者在失敗時返回 false。 如果key已經(jīng)存在，Memcached::getResultCode()方法將會返回Memcached::RES_NOTSTORED。

參見