Memcached::incrementByKey()函式—用法及示例

函式名：Memcached::incrementByKey()

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

用法：Memcached::incrementByKey() 函式用於透過指定的鍵值對鍵增加一個數值。該函式只會在快取中存在指定的鍵時生效。

語法：bool Memcached::incrementByKey ( 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); // 新增 Memcached 伺服器

$key = 'counter';
$server_key = 'server1';

// 增加鍵值對的值
$value = $memcached->incrementByKey($server_key, $key, 5);

if ($value !== false) {
    echo "增加成功，新的值為：$value";
} else {
    echo "增加失敗";
}

在上面的示例中，我們建立了一個 Memcached 物件，並新增了一個 Memcached 伺服器。然後，我們使用 incrementByKey() 函式透過指定的鍵名和伺服器鍵增加了一個數值。如果增加成功，則輸出新的值；如果增加失敗，則輸出錯誤資訊。

注意：在使用 incrementByKey() 函式之前，確保已經安裝了 Memcached 擴充套件，並且伺服器已經啟動和配置正確。