Download the PHP package profmugomes/mgcep without Composer
On this page you can find all versions of the php package profmugomes/mgcep. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download profmugomes/mgcep
More information about profmugomes/mgcep
Files in profmugomes/mgcep
Package mgcep
Short Description É uma biblioteca leve e simples em PHP para consulta de CEP utilizando a API pública do ViaCEP.
License proprietary
Informations about the package mgcep
MGCEP
É uma biblioteca leve e simples em PHP para consulta de CEP utilizando a API pública do ViaCEP, com suporte a cache local em arquivos para melhorar desempenho e reduzir requisições externas.
Ideal para aplicações que precisam de consultas rápidas de endereço, com baixo consumo de recursos e fácil integração.
✨ Características
- Consulta de CEP via ViaCEP
- Cache local em arquivos (
.json) - Configuração de tempo de cache (TTL)
- API simples e direta
- Zero dependências externas
- Compatível com PHP 8+
📦 Instalação
Manual
Copie a classe MGCEP.php para seu projeto e utilize via require ou autoload:
⚙️ Configuração
Antes de utilizar, é recomendado configurar o diretório de cache:
📮 Consulta de CEP
🧠 Métodos Públicos
📁 setCacheDir
Define o diretório onde os arquivos de cache serão armazenados.
Parâmetros:
string $path→ Caminho do diretórioint $permission→ Permissão (padrão:0777)
⏱️ setCacheTTL
Define o tempo de vida do cache em segundos.
🔍 getCEP
Realiza a consulta do CEP.
Retorno:
false→ Sucessostring→ Mensagem de erro
📍 Métodos de Dados
Após uma consulta bem-sucedida (getCEP), os dados podem ser acessados:
🏠 Endereço
🌆 Localização
🏛️ Informações adicionais
💡 Exemplo completo
⚠️ Observações
- É necessário chamar
getCEP()antes de acessar os métodos de dados - O cache é baseado no hash da URL
- Arquivos expirados são removidos automaticamente
- Requer conexão com internet na primeira consulta
👤 Autor
Murilo Gomes
🔗 https://www.profmugomes.com.br
📺 https://youtube.com/@profmugomes
🤝 Support
- GitHub Sponsors: https://github.com/sponsors/profmugomes
License
Copyright (c) 2026 Murilo Gomes
This project is licensed under the PolyForm Perimeter License 1.0.1.
Summary
This software is available for commercial and noncommercial use, subject to the terms of the PolyForm Perimeter License 1.0.1.
You may:
- ✔ Use the software for commercial and noncommercial purposes.
- ✔ Inspect and study the source code.
- ✔ Modify the software.
- ✔ Create derivative works based on the software.
- ✔ Redistribute the software and permitted modifications.
You may not:
- ✖ Provide a product that competes with the software.
See the full license terms at LICENSE.md.
This summary is provided for convenience only and does not replace or modify the full license terms.