[函数]Memcached::set()函数—用法及示例

函数名称：Memcached::set()

适用版本：该函数适用于所有 PHP 版本，但要求安装了 Memcached 扩展。

函数描述：Memcached::set() 函数用于将一个键值对存储到 Memcached 服务器中。如果键已经存在，则会覆盖旧的值。

用法：

$memcached = new Memcached();
$memcached->addServer('localhost', 11211);

$key = 'my_key';
$value = 'my_value';
$expiration = 3600; // 过期时间，单位为秒

$result = $memcached->set($key, $value, $expiration);
if ($result) {
    echo 'Value stored successfully.';
} else {
    echo 'Failed to store value.';
}

参数：

1. key：要存储的键名，必须为字符串类型。
2. value：要存储的值，可以是任意类型。
3. expiration：过期时间，可选参数，默认为 0，表示永不过期。如果设置了过期时间，Memcached 会在该时间后自动删除该键值对。

返回值：

• 成功时返回 true。
• 失败时返回 false。

示例解释： 以上示例中，首先创建了一个 Memcached 对象，并添加了 Memcached 服务器的地址和端口。然后，定义了要存储的键名和对应的值。最后，调用 Memcached::set() 函数将键值对存储到 Memcached 服务器中，并根据返回值判断存储是否成功。如果成功，则输出"Value stored successfully."；如果失败，则输出"Failed to store value."。

注意事项：

• 在使用 Memcached::set() 函数之前，需要确保已经安装了 Memcached 扩展，并且 Memcached 服务器在运行状态。
• 如果要存储的值是对象或数组，会自动进行序列化。在获取值时，需要进行反序列化操作。
• 如果存储的键已经存在，Memcached::set() 函数会覆盖旧的值。如果不希望覆盖旧值，可以使用 Memcached::add() 函数。
• 如果存储的键不存在，使用 Memcached::set() 函数会创建新的键值对。如果希望仅在键不存在时才创建新的键值对，可以使用 Memcached::add() 函数。