silviooosilva/cacheer-php

CacheerPHP é um pacote minimalista para caching em PHP, oferecendo uma interface simples para armazenar e recuperar dados em cache utilizando múltiplos backends.

v3.4.1 2025-05-03 17:58 UTC

README

Maintainer Packagist Dependency Version Latest Version Quality Score Packagist Downloads

CacheerPHP é um pacote minimalista para caching em PHP. Agora, na versão 3.0.0, você tem ainda mais flexibilidade, suporte a múltiplos backends (arquivos, banco de dados e Redis), além de novas funcionalidades para monitoramento, compressão, Criptografia(Em Breve) e um design de API mais robusto.

Funcionalidades

  • Armazenamento e Recuperação de Cache: Suporte a armazenamento em arquivos, bancos de dados (MySQL, PostgreSQL, SQLite) e Redis.
  • Expiração Personalizável: Defina o TTL (Time To Live) do cache com precisão.
  • Limpeza e Flush de Cache: Suporte para limpeza manual e automática (via flushAfter).
  • Suporte a Namespaces: Organize suas entradas de cache por categorias.
  • Saída de Dados Personalizada: Opções para retornar os dados em JSON, Array, String ou Objeto.
  • Compressão e Criptografia(Em Breve): Reduza o espaço de armazenamento e aumente a segurança dos dados cacheados.
  • Cache Statistics and Monitoring: Acompanhe estatísticas de acertos, falhas e tempos médios de leitura/escrita(Em Breve).
  • Logging Avançado: Monitoramento detalhado do funcionamento do sistema de cache.

Instalação

O CacheerPHP 3.0.0 está disponível via Composer. Adicione a seguinte linha no seu arquivo composer.json:

  "silviooosilva/cacheer-php": "^3.0"

Ou rode o comando:

composer require silviooosilva/cacheer-php

AVISO IMPORTANTE!!!

Não se esqueça de configurar as suas variáveis de ambiente, presentes no arquivo .env.example.

Relembrar que devem ser configurados no arquivo .env, e não no .env.example. Para tal, faça o seguinte na sua linha de comandos:

cp .env.example .env 

Documentação

  1. Armazenar e Recuperar Dados em Cache
  2. Expiração de cache personalizável
  3. Limpeza e flush de cache
  4. Suporte a namespaces para organização de cache
  5. Limpeza automática do diretório de cache flushAfter
  6. Cache de Resposta de API
  7. Saída de Dados Personalizada (JSON)
  8. Saída de Dados Personalizada (Array)
  9. Saída de Dados Personalizada (String)
  10. Guia de Upgrade para Versão 2.0.0
  11. API Reference

Tem ainda disponível diversos exemplos práticos na pasta Examples, na raíz do projeto.

Compatibilidade

  • PHP: 8.0 ou superior.
  • Drivers de Banco de Dados: MySQL, PostgreSQL, SQLite.
  • Redis

Testes

Para rodar os testes, vá para a raíz do projeto e digite o comando:

vendor/bin/phpunit

Support:

silviooosilva