PHPackages                             grupoan/cep-promise-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues & Workers](/categories/queues)
4. /
5. grupoan/cep-promise-php

ActiveLibrary[Queues & Workers](/categories/queues)

grupoan/cep-promise-php
=======================

Busca por CEP utilizando Promises nos serviços dos Correios, ViaCEP, CepAberto e outros.

v1.2.3(3y ago)063MITPHPPHP ^7.2 | ^8.1

Since Mar 24Pushed 3y agoCompare

[ Source](https://github.com/grupoan/cep-promise-php)[ Packagist](https://packagist.org/packages/grupoan/cep-promise-php)[ RSS](/packages/grupoan-cep-promise-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (15)Used By (0)

CEP Promise PHP
===============

[](#cep-promise-php)

[![Build Status](https://camo.githubusercontent.com/50cc0be0f421f36714697c8a12da7e4dc06013d2b7299dcf99929e30a9d77374/68747470733a2f2f7472617669732d63692e6f72672f636c617564736f6e6d2f6365702d70726f6d6973652d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/claudsonm/cep-promise-php)[![StyleCI](https://camo.githubusercontent.com/7cff7bb29a5dbeb604e29c74d3d944e0f9f6d0a3a965446727627b6de4682f72/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3137373433363530372f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/177436507)[![Packagist](https://camo.githubusercontent.com/5381735aa1886505096a251cb1d7914de098a91e768130c99ebf3b06eba8e539/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c617564736f6e6d2f6365702d70726f6d6973652d7068703f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/5381735aa1886505096a251cb1d7914de098a91e768130c99ebf3b06eba8e539/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c617564736f6e6d2f6365702d70726f6d6973652d7068703f7374796c653d666c61742d737175617265)[![All Contributors](https://camo.githubusercontent.com/4e96de37ea680371089642c8762ee051f42043eb64b50c4119a4e48970a2d434/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f616c6c5f636f6e7472696275746f72732d312d6f72616e67652e7376673f7374796c653d666c61742d737175617265)](#contributors)

Um pacote agnóstico para PHP 8.0+ que efetua a busca de CEPs em diversos serviços utilizando [Promises/A+](https://promisesaplus.com/). Inspirado no pacote [CEP Promise](https://github.com/filipedeschamps/cep-promise)para Node.js e web browsers.

Features
--------

[](#features)

- Realiza requests de forma concorrente, retornando sempre a resposta mais rápida;
- Possui alta disponibilidade por utilizar diversos provedores de serviço diferentes;
- Base de CEPs sempre atualizada, já que conecta-se com diversos serviços, dentre eles os Correios;
- Sem limites de requisições (*rate limits*) conhecidas;
- Feito utilizando a implementação para PHP de promises do pacote [guzzle/promises](https://github.com/guzzle/promises);

Instalação
----------

[](#instalação)

A maneira recomendada de instalar o pacote é via [Composer](https://getcomposer.org/download/). Com a ferramenta instalada, execute o comando abaixo:

```
composer require claudsonm/cep-promise-php
```

Após instalar, você precisará requerer o autoloader do Composer por meio da instrução:

```
require 'vendor/autoload.php';
```

Exemplos de Uso
---------------

[](#exemplos-de-uso)

### Exemplo 1

[](#exemplo-1)

Busca utilizando valores inteiros e resposta em forma de objeto.

```