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

函式名：Memcached::add()

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

用法：Memcached::add() 方法用於向 Memcached 伺服器新增一個新的鍵值對，但只有在該鍵不存在的情況下才會新增成功。如果鍵已經存在，則新增操作將失敗並返回 false。

語法：bool Memcached::add ( string $key , mixed $value [, int $expiration = 0 ] )

引數：

• key：要新增的鍵名。
• value：要新增的值。
• expiration（可選）：過期時間，以秒為單位。預設為0，表示不過期。

返回值：如果新增成功，返回 true；如果鍵已經存在，返回 false。

示例：

// 建立一個 Memcached 物件
$memcached = new Memcached();

// 連線到 Memcached 伺服器
$memcached->addServer('localhost', 11211);

// 新增一個新的鍵值對
$result = $memcached->add('my_key', 'my_value');

if ($result) {
    echo 'Key added successfully';
} else {
    echo 'Key already exists';
}

在上面的示例中，我們首先建立了一個 Memcached 物件，並使用 addServer() 方法連線到 Memcached 伺服器。然後，我們使用 add() 方法嘗試向伺服器新增一個新的鍵值對。如果新增成功，我們將輸出"Key added successfully"，否則將輸出"Key already exists"。