PHPackages                             claudsonm/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. claudsonm/cep-promise-php

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

claudsonm/cep-promise-php
=========================

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

v1.2.0(3y ago)3121.3k↓49.7%12[3 PRs](https://github.com/claudsonm/cep-promise-php/pulls)MITPHPPHP ^7.4 | ^8.0

Since Mar 24Pushed 1y ago2 watchersCompare

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

READMEChangelog (6)Dependencies (4)Versions (15)Used By (0)

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

[](#cep-promise-php)

[![Run Tests](https://github.com/claudsonm/cep-promise-php/actions/workflows/run-tests.yml/badge.svg)](https://github.com/claudsonm/cep-promise-php/actions/workflows/run-tests.yml)[![Check & fix styling](https://github.com/claudsonm/cep-promise-php/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/claudsonm/cep-promise-php/actions/workflows/php-cs-fixer.yml)[![Packagist](https://camo.githubusercontent.com/a61df77c65cad1190eb49fc7165f099519a90f5ff531d36381a21a009c0db66f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c617564736f6e6d2f6365702d70726f6d6973652d706870)](https://camo.githubusercontent.com/a61df77c65cad1190eb49fc7165f099519a90f5ff531d36381a21a009c0db66f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c617564736f6e6d2f6365702d70726f6d6973652d706870)[![All Contributors](https://camo.githubusercontent.com/9a97c97e7b6878dc291b03a486a88c3618ac3b14886936a7e59632808e017abb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f616c6c5f636f6e7472696275746f72732d312d6f72616e67652e737667)](#contributors)

Um pacote agnóstico para PHP 7.4 e 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.

```