Memcached Memcached::get
(PECL memcached >= 0.1.0)
Memcached::get — 항목 검색
설명
public Memcached::get(string $key
, callable $cache_cb = ?, int $flags = ?): mixed
Memcached::get()은 이전에 key
아래에 저장된 항목을 반환합니다. 항목이 발견되고 flags
에 Memcached::GET_EXTENDED
가 지정되면 항목에 대한 CAS 토큰 값도 반환됩니다. CAS 토큰을 사용하는 방법은 Memcached::cas()를 참조하세요. Read-through caching callback은 cache_cb
매개변수를 통해 지정할 수 있습니다.
매개변수
key
- 검색할 항목의 키입니다.
cache_cb
- 연속 읽기 캐싱 콜백 또는
null
입니다. flags
- 반환된 결과를 제어하는 플래그입니다.
Memcached::GET_EXTENDED
가 제공되면 함수는 CAS 토큰도 반환합니다.
반환 값
캐시에 저장된 값을 반환하거나 그렇지 않으면 false
를 반환합니다. flags
가 Memcached::GET_EXTENDED
로 설정되면 값만 포함하는 대신 값과 CAS 토큰이 포함된 배열이 반환됩니다. 키가 존재하지 않는 경우 Memcached::getResultCode()는 Memcached::RES_NOTFOUND
를 반환합니다.
변경 로그
버전 | 설명 |
---|---|
PECL memcached 3.0.0 | &cas_token 매개변수가 제거되었습니다. 대신 flags 가 추가되었으며 Memcached::GET_EXTENDED 값이 지정되면 CAS 토큰을 가져올 수 있습니다. |
Examples
예제 #1 Memcached::get() 예제
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('foo', 100);
var_dump($m->get('foo'));
?>
위의 예는 다음을 출력합니다.
int(100)
예제 #2 Memcached::get() 예제
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
if (!($ip = $m->get('ip_block'))) {
if ($m->getResultCode() == Memcached::RES_NOTFOUND) {
$ip = array();
$m->set('ip_block', $ip);
} else {
/* log error */
/* ... */
}
}
?>
기타
- Memcached::getByKey() - 특정 서버에서 항목 검색
- Memcached::getMulti() - 여러 항목 검색
- Memcached::getDelayed() - 여러 항목 요청