Download the PHP package andersonef/cep-promise-php without Composer
On this page you can find all versions of the php package andersonef/cep-promise-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download andersonef/cep-promise-php
More information about andersonef/cep-promise-php
Files in andersonef/cep-promise-php
Package cep-promise-php
Short Description Cópia do projeto filipedeschamps/cep-promise, porém em PHP. A idéia não é copiar fielmente a implementação, mas a funcionalidade afim de praticar apenas.
License MIT
Informations about the package cep-promise-php
CEP Promise
Busca por CEP integrado diretamente aos serviços dos Correios, ViaCEP e WideNet.
Descrição
Essa biblioteca é uma cópia da original feita pelo Filipe Deschamps (Michel Teló) que achei a premissa bastante interessante e decidi copiá-la em PHP e Python.
O estilo do código é outro, visto que o Filipe usa JS com uma abordagem funcional, já eu nesse projeto optei por utilizar orientação a objetos guiada por testes.
Features
- Sempre atualizado em tempo-real por se conectar diretamente aos serviços dos Correios, ViaCEP e WideNet.
- Possui alta disponibilidade por usar vários serviços como fallback.
- Sem limites de uso (rate limits) conhecidos.
- 100% de code coverage com testes unitários e integração.
Como Utilizar
Instalação
Instale via composer diretamente no bash com o comando:
Ou modifique seu arquivo composer.json acrescentando a biblioteca nas dependências:
Utilização
A utilização é bem simples:
O retorno será sempre um objeto do tipo Andersonef\CepPromise\ResponseAddress.
Customizando
Você pode criar novos serviços para fallback facilmente com essa biblioteca.
Um serviço é qualquer classe que implemente a interface Andersonef\CepPromise\Interfaces\ServiceInterface, logo:
Após criar seu service customizado, basta adicioná-lo à sua instância CepPromise, assim:
Tratando falhas
Qualquer erro nessa biblioteca irá disparar uma exception do tipo Andersonef\CepPromise\CepPromiseException.
Deixe suas sugestões
Fique a vontade para deixar sugestões nas issues!
Fonte
Esse pacote foi inspirado no original https://github.com/filipedeschamps/cep-promise