(PECL wincache >= 1.1.0)
wincache_ucache_set — Adiciona uma variável no cache do usuário e substitui uma variável se ela já existir no cache
Adiciona uma variável ao cache do usuário. Substitui uma variável se ela já existir no cache. A variável adicionada ou atualizada permanece no cache do usuário, a menos que seu tempo de vida expire ou seja excluída usando as funções wincache_ucache_delete() ou wincache_ucache_clear().
key
Armazene a variável usando este nome key
. Se uma variável com o mesmo
key
já estiver presente, a função substituirá o valor
anterior pelo novo. key
diferencia maiúsculas de minúsculas.
key
também pode receber um array de pares nome => valor, onde os nomes serão usados como
chaves. Isso pode ser usado para adicionar vários valores ao cache em uma única operação, evitando assim
condições de corrida.
value
Valor de uma variável a ser armazenada. Value
suporta todos os tipos de dados, exceto recursos, como identificadores de arquivo.
Este parâmetro é ignorado se o primeiro argumento for um array. Uma orientação geral é passar null
como value
enquanto usa array como key
. Se value
for um
objeto ou um array contendo objetos, os objetos serão serializados. Consulte
__sleep() para obter detalhes sobre a serialização de objetos.
values
Array associativo de chaves e valores.
ttl
Tempo que a variável permanece no cache em segundos. Após o valor especificado em ttl
ser excedido,
a variável armazenada será excluída do cache. Este parâmetro assume o valor padrão de 0
, o que significa que
a variável permanecerá no cache, a menos que seja explicitamente excluída usando as funções wincache_ucache_delete()
ou wincache_ucache_clear().
Se key
for uma string, a função retornará true
em caso de sucesso e false
em caso de falha.
Se key
for um array, a função retornará:
false
;
Exemplo #1 wincache_ucache_set() com key
sendo uma string
<?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'));
?>
O exemplo acima produzirá:
bool(true) string(3) "BAR" bool(true) string(3) "BAR1"
Exemplo #2 wincache_ucache_set() com key
sendo um array
<?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'));
?>
O exemplo acima produzirá:
array(0) {} array(0) {} string(1) "6"