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

Memcached::addByKey

(PECL memcached >= 0.1.0)

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

說明

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

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

參數(shù)

server_key

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

key

用于存儲值的鍵名。

value

存儲的值。

expiration

到期時間，默認(rèn)為 0。 更多信息請參見到期時間。

返回值

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

參見