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

Memcached::setByKey

(PECL memcached >= 0.1.0)

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

說(shuō)明

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的工作原理請(qǐng)參照addByKey方法文檔)。

參數(shù)

server_key

本鍵名用于識(shí)別儲(chǔ)存和讀取值的服務(wù)器。沒(méi)有將實(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)參見(jiàn)到期時(shí)間。

返回值

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。 如需要?jiǎng)t使用 Memcached::getResultCode()。

范例

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

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

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

參見(jiàn)