wincache_ucache_add

WinCache 함수

(PECL wincache >= 1.1.0)

wincache_ucache_add — 변수가 캐시에 아직 존재하지 않는 경우에만 사용자 캐시에 변수를 추가합니다.


설명

wincache_ucache_add(string $key, mixed $value, int $ttl = 0): bool

파일 캐시 콘텐츠 및 사용에 대한 정보를 검색합니다.

wincache_ucache_add(array $values, mixed $unused = NULL, int $ttl = 0): bool

이 변수가 캐시에 이미 존재하지 않는 경우에만 사용자 캐시에 변수를 추가합니다. 추가된 변수는 TTL이 만료되거나 wincache_ucache_delete() 또는 wincache_ucache_clear() 함수를 사용하여 삭제되지 않는 한 사용자 캐시에 남아 있습니다.


매개변수
key
이 key 이름을 사용하여 변수를 저장합니다. 동일한 키를 가진 변수가 이미 있는 경우 함수는 실패하고 false를 반환합니다. key는 대소문자를 구분합니다. 키가 있는 경우에도 값을 재정의하려면 instad에서 wincache_ucache_set() 함수를 사용하십시오. key는 이름이 키로 사용되는 name => 값 쌍의 배열을 사용할 수도 있습니다. 이것은 한 작업에서 캐시에 여러 값을 추가하는 데 사용할 수 있으므로 경쟁 조건을 피할 수 있습니다.
value
저장할 변수의 값입니다. value은 파일 핸들과 같은 리소스를 제외한 모든 데이터 유형을 지원합니다. 첫 번째 인수가 배열인 경우 이 매개변수는 무시됩니다. 일반적인 지침은 배열을 key로 사용하는 동안 null을 value으로 전달하는 것입니다. value이 객체이거나 객체를 포함하는 배열이면 객체가 직렬화됩니다. 객체 직렬화에 대한 자세한 내용은 __sleep()을 참조하세요.
values
키와 값의 연관 배열입니다.
ttl
변수가 캐시에 있는 시간(초)입니다. ttl에 지정된 값이 전달된 후 저장된 변수는 캐시에서 삭제됩니다. 이 매개변수는 기본값 0을 사용합니다. 이는 wincache_ucache_delete() 또는 wincache_ucache_clear() 함수를 사용하여 명시적으로 삭제하지 않는 한 변수가 캐시에 남아 있음을 의미합니다.

반환 값

key가 문자열이면 함수는 성공하면 true를, 실패하면 false를 반환합니다.

key가 배열인 경우 함수는 다음을 반환합니다.

  • 배열의 모든 이름 => 값 쌍을 설정할 수 있는 경우 함수는 빈 배열을 반환합니다.
  • 배열의 모든 이름 => 값 쌍을 설정할 수 없는 경우 함수는 false를 반환합니다.
  • 일부는 설정할 수 있지만 나머지는 설정할 수 없는 경우 함수는 사용자 캐시에서 추가에 실패한 이름=>값 쌍의 배열을 반환합니다.

Examples

예제 #1 key를 문자열로 사용하는 wincache_ucache_add()

                  
<?php
$bar = 'BAR';
var_dump(wincache_ucache_add('foo', $bar));
var_dump(wincache_ucache_add('foo', $bar));
var_dump(wincache_ucache_get('foo'));
?>

위의 예는 다음을 출력합니다.

bool(true)
bool(false)
string(3) "BAR"

예제 #2 key를 배열로 사용하는 wincache_ucache_add()

                  
<?php
$colors_array = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
var_dump(wincache_ucache_add($colors_array));
var_dump(wincache_ucache_add($colors_array));
var_dump(wincache_ucache_get('Blue'));
?>

위의 예는 다음을 출력합니다.

array(0) { }
array(4) {
  ["green"]=> int(-1)
  ["Blue"]=> int(-1)
  ["yellow"]=> int(-1)
  ["cyan"]=> int(-1)
}
string(1) "6"

기타

PHP

웹학교

참조