PHP Conference Nagoya 2025

    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

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 1 note

    up
    2
    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.
    ＋adicione uma nota
    To Top