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.
Requires
- php: >=8.0
- predis/predis: ^2.3
- vlucas/phpdotenv: ^5.6
Requires (Dev)
- phpunit/phpunit: ^11.2
This package is auto-updated.
Last update: 2025-05-03 17:59:17 UTC
README
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
ouObjeto
. - 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
- Armazenar e Recuperar Dados em Cache
- Expiração de cache personalizável
- Limpeza e flush de cache
- Suporte a namespaces para organização de cache
- Limpeza automática do diretório de cache
flushAfter
- Cache de Resposta de API
- Saída de Dados Personalizada (
JSON
) - Saída de Dados Personalizada (
Array
) - Saída de Dados Personalizada (
String
) - Guia de Upgrade para Versão 2.0.0
- 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