josenildols/viacep-php

ViaCEP PHP

viaCEP PHP

, _(*1)

Faça busca por endereços do Brasil utilizando o ViaCEP REST API., _(*2)

Instalação

Via Composer, _(*3)

``` bash $ composer require josenildols/viacep-php, <sub>(*4)</sub>

## Como instanciar

``` php

use JosenildoLS\viaCEP;

$cep = new viaCEP();
$cep->find('01001-000');

Retorno em Array

``` php $array = $cep->toArray();, <sub>(*5)</sub>

/* O resultado deverá ser algo assim:, <sub>(*6)</sub>

Array ( [cep] => 01001-000 [logradouro] => Praça da Sé [complemento] => lado ímpar [bairro] => Sé [localidade] => São Paulo [uf] => SP [unidade] => [ibge] => 3550308 [gia] => 1004 ), <sub>(*7)</sub>

*/, <sub>(*8)</sub>

### Retorno JSON

``` php
$json = $cep->toJson();

/*
O resultado deverá ser algo assim:

{
    cep: "01001-000",
    logradouro: "Praça da Sé",
    complemento: "lado ímpar",
    bairro: "Sé",
    localidade: "São Paulo",
    uf: "SP",
    unidade: "",
    ibge: "3550308",
    gia: "1004"
}
*/

Retorno Piped

``` php $piped = $cep->toPiped();, <sub>(*9)</sub>

/* O resultado deverá ser algo assim:, <sub>(*10)</sub>

cep:01001-000|logradouro:Praça da Sé|complemento:lado ímpar|bairro:Sé|localidade:São Paulo|uf:SP|unidade:|ibge:3550308|gia:1004 */, <sub>(*11)</sub>

### Retorno Querty

``` php
$querty = $cep->toQuerty();

/*
O resultado deverá ser algo assim:

cep=01001-000&logradouro=Pra%C3%A7a+da+S%C3%A9&complemento=lado+%C3%ADmpar&bairro=S%C3%A9&localidade=S%C3%A3o+Paulo&uf=SP&unidade=&ibge=3550308&gia=1004
*/

Salvar em .XML

``` php $cep->toXML("nome_da_pasta");, <sub>(*12)</sub>

/* O resultado deverá ser algo assim, devo ressaltar que o nome_da_pasta é opcional:, <sub>(*13)</sub>

01001-000 Praça da Sé lado ímpar Sé São Paulo SP 3550308 1004 , <sub>(*14)</sub>

*/, <sub>(*15)</sub>

### Salvar em .CSV

``` php
$cep->toCSV("nome_da_pasta");

/*
O resultado deverá ser algo assim, devo ressaltar que o nome_da_pastaé opcional:

cep,logradouro,complemento,bairro,localidade,uf,unidade,ibge,gia
01001-000,Praça da Sé,lado ímpar,Sé,São Paulo,SP,,3550308,1004

*/

Licença

Sobre a licença MIT (MIT). Por favor, veja License File para mais informações., <sub>(*16)</sub>