Memcached Memcached::increment
(PECL memcached >= 0.1.0)
Memcached::increment — 숫자 항목의 값 증가
설명
public Memcached::increment( string $key, int $offset = 1, int $initial_value = 0, int $expiry = 0 ): int|false
Memcached::increment()는 지정된 offset
만큼 숫자 항목의 값을 증가시킵니다. 항목의 값이 숫자가 아니면 오류가 발생합니다. 키가 존재하지 않는 경우 Memcached::increment()는 항목을 initial_value
매개변수로 설정합니다.
매개변수
key
- 증가할 항목의 키입니다.
offset
- 항목의 값을 증가시키는 양입니다.
initial_value
- 항목이 현재 존재하지 않는 경우 설정할 값입니다.
expiry
- 항목에 설정할 만료 시간입니다.
반환 값
성공하면 새 항목의 값을 반환하고 실패하면 false
를 반환합니다.
Examples
예제 #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');
// ^ will fail due to item value not being numeric
var_dump($n);
?>
위의 예는 다음을 출력합니다.
int(11) bool(false)
기타
- Memcached::decrement() - 숫자 항목 값 감소
- Memcached::decrementByKey() - 특정 서버에 저장된 숫자 항목의 값 감소
- Memcached::incrementByKey() - 특정 서버에 저장된 숫자 항목의 값 증가