Download the PHP package modularavel/larapix without Composer
On this page you can find all versions of the php package modularavel/larapix. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download modularavel/larapix
More information about modularavel/larapix
Files in modularavel/larapix
Package larapix
Short Description Gerar QRCODE e chave copia e cola com valor definido para pagamentos via PIX!
License MIT
Homepage https://github.com/modularavel/larapix
Informations about the package larapix
modularavel/larapix
Gere QR Codes e códigos PIX copia e cola para pagamentos instantâneos no Laravel.
📖 Sobre
Larapix é um pacote Laravel elegante e minimalista para gerar pagamentos PIX de forma programática. Com uma interface fluente e intuitiva, você pode criar códigos copia e cola e QR Codes prontos para uso em segundos.
⚡ Principais Funcionalidades
| Funcionalidade | Descrição |
|---|---|
| 🔑 Código Copia e Cola | Gera o payload PIX completo conforme especificação BACEN |
| 📱 QR Code PNG | Gera imagem QR Code pronta para exibição |
| 🧹 Sanitização Automática | Remove acentos e caracteres especiais da cidade automaticamente |
| ⛓️ Interface Fluente | API encadeável e expressiva |
| 🏭 Facade | Acesso simplificado via Larapix::cobrar() |
| ⚙️ Configurável | Valores padrão via .env ou config |
| 🖼️ View Blade | Template responsivo pronto para uso |
| ✅ CRC16-CCITT | Checksum conforme padrão do Banco Central |
📦 Instalação
Instale o pacote via Composer:
Publique o arquivo de configuração:
Opcionalmente, publique as views:
⚙️ Configuração
Após publicar o config, edite config/larapix.php:
🔐 Variáveis de Ambiente (.env)
🚀 Uso
Uso Básico — Interface Fluente
Uso com Facade
Uso com Valores do Config
Exibir QR Code em uma View Blade
Salvar QR Code em Arquivo
QR Code com Largura Personalizada
🧹 Sanitização da Cidade
O campo cidadeDoTitularDaConta é sanitizado automaticamente:
| Entrada | Resultado |
|---|---|
São Paulo |
Sao Paulo |
Florianópolis |
Florianopolis |
Açailândia |
Acailandia |
Rio de Janeiro!@# |
Rio de Janeiro |
Goiânia |
Goiania |
null |
'' (vazio) |
Não é necessário tratar manualmente — o pacote cuida disso para você.
🧪 Testes
O pacote conta com 57 testes e 79 assertions usando Pest PHP:
Cobertura dos testes:
- ✅ Interface fluente (todos os setters)
- ✅ Sanitização de cidade (13 cenários)
- ✅ Formatação de valor
- ✅ Tratamento de null
- ✅ Estrutura do payload PIX
- ✅ CRC16 (consistência e unicidade)
- ✅ Geração de QR Code
- ✅ Prioridade config vs parâmetro
- ✅ Tipos inteiros no
cobrar() - ✅ Encadeamento completo
📐 Estrutura do Payload PIX
O código gerado segue a especificação EMVCo / BACEN:
📁 Estrutura do Pacote
🔗 Requisitos
| Requisito | Versão |
|---|---|
| PHP | ^8.1 |
| Laravel | 10.x / 11.x / 12.x |
| ext-intl | Requerido (para Normalizer) |
| ext-mbstring | Requerido |
| mpdf/qrcode | ^1.2 |
📋 Changelog
Veja CHANGELOG.md para detalhes sobre as mudanças em cada versão.
🤝 Contribuindo
Contribuições são bem-vindas! Por favor, veja CONTRIBUTING.md para detalhes.
🔒 Vulnerabilidades de Segurança
Para reportar vulnerabilidades de segurança, consulte nossa política de segurança.
👨💻 Autor
![]() Casimiro Rocha 📧 [email protected] |
📜 Licença
Este projeto é licenciado sob a Licença MIT — veja o arquivo LICENSE.md para detalhes.
🌟 Apoie o Projeto
Se este pacote foi útil para você, considere dar uma ⭐ no repositório!
Feito com ❤️ por Modularavel
Versão atual: 1.2.0
All versions of larapix with dependencies
ext-intl Version *
ext-mbstring Version *
illuminate/contracts Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0
mpdf/qrcode Version ^1.2
spatie/laravel-package-tools Version ^1.16
