Memcached Memcached::addByKey
(PECL memcached >= 0.1.0)
Memcached::addByKey — 특정 서버의 새 키 아래에 항목 추가
설명
public Memcached::addByKey( string $server_key, string $key, mixed $value, int $expiration = ? ): bool
Memcached::addByKey()는 자유 형식 server_key
를 사용하여 key
를 특정 서버에 매핑할 수 있다는 점을 제외하면 Memcached::add()와 기능적으로 동일합니다. 특정 서버에 관련 키를 많이 보관해야 하는 경우에 유용합니다.
매개변수
server_key
- 값을 저장하거나 검색할 서버를 식별하는 키입니다. 항목에 대한 실제 키를 해싱하는 대신 통신할 memcached 서버를 결정할 때 서버 키를 해싱합니다. 이를 통해 관련 항목을 단일 서버에서 함께 그룹화하여 다중 작업의 효율성을 높일 수 있습니다.
key
- 값을 저장할 키입니다.
value
- 저장할 값입니다.
expiration
- 만료 시간, 기본값은 0입니다. 자세한 내용은 Expiration Times을 참조하세요.
반환 값
성공하면 true
를, 실패하면 false
를 반환합니다. 키가 이미 있는 경우 Memcached::getResultCode()는 Memcached::RES_NOTSTORED
를 반환합니다.
기타
- Memcached::add() - 새 키 아래에 항목 추가
- Memcached::set() - 항목 저장
- Memcached::replace() - 기존 키 아래 항목 바꾸기