Memcached::decrementByKey()函数—用法及示例

函数：Memcached::decrementByKey()

适用版本：PHP 5 >= 5.4.0, PHP 7, PECL memcached >= 0.1.0

用法：Memcached::decrementByKey() 函数用于通过指定的键减小存储在 Memcached 服务器中的一个数字值。该函数是通过指定键和递减量来操作的。

语法：bool Memcached::decrementByKey ( string $server_key , string $key [, int $offset = 1 [, int &$initial_value [, int $expiry = 0 ]]] )

参数：

• server_key: 用于确定服务器的键。如果未指定，将使用默认服务器。
• key: 要递减的值的键名。
• offset: 要递减的量。默认值为 1。
• initial_value: 如果键不存在，将使用初始值。默认值为 0。
• expiry: 指定存储的过期时间。默认值为 0，表示永不过期。

返回值：成功时返回递减后的值，失败时返回 false。

示例：

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

$serverKey = "server1";
$key = "counter";

// 设置初始值为 10
$memcached->setByKey($serverKey, $key, 10);

// 将值递减 2
$result = $memcached->decrementByKey($serverKey, $key, 2);

if ($result !== false) {
    echo "递减后的值为: " . $result;
} else {
    echo "递减操作失败";
}

上述示例中，我们首先创建了一个 Memcached 实例，并添加了一个服务器。然后，我们使用 setByKey() 函数设置了一个初始值为 10 的计数器。接下来，我们使用 decrementByKey() 函数将计数器的值递减了 2。最后，我们根据返回结果判断操作是否成功，并输出递减后的值。