(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.
valuesArray 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"