函數(shù)名稱：Memcached::addByKey() 

適用版本：PHP 5 >= 5.3.0, PECL memcached >= 0.1.0

函數(shù)描述： Memcached::addByKey() 方法用于向指定的服務(wù)器添加一個(gè)新的鍵值對(duì)，通過指定的鍵名和服務(wù)器的鍵值發(fā)生器來確定要將鍵值對(duì)存儲(chǔ)在哪個(gè)服務(wù)器上。

用法： bool Memcached::addByKey ( string $server_key , string $key , mixed $value [, int $expiration ] )

參數(shù)：

• $server_key：服務(wù)器的鍵值發(fā)生器，用于確定要將鍵值對(duì)存儲(chǔ)在哪個(gè)服務(wù)器上。
• $key：要添加的鍵名。
• $value：要添加的值。
• $expiration（可選）：鍵值對(duì)的過期時(shí)間（以秒為單位）。默認(rèn)值為0，表示永不過期。

返回值： 成功時(shí)返回 true，失敗時(shí)返回 false。

示例：

$memcached = new Memcached();
$memcached->addServer('localhost', 11211); // 添加服務(wù)器
$memcached->setOption(Memcached::OPT_BINARY_PROTOCOL, true); // 設(shè)置使用二進(jìn)制協(xié)議

$serverKey = 'server1'; // 服務(wù)器鍵值發(fā)生器
$key = 'my_key';
$value = 'my_value';
$expiration = 3600; // 1小時(shí)

$result = $memcached->addByKey($serverKey, $key, $value, $expiration);
if ($result) {
    echo 'Value added successfully.';
} else {
    echo 'Failed to add value.';
}

在上面的示例中，我們創(chuàng)建了一個(gè) Memcached 對(duì)象并添加了一個(gè)服務(wù)器。然后，我們使用 addByKey() 方法將一個(gè)鍵值對(duì)添加到指定的服務(wù)器上。如果添加成功，將輸出 "Value added successfully."，否則輸出 "Failed to add value."。