Memcached Memcached::decrementByKey
(PECL memcached >= 2.0.0)
Memcached::decrementByKey — 특정 서버에 저장된 숫자 항목의 값 감소
설명
public Memcached::decrementByKey( string $server_key, string $key, int $offset = 1, int $initial_value = 0, int $expiry = 0 ): int|false
Memcached::decrementByKey()는 숫자 항목의 값을 지정된 offset
만큼 감소시킵니다. 항목의 값이 숫자가 아니면 오류가 발생합니다. 작업으로 값이 0 미만으로 감소하면 새 값은 0이 됩니다. Memcached::decrementByKey()는 키가 존재하지 않는 경우 항목을 initial_value
매개변수로 설정합니다.
매개변수
server_key
- 값을 저장하거나 검색할 서버를 식별하는 키입니다. 항목에 대한 실제 키를 해싱하는 대신 통신할 memcached 서버를 결정할 때 서버 키를 해싱합니다. 이를 통해 관련 항목을 단일 서버에서 함께 그룹화하여 다중 작업의 효율성을 높일 수 있습니다.
key
- 감소할 항목의 키입니다.
offset
- 항목의 값을 감소시킬 양입니다.
initial_value
- 항목이 현재 존재하지 않는 경우 설정할 값입니다.
expiry
- 항목에 설정할 만료 시간입니다.
반환 값
성공하면 항목의 새 값을 반환하고 실패하면 false
를 반환합니다.
기타
- Memcached::decrement() - 숫자 항목 값 감소
- Memcached::increment() - 숫자 항목의 값 증가
- Memcached::incrementByKey() - 특정 서버에 저장된 숫자 항목의 값 증가