Instalação do Projeto

Devido este projeto utilizar o PHP que é uma linguagem server-side, ou seja, executada no Back End. Então, é necessário executá-la em um servidor, entretanto, não se preocupe que mostrarei como utilizar seu próprio computador como um servidor para a execução do projeto.

Caso esteja utilizando um Servidor Externo:

• Habilite a função "allow_url_fopen" no arquivo ini.php;
  • Permitindo que haja busca de informações de fora do servidor, em nosso caso, através da API ViaCep
• Faça o download deste projeto, Clicando em "Code -> Download ZIP";
• Extraia os arquivos;
• Carregue os arquivos para seu servidor externo, com o Filezilla, ou qualquer programa de sua preferência;
• Podendo acessar via link, exemplo -> "rtsgo.com.br/viacep".

Caso queira utilizar o seu computador para executar:

Primeiramente precisará de um programa para ser nosso servidor web, eu utilizei o XAMPP -> Link para Download;

Baixe de acordo com o seu sistema operacional, caso tenha alguma dúvida na instalação, na página do XAMPP, há videos explicativos e ajudas;

Após instalar ou caso já tenha instalado, precisará apenas executar o XAMPP Control Panel;

Com o XAMPP Control Panel aberto, start a primeira opção chamada "Apache", ele será o nosso servidor web;

Quando ficar verde, quer dizer que o nosso servidor esta funcionando, para podermos testar podemos acessar atráves de um navegador o caminho "http://localhost/dashboard/".

Se tudo estiver ok, receberá um Bem Vindo do XAMPP.

Agora precisamos apenas carregar os arquivos para a pasta do XAMPP

• Faça o download deste projeto, Clicando em "Code -> Download ZIP";
• Extraia os arquivos;
• Carregue os arquivos para este caminho em seu computador: "C:\xampp\htdocs;
• o caminho pode variar de acordo com a instalação, consulte as configurações do XAMPP;

E pronto agora pode acessá-lo atráves do caminho "http://localhost/Busca-Dados---ViaCep-main/".

Não se preocupe com o nome complicado, você pode alterar o nome da pasta do projeto e acessá-lo substituindo no caminho.

• Exemplo -> "http://localhost/NovoNome/"

Como Utilizar

O projeto é organizado em três abas:

• Início
  • Contendo algumas recomendações e instruções de uso.
• Busca Com Cep
  • Contendo o campo para informar o CEP e o botão para buscar;
  • Após informar, apenas aguarde o processamento que o resultado aparecerá abaixo.
• Busca Por UF-CIDADE-LOGRADOURO
  • Contendo os campos para informar o UF, CIDADE e LOGRADOURO, abaixo o botão para buscar;
  • Após informar todos os campos, apenas aguarde o processamento que o resultado aparecerá abaixo.

Tratamentos de Erros

Para evitar a quebra do processamento, este projeto possui os seguintes tratamentos de erros:

• Campo CEP
  • Considera apenas os números informados;
  • Verifica a quantidade de 8 caracteres, aceitando o '-' após os cinco primeiros números;
  • Verifica se o CEP informado é existente.
• Campo UF
  • Verifica se o UF informado é existente.
• Campo CIDADE E LOGRADOURO
  • Verifica se no mínimo foram informados 3 caracteres, para manter os resultados não tão abrangentes, na verificação desconsidera os caracteres especias.

Considerações Finais

Espero que este projeto possa contribuir para a nossa comunidade de desenvolvedores, pois, juntos podemos melhorar cada vez mais

Todo Feedback é bem vindo.