(PECL wincache >= 1.1.0)
wincache_ucache_set — Añade una variable a la caché de usuario y sobrescribe la variable si ya existe en la caché
Añade una variable a la caché de usuario. Sobrescribe una variable si ya existe en la caché. La variable así creada o actualizada permanecerá en la caché de usuario mientras no se alcance el tiempo de expiración o hasta que no se elimine con la función wincache_ucache_delete() o la función wincache_ucache_clear().
key
Almacena la variable usando la clave key
.
Si una variable usando la misma clave key
ya está presente,
la función sobrescribirá el valor anterior con el nuevo. El parámetro key
es sensible a mayúsculas y minúsculas. key
también puede ser un
array de pares nombre => valor donde los nombres serán usados como claves. Esto puede ser útil
para añadir múltiples valores en la caché en una sola operación, evitando así las condiciones de carrera.
value
Valor de la variable a almacenar. El parámetro Value
soporta todos los tipos de datos, excepto recursos, como punteros de archivos. Este parámetro
es ignorado si el primer argumento es un array. Es convención pasar null
como
value
cuando se usa un array en el parámetro key
.
Si el parámetro value
es un objeto, o un array que contiene objetos,
entonces todos los objetos serán serializados. Consulte la función __sleep()
para más detalles sobre la serialización de objetos.
values
Array asociativo de claves y valores.
ttl
Tiempo de vida de la variable en la caché, en segundos. Después del tiempo especificado
por el parámetro ttl
, la variable almacenada será eliminada de la caché de usuario.
Este parámetro toma por defecto el valor cero (0
), lo que significa que la variable
permanecerá en la caché hasta que no sea explícitamente eliminada llamando a la función
wincache_ucache_delete() o la función wincache_ucache_clear().
Si key
es un chaîne de caractères, la función devolverá true
en caso de éxito,
false
si ocurre un error.
Si key
es un array, la función devolverá:
false
.
Ejemplo #1 Ejemplo con wincache_ucache_set() y
el parámetro key
en forma de chaîne de caractères
<?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'));
?>
El resultado del ejemplo sería:
bool(true) string(3) "BAR" bool(true) string(3) "BAR1"
Ejemplo #2 Ejemplo con wincache_ucache_set() y
el parámetro key
en forma de tableau
<?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'));
?>
El resultado del ejemplo sería:
array(0) {} array(0) {} string(1) "6"