= 0.1.0)Memcached::setByKey — 將元素存儲到指定的服務(wù)器上說明public Memcached::setByKey( string $server_key, string $key, ">

Memcached::setByKey

(PECL memcached >= 0.1.0)

Memcached::setByKey — 將元素存儲到指定的服務(wù)器上

說明

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

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

參數(shù)

server_key

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

key

用于存儲值的鍵名。

value

存儲的值。

expiration

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

返回值

成功時返回 true， 或者在失敗時返回 false。 如需要則使用 Memcached::getResultCode()。

范例

示例 #1 Memcached::setByKey() 示例

<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

/* 保證block-ip系列key的存儲在同一臺服務(wù)器上。*/
$m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
$m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
?>

參見