函數(shù)名：Memcached::add()

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

用法：Memcached::add() 方法用于向 Memcached 服務(wù)器添加一個新的鍵值對，但只有在該鍵不存在的情況下才會添加成功。如果鍵已經(jīng)存在，則添加操作將失敗并返回 false。

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

參數(shù)：

• key：要添加的鍵名。
• value：要添加的值。
• expiration（可選）：過期時間，以秒為單位。默認(rèn)為0，表示不過期。

返回值：如果添加成功，返回 true；如果鍵已經(jīng)存在，返回 false。

示例：

// 創(chuàng)建一個 Memcached 對象
$memcached = new Memcached();

// 連接到 Memcached 服務(wù)器
$memcached->addServer('localhost', 11211);

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

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

在上面的示例中，我們首先創(chuàng)建了一個 Memcached 對象，并使用 addServer() 方法連接到 Memcached 服務(wù)器。然后，我們使用 add() 方法嘗試向服務(wù)器添加一個新的鍵值對。如果添加成功，我們將輸出"Key added successfully"，否則將輸出"Key already exists"。