[函数]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"。