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.

Note: 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

Example #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