apcu_store

(PECL apcu >= 4.0.0)

apcu_store Armazena uma variável em cache

Descrição

apcu_store(string $key, mixed $var, int $ttl = 0): bool
apcu_store(array $values, mixed $unused = NULL, int $ttl = 0): array

Armazena uma variável em cache.

Nota: Diferentemente de muitos outros mecanismos no PHP, variáveis armazenadas usando apcu_store() persistirão entre requisições (até que o valor seja removido do cache).

Parâmetros

key

Armazena a variável usando o nome informado em key, que deve ser única no cache. Portanto, armazenar um segundo valor com o mesmo valor de key irá substituir o valor original.

var

A variável a ser armazenada

ttl

Tempo de Vida (Time To Live); armazena var no cache por ttl segundos. Depois desses ttl segundos, a variável armazenada será excluída do cache (na próxima requisição). Se nenhum parâmetro ttl for informado (ou se ttl for 0), o valor persistirá até que seja removido do cache manualmente, ou caso deixe de existir no cache (limpeza, reinício, etc.).

values

Nomes nas chaves, variáveis nos valores.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha. A segunda sintaxe retorna um array com chaves de erros.

Exemplos

Exemplo #1 Um exemplo de apcu_store()

<?php
$bar
= 'BAR';
apcu_store('foo', $bar);
var_dump(apcu_fetch('foo'));
?>

O exemplo acima produzirá:

string(3) "BAR"

Veja Também

  • apcu_add() - Faz cache de uma nova variável no armazenamento de dados
  • apcu_fetch() - Busca uma variável armazenada no cache
  • apcu_delete() - Remove uma variável armazenada do cache

add a note add a note

User Contributed Notes 1 note

up
0
info at qmegas dot info
3 years ago
Be careful when updating same key with ttl set during same request. For example:
<?php
for ($i = 0; $i < 20; $i++) {
   
apcu_store('test', $i, 10);
   
sleep(1);
}
?>

After 10 seconds the key will become not available and won't be updated. Tested on Windows and Linux platforms. Not sure if it's a bug or undocumented behavior.
To Top