Memcached::addByKey()函式—用法及示例

函式名稱：Memcached::addByKey() 

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

函式描述： Memcached::addByKey() 方法用於向指定的伺服器新增一個新的鍵值對，透過指定的鍵名和伺服器的鍵值發生器來確定要將鍵值對儲存在哪個伺服器上。

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

引數：

• $server_key：伺服器的鍵值發生器，用於確定要將鍵值對儲存在哪個伺服器上。
• $key：要新增的鍵名。
• $value：要新增的值。
• $expiration（可選）：鍵值對的過期時間（以秒為單位）。預設值為0，表示永不過期。

返回值： 成功時返回 true，失敗時返回 false。

示例：

$memcached = new Memcached();
$memcached->addServer('localhost', 11211); // 新增伺服器
$memcached->setOption(Memcached::OPT_BINARY_PROTOCOL, true); // 設定使用二進位制協議

$serverKey = 'server1'; // 伺服器鍵值發生器
$key = 'my_key';
$value = 'my_value';
$expiration = 3600; // 1小時

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

在上面的示例中，我們建立了一個 Memcached 物件並新增了一個伺服器。然後，我們使用 addByKey() 方法將一個鍵值對新增到指定的伺服器上。如果新增成功，將輸出 "Value added successfully."，否則輸出 "Failed to add value."。