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

Memcached::addByKey

(PECL memcached >= 0.1.0)

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

說(shuō)明

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

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

參數(shù)

server_key

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

key

用于存儲(chǔ)值的鍵名。

value

存儲(chǔ)的值。

expiration

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

返回值

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

參見