wincache_ucache_set
(PECL wincache >= 1.1.0)
wincache_ucache_set — 사용자 캐시에 변수를 추가하고 변수가 이미 캐시에 있는 경우 덮어씁니다.
설명
wincache_ucache_set(mixed $key
, mixed $value
, int $ttl
= 0): bool
wincache_ucache_set(array $value
, mixed $unused
= NULL, int $ttl
= 0): bool
사용자 캐시에 변수를 추가합니다. 캐시에 이미 존재하는 변수를 덮어씁니다. 추가되거나 업데이트된 변수는 TTL이 만료되거나 wincache_ucache_delete() 또는 wincache_ucache_clear() 함수를 사용하여 삭제되지 않는 한 사용자 캐시에 남아 있습니다.
매개변수
key
- 이
key
이름을 사용하여 변수를 저장합니다. 동일한key
를 가진 변수가 이미 있는 경우 함수는 이전 값을 새 값으로 덮어씁니다.key
는 대소문자를 구분합니다.key
는 이름이 키로 사용되는 name => 값 쌍의 배열을 사용할 수도 있습니다. 이것은 한 작업에서 캐시에 여러 값을 추가하는 데 사용할 수 있으므로 경쟁 조건을 피할 수 있습니다. value
- 저장할 변수의 값입니다.
value
는 파일 핸들과 같은 리소스를 제외한 모든 데이터 유형을 지원합니다. 첫 번째 인수가 배열인 경우 이 매개변수는 무시됩니다. 일반적인 지침은 배열을 키로 사용하는 동안null
을value
으로 전달하는 것입니다.value
가 객체이거나 객체를 포함하는 배열이면 객체가 직렬화됩니다. 객체 직렬화에 대한 자세한 내용은 __sleep()을 참조하세요. values
- 키와 값의 연관 배열입니다.
ttl
- 변수가 캐시에 있는 시간(초)입니다.
ttl
에 지정된 값이 전달된 후 저장된 변수는 캐시에서 삭제됩니다. 이 매개변수는 기본값0
을 사용합니다. 이는 wincache_ucache_delete() 또는 wincache_ucache_clear() 함수를 사용하여 명시적으로 삭제하지 않는 한 변수가 캐시에 남아 있음을 의미합니다.
반환 값
key
가 문자열이면 함수는 성공하면 true
를, 실패하면 false
를 반환합니다.
key
가 배열인 경우 함수는 다음을 반환합니다.
- 배열의 모든 이름 => 값 쌍을 설정할 수 있는 경우 함수는 빈 배열을 반환합니다.
- 배열의 모든 이름 => 값 쌍을 설정할 수 없는 경우 함수는
false
를 반환합니다. - 일부는 설정할 수 있지만 나머지는 설정할 수 없는 경우 함수는 사용자 캐시에서 추가에 실패한 이름=>값 쌍의 배열을 반환합니다.
Examples
예제 #1 key
를 문자열로 사용하는 wincache_ucache_set()
<?php
$bar = 'BAR';
var_dump(wincache_ucache_set('foo', $bar));
var_dump(wincache_ucache_get('foo'));
$bar1 = 'BAR1';
var_dump(wincache_ucache_set('foo', $bar1));
var_dump(wincache_ucache_get('foo'));
?>
위의 예는 다음을 출력합니다.
bool(true) string(3) "BAR" bool(true) string(3) "BAR1"
예제 #2 key
를 배열로 사용하는 wincache_ucache_set()
<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_set($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>
위의 예는 다음을 출력합니다.
array(0) {} array(0) {} string(1) "6"
기타
- wincache_ucache_add() - 변수가 캐시에 아직 존재하지 않는 경우에만 사용자 캐시에 변수를 추가합니다.
- wincache_ucache_get() - 사용자 캐시에 저장된 변수를 가져옵니다.
- wincache_ucache_delete() - 사용자 캐시에서 변수 삭제
- wincache_ucache_clear() - 사용자 캐시의 전체 내용을 삭제합니다.
- wincache_ucache_exists() - 사용자 캐시에 변수가 있는지 확인
- wincache_ucache_meminfo() - 사용자 캐시 메모리 사용량에 대한 정보 검색
- wincache_ucache_info() - 사용자 캐시에 저장된 데이터에 대한 정보 검색
- __sleep()