infanatica/infanatica-cep-module

Modulo em Zend Framework 2 para consulta de endereco via CEP

v1.0 2015-02-12 22:38 UTC

Requires

• php: >=5.3.3
• zendframework/zend-authentication: ~2.1
• zendframework/zend-http: ~2.1
• zendframework/zend-loader: ~2.1
• zendframework/zend-modulemanager: ~2.1
• zendframework/zend-mvc: ~2.1
• zendframework/zend-servicemanager: ~2.1
• zendframework/zend-stdlib: ~2.1
• zendframework/zend-view: ~2.1

BSD-3-Clause

• Diogo Oliveira Mascarenhas

• framework
• zend
• zf2
• cep
• correios
• endereco
• modulo

README

InfanaticaCepModule

Módulo em Zend Framework 2 para consulta de endereço via CEP

Instalação

Instalação via clone

Clonar o projeto InfanaticaCepModule na pasta "./vendor" ou "./module" no seu projeto em Zend Framework 2

    $ cd PASTA_DO_SKELETON_DO_ZEND_FRAMEWORK2
    $ cd vendor
    $ git clone https://github.com/Infanatica/InfanaticaCepModule.git

Instalação via composer

Método 1

Adicionar o projeto InfanaticaCepModule no seu composer.json:

    "require": {
        "infanatica/infanatica-cep-module": "dev-master"
    }

Executar o comando "update" ou "install" do composer para fazer download do InfanaticaCepModule

    $ php composer.phar update

Método 2

Executar o comando "require" do composer para atualizar o seu composer.json e efetuar o download do InfanaticaCepModule

	php composer.phar require infanatica/infanatica-cep-module dev-master

Após a Instalação

Adicionar ao seu arquivo application.config.php

    <?php
    return array(
        'modules' => array(
            // ...
            'InfanaticaCepModule',
        ),
        // ...
    );

Utilização do Service

Exemplo no \Application\Controller\InderController

	<?php
	//...
	class IndexController extends AbstractActionController
	{
		public function indexAction()
	    {
			$cep = '21041020';

			// Possíveis formatos (json, xml, query, object, array)
			// null = \InfanaticaCepModule\Response\EnderecoResponse
			$formato        = 'json';

			$serviceLocator = $this->getServiceLocator();
			$cepService     = $serviceLocator->get('InfanaticaCepModule\Service\CepService');
			$endereco       = $cepService->getEnderecoByCep($cep,$formato);
			var_dump($endereco);

	        return new ViewModel();
	    }
    //...

Utilização do Controller

Exemplos de rota para:

\InfanaticaCepModule\Controller\CepController

http[s]://domain/cep/NUMERO_DO_CEP

http[s]://domain/cep/21041020

http[s]://domain/cep/NUMERO_DO_CEP/FORMATO_DE_SAIDA

http[s]://domain/cep/21041020/json

http[s]://domain/cep/21041020/xml

Referências dos Adapters de pesquisa de CEP

ViaCEP (Concluído)

Postmon (Concluído)

Correio Control (Concluído)

Republica Virtual (Concluído)

Contruibuidores

Diogo Oliveira Mascarenhas (https://github.com/diogomascarenha)

Everton Muniz (https://github.com/munizeverton)