(PECL memcached >= 0.1.0)
Memcached::increment — 数値アイテムの値を増やす
$key,$offset = 1,$initial_value = 0,$expiry = 0
Memcached::increment() は、数値アイテムの値を
offset で指定しただけ増やします。
アイテムの値が数値でない場合はエラーとなります。
アイテムが存在しない場合、Memcached::increment() は値を
initial_value に設定します。
key増やしたいアイテムのキー。
offset値を増やしたい量。
initial_valueそのアイテムが存在しない場合に設定する値。
expiryそのアイテムに設定する有効期限。
成功した場合にアイテムの新しい値、失敗した場合に false を返します。
例1 Memcached::increment() の例
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('counter', 0);
$m->increment('counter');
$n = $m->increment('counter', 10);
var_dump($n);
$m->set('counter', 'abc');
$n = $m->increment('counter');
// アイテムの値が数値でないので、これは失敗します
var_dump($n);
?>上の例の出力は以下となります。
int(11) bool(false)
Spent a long time frustrated with this. If you read the patch notes carefully:
- Make increment/decrement initialize value when it is not available (when using binary protocol).
If you dont have the opt binary protocol set the arguments for initial value just return an error 38 - INVALID ARGUMENTS. This is not documented.