函式名稱:Memcached::increment() 適用版本:PHP >= 5.3.0
函式說明:Memcached::increment() 用於將指定鍵的值遞增一個特定的數值。如果鍵不存在,則會建立一個新的鍵,並將初始值設為0。
語法:mixed Memcached::increment(string $key [, int $offset = 1 [, int $initial_value = 0 [, int $expiry = 0 ]]])
引數:
- $key:要遞增的鍵名。
- $offset:遞增的數值,預設為1。
- $initial_value:如果鍵不存在,則設定初始值,預設為0。
- $expiry:鍵的過期時間,預設為0,表示不過期。
返回值:
- 成功時,返回遞增後的值。
- 失敗時,返回false。
示例程式碼:
// 建立一個Memcached物件
$memcached = new Memcached();
// 新增伺服器
$memcached->addServer('localhost', 11211);
// 設定鍵名和初始值
$key = 'counter';
$initial_value = 0;
// 判斷鍵是否存在
if (!$memcached->get($key)) {
// 如果鍵不存在,則設定初始值
$memcached->set($key, $initial_value);
}
// 遞增鍵的值
$new_value = $memcached->increment($key);
// 列印遞增後的值
echo "遞增後的值為:" . $new_value;
以上示例中,我們首先建立了一個Memcached物件,並新增了一個伺服器。然後,我們設定了一個鍵名和初始值。接下來,我們使用Memcached::get()
方法判斷鍵是否存在,如果不存在,則使用Memcached::set()
方法設定初始值。最後,我們使用Memcached::increment()
方法遞增鍵的值,並將遞增後的值列印出來。