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。最後，我們根據返回結果判斷操作是否成功，並輸出遞減後的值。