Download the PHP package c0destep/holy_bible without Composer
On this page you can find all versions of the php package c0destep/holy_bible. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package holy_bible
Holy Bible API - PHP Library
🌐 English Version
Uma biblioteca PHP moderna e robusta para acessar a API da Bíblia Digital com suporte a cache, retry logic, logging e DTOs tipados.
✨ Características
- 🚀 Cache Inteligente - Até 400x mais rápido com cache automático
- 🔄 Retry Automático - Exponential backoff para falhas temporárias
- 📝 PSR-3 Logging - Logging completo para debugging
- 🎯 Type-Safe - DTOs com propriedades readonly (PHP 8.1+)
- 🏗️ Arquitetura em Camadas - Client/Service/Facade
- ⚙️ Configuração Flexível - Arrays, variáveis de ambiente, ou objetos
- ✅ 100% Testado - 27 testes automatizados
- 🔒 PHPStan Level 8 - Análise estática rigorosa
- 🔙 Backward Compatible - Funciona com código existente
- 📴 Offline Support - Suporte a SQLite local
📦 Instalação
🚀 Uso Rápido
Básico (Backward Compatible)
Com Configuração Avançada
Usando DTOs (Type-Safe)
Tratamento de Erros
⚙️ Configuração
Via Array
Via Variáveis de Ambiente
Interface Fluente
🔄 Retry Logic
A biblioteca implementa retry automático com exponential backoff:
Políticas Pré-Configuradas
Quando Retry é Aplicado
- ✅ Erros de conexão (timeout, DNS, etc)
- ✅ Erros 5xx do servidor
- ✅ Erro 429 (rate limiting)
- ❌ Erros 4xx (exceto 429)
- ❌ Erros de validação local
📝 Logging
Suporte completo a PSR-3 logging:
💾 Cache
Cache de Arquivos (Padrão)
Cache Customizado
Implemente CacheInterface:
Desabilitar Cache
💾 Suporte Offline (SQLite)
Agora você pode usar a biblioteca sem conexão com a internet através de um banco de dados SQLite local.
⚙️ Configuração SQLite
🌍 Variável de Ambiente
Você também pode configurar o caminho globalmente via .env ou export:
A biblioteca inclui o arquivo bible.sqlite na raiz, gerado a partir do data.sql fornecido, permitindo o
funcionamento offline imediato.
📚 DTOs Disponíveis
BookDTO
ChapterDTO
VerseDTO
VersionDTO
🧪 Testes
📊 Estatísticas
- 27 testes automatizados (100% passando)
- 71 assertions
- PHPStan level 8 (0 erros)
- ~2,200 linhas de código
- 19 classes
- 2 interfaces
- 5 exceções customizadas
🏗️ Arquitetura
🤝 Contribuindo
Contribuições são bem-vindas! Por favor:
- Fork o projeto
- Crie uma branch (
git checkout -b feature/nova-feature) - Commit suas mudanças (
git commit -am 'Adiciona nova feature') - Push para a branch (
git push origin feature/nova-feature) - Abra um Pull Request
📄 Licença
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
🙏 Créditos
- API fornecida por A Bíblia Digital
- Desenvolvido por c0destep
📞 Suporte
Feito com ❤️ em PHP