Alura > Cursos de Programação > Cursos de PHP > Conteúdos de PHP > Primeiras aulas do curso PHP: aplicando boas práticas de código

PHP: aplicando boas práticas de código

Refatoração - Apresentação

Boas-vindas à Alura. Eu sou Vinicius Dias e vou guiar você neste curso sobre boas práticas com PHP.

Audiodescrição: Vinícius é um homem branco com olhos castanhos, cabelo escuro e curto, bigode e cavanhaque. Usa uma camiseta preta com a frase "Make PHP Great Again" (Faça o PHP Grande Novamente), com um elefante no meio. Ao fundo, parede lisa sem decorações com uma iluminação rosa.

Se você já sabe PHP e conhece orientação a objetos, mas quer aprender sobre boas práticas para escrever um código mais interessante e fácil de dar manutenção, este curso é para você.

O que vamos aprender?

Neste curso, vamos aprender a tornar o código mais legível, mais fácil de manter e mais simples de implementar novas funcionalidades.

Para isso, abordaremos temas como:

Vamos explorar um pouco sobre esses assuntos e, durante cada aula, deixaremos referências para você se aprofundar.

Pré-requisitos

Para aproveitar este curso, é necessário que você já tenha alguma familiaridade com o terminal. Vamos trabalhar com uma aplicação pela linha de comando, então, apesar de não precisar saber vários comandos, a tela de comandos não pode ser um obstáculo.

Também é importante que você já conheça PHP com a sintaxe de orientação a objetos. Não é necessário dominar orientação a objetos, mas é essencial entender e conhecer os conceitos.

Além disso, é fundamental saber o que é Composer e já o tenha instalado em sua máquina, pois o utilizaremos para duas finalidades: gerar um autoloader e instalar uma ferramenta de testes. Não utilizaremos nenhuma ferramenta externa ou componente externo para executar o código, mas para os testes, sim.

É necessário que você tenha, pelo menos, a versão 8.3 do PHP instalada na sua máquina. Qualquer versão mais recente também serve.

Isso porque o que faremos nesse curso será com o código moderno do PHP.

Depois de dar esses recados sobre o que vamos aprender e o que você já precisa saber, te esperamos no próximo vídeo, onde conheceremos a aplicação que está com um código bem peculiar para que possamos melhorá-lo bastante.

Refatoração - Conhecendo a aplicação

Vamos conhecer a aplicação cujo código vamos modificar e melhorar. Trata-se de uma aplicação chamada Adopet, destinada a abrigos de adoção de animais de estimação.

Nessa aplicação, vamos cadastrar abrigos e animais nesses abrigos. Ela é uma aplicação que roda na linha de comando, no console. Dessa forma, ela será executada nos computadores de algumas pessoas voluntárias nos abrigos.

Para que esses dados não fiquem salvos nos computadores de cada uma das pessoas, utilizaremos um serviço externo, uma API externa. Disponibilizamos uma atividade de "Para Saber Mais" para você criar essa API utilizando o site mockapi.io. Em cinco minutos, será possível ter uma API pronta.

No código já disponibilizado, você deve entrar no projeto-inicial.php e substituir o endereço referente ao mockapi.io pelo endereço da API que você criar.

Ao fazer uma busca no código pelo endereço https://66f610a1436827ced975d41f.mockapi.io com o atalho "Ctrl + F", encontraremos quatro ocorrências que precisam ser alteradas: nas variáveis $responseBody, $curl, $response e $curl.

Conhecendo a aplicação

O sistema roda na linha de comando e possui algumas funcionalidades. Vamos executá-lo para verificar se está tudo funcionando e, em seguida, analisaremos o código para identificar o que precisa ser melhorado. Já adiantamos que há bastante a ser feito.

Abrimos o terminal na pasta do projeto e digitamos o comando php seguido do nome do arquivo PHP do projeto:

php projeto-inicial.php
BOAS VINDAS AO SISTEMA ADOPET CONSOLE

DIGITE O NÚMERO DA OPERAÇÃO DESEJADA:

1 -> Listar abrigos cadastrados

2 -> Cadastrar novo abrigo

3 -> Listar pets do abrigo

4 -> Importar pets do abrigo

5 -> Sair

No terminal, recebemos uma saudação e uma indicação que precisamos digitar o número da opção desejada.

Listando abrigos cadastrados

Primeiramente, listaremos os abrigos cadastrados, que é a primeira opção. Então, digitamos 1 e pressionamos "Enter".

1

Abrigos cadastrados:

O sistema exibe os abrigos cadastrados, mas não há nenhum, então apenas um espaço vazio é mostrado.

Cadastrando novo abrigo

Novamente, precisamos digitar o número da opção desejada. Dessa vez, selecionamos a segunda opção para cadastrar um abrigo. Digitamos 2 e pressionamos "Enter" novamente.

2

Digite o nome do abrigo: Dias de Pet

Digite o telefone do abrigo: 21999999999

Digite o email do abrigo: email@example.org

O sistema pede para digitar o nome, telefone e e-mail do abrigo. Nesse caso, passamos o nome Dias de Pet e depois um telefone e e-mail fictícios.

Abrigo cadastrado com sucesso!

O sistema confirma que o abrigo foi cadastrado com sucesso e pede para digitar a próxima opção.

Agora, verificamos se o abrigo foi realmente cadastrado, digitando novamente 1.

1

Abrigos cadastrados:

1 - Dias de Pet

Na lista, aparece o número 1, que é o ID do abrigo, e o nome Dias de Pet.

Listando animais do abrigo

Em seguida, listamos os animais do abrigo, que é a terceira opção. Digitamos o número 3 e pressionamos "Enter".

3

Digite o id do abrigo: 1

O sistema pede para digitar o ID do abrigo. Ao digitar o ID 1, o sistema exibe os animais cadastrados, mas não há nenhum no momento.

Pets cadastrados:

Importando animais do abrigo

Por isso, importaremos um arquivo de animais para esse abrigo. No projeto inicial, disponibilizamos uma planilha, um arquivo CSV com alguns animais para importação. O nome do arquivo é pets.csv e está na mesma pasta do projeto.

No terminal, digitamos 4 para poder importar os animais.

4

Digite o id do abrigo: 1

Digite o nome do arquivo CSV: pets.csv

O sistema pede o ID do abrigo, que é 1, e o nome do arquivo CSV. Se o arquivo estiver na mesma pasta do projeto, podemos digitar apenas o nome, pets.csv. Caso contrário, será necessário digitar o caminho do arquivo.

Após pressionar "Enter", o sistema começa a cadastrar cada um dos animais no abrigo.

Pet cadastrado com sucesso: Rex

Pet cadastrado com sucesso: Mia

Pet cadastrado com sucesso: Luna

Pet cadastrado com sucesso: Felix

Pet cadastrado com sucesso: Bella

Pet cadastrado com sucesso: Lucy

Pet cadastrado com sucesso: Apollo

Pet cadastrado com sucesso: Leopoldo

Finalizada a importação, podemos selecionar a opção 3 novamente para listar os animais do abrigo.

3

Digite o id do abrigo: 1

Depois, digitamos o ID 1 e verificamos que todos os animais estão cadastrados.

Pets cadastrados:

1 - cachorro - Rex - Poodle - 5 ano(s)

2 - gato - Mia - Siamês - 3 ano(s)

3 - cachorro - Luna - Bulldog Francês - 2 ano(s)

4 - gato - Felix - Persa - 4 ano(s)

5 - cachorro - Bella - Labrador Retriever - 6 ano(s)

6 - gato - Lucy - Sphynx - 2 ano(s)

7 - cachorro - Apollo - Husky Siberiano - 3 ano(s)

8 - gato - Leopoldo - Siamês - 4 ano(s)

Com isso, pressionamos a opção 5 para encerrar o programa.

5

Finalizando o programa...

Entendendo o código

Vamos entender o código do arquivo projeto-inicial.php. O código começa com um try-catch para verificar se há algum erro. A primeira instrução dentro do try é um loop do-while.

Dentro desse do, temos 7 comandos echo para exibir as opções iniciais e uma variável $opcaoEscolhida para recuperar o número que foi digitado com um fgets() do STDIN.

Usamos um trim() no fgets() para remover a quebra de linha. Por exemplo, quando digitamos 1 e pressionamos "Enter", o Enter também seria capturado. O trim() remove o "Enter".

projeto-inicial.php:

<?php

echo '##### BOAS VINDAS AO SISTEMA ADOPET CONSOLE #####' . PHP_EOL;

try {
    do {
        echo "\nDIGITE O NÚMERO DA OPERAÇÃO DESEJADA:" . PHP_EOL;
        echo "1 -> Listar abrigos cadastrados" . PHP_EOL;
        echo "2 -> Cadastrar novo abrigo" . PHP_EOL;
        echo "3 -> Listar pets do abrigo" . PHP_EOL;
        echo "4 -> Importar pets do abrigo" . PHP_EOL;
        echo "5 -> Sair" . PHP_EOL;

        $opcaoEscolhida = trim(fgets(STDIN));

    // código omitido…
    }
}

Se a $opcaoEscolhida for 1, o sistema faz uma requisição HTTP do tipo GET com file_get_contents() para /abrigos.

Com isso, é retornado um JSON, que é um formato de arquivo. O PHP possui a função json_decode(), que transforma o JSON em um array associativo do PHP, permitindo fazer um foreach e exibir os abrigos cadastrados.

if ($opcaoEscolhida == 1) {
        $responseBody = file_get_contents('https://66f610a1436827ced975d41f.mockapi.io/abrigos');
        $jsonArray = json_decode($responseBody, true);
        echo "Abrigos cadastrados:" . PHP_EOL;
        foreach ($jsonArray as $abrigo) {
                $id = $abrigo['id'];
                $nome = $abrigo['nome'];
                echo "$id - $nome" . PHP_EOL;
        }
}

// código omitido…

Se selecionamos a opção 2, o sistema pergunta o $nome, $telefone e $email do abrigo para realizar um cadastro. Desse modo, cria-se um array associativo chamado $abrigo com a função compact(), que basicamente cria um array associativo com as chaves e valores das variáveis. A chave nome terá o valor da variável $nome, e assim por diante.

Em seguida, o sistema faz uma requisição HTTP de outra forma, utilizando a extensão cURL, uma forma conhecida de realizar requisições HTTP em várias linguagens, incluindo PHP. Não é muito amigável, mas é funcional e flexível.

A requisição do tipo POST é feita para /abrigos, passando todos os detalhes do abrigo com json_encode(), ou seja, passando todas as informações como JSON para o endpoint.

Ao executar isso com curl_exec(), verificamos se o $statusCode, ou seja, o código de resposta, é menor que 400, indicando que não houve erro. Nesse caso, o sistema informa que o abrigo foi cadastrado com sucesso. Caso contrário, informa que houve um erro e mostra a resposta em $responseBody para poder entender o que aconteceu de errado.

else if ($opcaoEscolhida == 2) {
        echo "Digite o nome do abrigo:" . PHP_EOL;
        $nome = trim(fgets(STDIN));
        echo "Digite o telefone do abrigo:" . PHP_EOL;
        $telefone = trim(fgets(STDIN));
        echo "Digite o email do abrigo:" . PHP_EOL;
        $email = trim(fgets(STDIN));

        $abrigo = compact('nome', 'telefone', 'email');

        $curl = curl_init('https://66f610a1436827ced975d41f.mockapi.io/abrigos');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($abrigo));
        curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

        $responseBody = curl_exec($curl);
        $statusCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        if ($statusCode < 400) {
                echo "Abrigo cadastrado com sucesso!" . PHP_EOL;
        } else {
                echo "Erro ao cadastrar o abrigo:" . PHP_EOL;
                echo $responseBody . PHP_EOL;
        }
}

// código omitido…

Se a $opcaoEscolhida for a 3, o processo é semelhante à opção 1. Utilizando o ID do abrigo armazenado em $idOuNome, fazemos uma requisição do tipo GET para /abrigos/$idOuNome/pets.

Se não houver resposta, fazemos um if para indicar que o ID não foi cadastrado. Caso contrário, fazemos o json_decode() e o foreach para percorrer e exibir todos os animais.

else if ($opcaoEscolhida == 3) {
        echo "Digite o id do abrigo:" . PHP_EOL;
        $idOuNome = trim(fgets(STDIN));
        $response = @file_get_contents("https://66f610a1436827ced975d41f.mockapi.io/abrigos/$idOuNome/pets");
        if (!$response) {
                echo "Id não cadastrado!" . PHP_EOL;
                continue;
        }
        $jsonArray = json_decode($response, true);
        echo "Pets cadastrados:" . PHP_EOL;
        foreach ($jsonArray as $pet) {
                extract($pet);
                echo "$id - $tipo - $nome - $raca - $idade ano(s)" . PHP_EOL;
        }
}

// código omitido…

Na opção 4, pegamos o ID do abrigo e o nome do arquivo CSV e armazenamos em $idOuNome e $nomeArquivo. Em seguida, abrimos o arquivo com fopen() e fazemos outro loop while.

Para cada linha do arquivo, pegamos os $campos já parseados como CSV, criamos um array associativo de $pet com todas as informações de um animal e fazemos a requisição POST para /abrigos/$idOuNome/pets.

Depois, armazenamos o corpo da requisição em $responseBody e vericamos o $statusCode novamente com um if. Se for 201, o animal foi criado com sucesso. Se for 404, o abrigo não foi encontrado. Caso contrário, exibimos algum erro e mostramos a resposta.

else if ($opcaoEscolhida == 4) {
        echo "Digite o id do abrigo:" . PHP_EOL;
        $idOuNome = trim(fgets(STDIN));

        echo "Digite o nome do arquivo CSV:" . PHP_EOL;
        $nomeArquivo = trim(fgets(STDIN));

        $arquivo = fopen($nomeArquivo, 'r');
        while ($campos = fgetcsv($arquivo)) {
                $pet = [
                        'tipo' => $campos[0],
                        'nome' => $campos[1],
                        'raca' => $campos[2],
                        'idade' => $campos[3],
                        'cor' => $campos[4],
                        'peso' => $campos[5],
                ];
                $curl = curl_init("https://66f610a1436827ced975d41f.mockapi.io/abrigos/$idOuNome/pets");
                curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
                curl_setopt($curl, CURLOPT_POST, true);
                curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($pet));
                curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

                $responseBody = curl_exec($curl);
                $statusCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);

                if ($statusCode == 201) {
                        echo "Pet cadastrado com sucesso: $pet[nome]" . PHP_EOL;
                } else if ($statusCode == 404) {
                        echo "Id do abrigo não encontrado!" . PHP_EOL;
                        break;
                } else {
                        echo "$statusCode - Erro ao cadastrar o pet: $pet[nome]" . PHP_EOL;
                        echo $responseBody . PHP_EOL;
                        break;
                }
        }
}

// código omitido…

Se a $opcaoEscolhida for 5, simplesmente saímos do loop. Se a opção escolhida for outra, informamos que o número é inválido.

else if ($opcaoEscolhida == 5) {
        break;
} else {
        echo "NÚMERO INVÁLIDO!" . PHP_EOL;
        $opcaoEscolhida = 0;
}

Mais uma vez, saímos do loop e usamos um echo para exibir a frase "Finalizando o programa...". Se algum $erro ocorrer durante a execução, exibimos no catch.

try {
        do {
        // código omitido…

        } while ($opcaoEscolhida != 5);
        echo "Finalizando o programa..." . PHP_EOL;
} catch (Throwable $erro) {
        echo $erro->getMessage() . PHP_EOL;
}

O código está concentrado em um único arquivo. É um sistema simples, sem muita lógica, mas tudo está em um arquivo só.

Imagine que alguém precise implementar uma nova funcionalidade na lista de abrigos, como exibir o e-mail além do nome. Essa pessoa teria que ler parte por parte, entender que a opção 1 faz parte da listagem de abrigos e ainda não saberia se em outro ponto do sistema também listamos abrigos.

Esse código está de difícil leitura e manutenção. Por isso, vamos começar a fazer uma primeira refatoração.

Extraindo função de listar abrigos

Refatorar é modificar o código sem alterar o comportamento.

Por que mexer no código se o comportamento não muda? Se não vamos adicionar uma funcionalidade ou melhorar a performance? O objetivo é tornar o código mais legível e fácil de manter.

Existem várias técnicas de refatoração, inclusive, há um catálogo que disponibilizaremos para você conhecer essas várias técnicas.

Nesse momento, vamos aplicar uma das técnicas: pegar um pedaço de código e extrair para uma função. Dessa forma, podemos dar um nome para esse pedaço de código. Se em outros lugares precisarmos desse mesmo pedaço, já teremos uma função criada.

No primeiro if, onde verificamos se a $opcaoEscolhida é igual a 1, vamos selecionar todo o bloco de código, do $responseBody na linha 17 até o foreach na linha 24. Em seguida, pressionamos "Ctrl + X" para recortar esse pedaço de texto.

No final do arquivo, criamos uma nova função chamada function listarAbrigos(). Ela não recebe parâmetros e não tem retorno, então é void. Abrimos o corpo da função e colamos o pedaço de código removido com o atalho "Ctrl + V".

function listarAbrigos(): void
{
    $responseBody = file_get_contents('https://66f610a1436827ced975d41f.mockapi.io/abrigos');
    $jsonArray = json_decode($responseBody, true);
    echo "Abrigos cadastrados:" . PHP_EOL;
    foreach ($jsonArray as $abrigo) {
        $id = $abrigo['id'];
        $nome = $abrigo['nome'];
        echo "$id - $nome" . PHP_EOL;
    }
}

Feito isso, voltamos à linha 17 e chamamos a função listarAbrigos() dentro do if.

if ($opcaoEscolhida == 1) {
        listarAbrigos();
}

// código omitido…

Salvamos o arquivo e executamos o programa para garantir que tudo continua funcionando, que a listagem de abrigos está correta.

No terminal, executamos novamente php projeto-inicial.php para exibir o menu do sistema Adopet Console. Como queremos verificar se a primeira opção continua funcionando, pressionamos 1 e damos "Enter". A listagem de abrigos é exibida corretamente. Portanto, podemos pressionar 5 para sair.

Próximos passos

Com isso, temos um código mais enxuto para ler na primeira opção. Inclusive, esse código tem um nome. Assim, rapidamente sabemos que ao digitar 1, listaremos abrigos. Não precisamos ler um bloco de código inteiro. Sabemos o que ele faz, mesmo sem saber como. Isso ajuda na leitura.

Essa é uma das técnicas de refatoração: extrair uma função (ou método, no caso de orientação a objetos).

Desafio: Faça o mesmo processo de refatoração para as outras opções do menu. Extrai o código de cada um dos if para uma nova função, como cadastrarAbrigo(), cadastrarPet(), listarPet(), etc.

No próximo vídeo, implementaremos exatamente essa extração de funções. Se você estiver confiante, pode pular o próximo vídeo. Caso contrário, confira para garantir que a extração foi feita da mesma forma.

Refatoração - Extraindo funções

Vamos aplicar a técnica de extração de função, uma técnica de refatoração, nas demais opções do sistema da Adopet. Temos quatro opções, e uma já foi extraída. Falta extrair as outras três funções.

Extraindo função de cadastrar abrigo

A segunda opção serve para cadastrar o abrigo de animais de estimação. Selecionamos o trecho de código, que está dentro do else if onde verificamos se a $opcaoEscolhida é igual a 2. No nosso caso, recortamos da linha 19 até a linha 41.

No else if, já chamamos a função que será denominada cadastrarAbrigo().

projeto-inicial.php:

else if ($opcaoEscolhida == 2) {
        cadastrarAbrigo();
}

No final do arquivo, vamos criar uma nova function chamada cadastrarAbrigo() que não retornará nada, ou seja, void. Nela, colamos todo o código.

function cadastrarAbrigo(): void
{
    echo "Digite o nome do abrigo:" . PHP_EOL;
    $nome = trim(fgets(STDIN));
    echo "Digite o telefone do abrigo:" . PHP_EOL;
    $telefone = trim(fgets(STDIN));
    echo "Digite o email do abrigo:" . PHP_EOL;
    $email = trim(fgets(STDIN));

    $abrigo = compact('nome', 'telefone', 'email');

    $curl = curl_init('https://66f610a1436827ced975d41f.mockapi.io/abrigos');
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($abrigo));
    curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

    $responseBody = curl_exec($curl);
    $statusCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    if ($statusCode < 400) {
        echo "Abrigo cadastrado com sucesso!" . PHP_EOL;
    } else {
        echo "Erro ao cadastrar o abrigo:" . PHP_EOL;
        echo $responseBody . PHP_EOL;
    }
}

Existem várias abordagens que poderíamos seguir. Uma delas, seria fazer a exibição das frases e recuperação dos dados do terminal no programa principal, enquanto a função cadastrarAbrigo() poderia receber esses parâmetros.

Isso seria até mais interessante, mas vamos por partes. Primeiro, vamos extrair todo o código para fazer refatorações menores. Caso você tenha feito dessa forma no desafio, saiba que preferimos a forma que você fez e você pode mantê-la.

Extraindo função de listar animais de abrigo

Continuando, agora vamos para a parte de listagem de pets do abrigo. Para isso, recortamos todo o código do else if, onde verificamos se $opcaoEscolhida é igual a 3. Vamos extrai-lo para listarPetsDeAbrigo().

else if ($opcaoEscolhida == 3) {
        listarPetsDeAbrigo();
}

No final do arquivo, vamos criar uma nova função, listarPetsDeAbrigo(), que também não retorna nada, e incluímos todo o código.

Note que haverá um erro no if. Se o abrigo não for encontrado, temos um continue dentro do código, que seria para continuar o loop. Mas agora essa função não está dentro de um loop.

Então, vamos comentar essa linha para que o código não gere erro de compilação. No entanto, isso pode gerar um erro na execução, mas lidaremos com isso mais adiante.

function listarPetsDeAbrigo(): void
{
    echo "Digite o id do abrigo:" . PHP_EOL;
    $idOuNome = trim(fgets(STDIN));
    $response = @file_get_contents("https://66f610a1436827ced975d41f.mockapi.io/abrigos/$idOuNome/pets");
    if (!$response) {
        echo "Id não cadastrado!" . PHP_EOL;
        // continue;
    }
    $jsonArray = json_decode($response, true);
    echo "Pets cadastrados:" . PHP_EOL;
    foreach ($jsonArray as $pet) {
        extract($pet);
        echo "$id - $tipo - $nome - $raca - $idade ano(s)" . PHP_EOL;
    }
}

Estamos fazendo uma refatoração inadequada, pois estamos modificando o comportamento e causando um erro, mas é proposital. Mais adiante no curso, entenderemos o motivo disso.

Extraindo função de importar animais

Também vamos extrair uma função para fazer a importação dos animais de estimação. Basta recortar o código do else if, onde verificamos se $opcaoEscolhida é igual a 4. Chamaremos essa função de importarPets().

else if ($opcaoEscolhida == 4) {
        importarPets();
}

No final do arquivo, vamos criar a function importarPets(), que não retorna nada. Dentro dela, colamos o código recortado.

function importarPets(): void
{
    echo "Digite o id do abrigo:" . PHP_EOL;
    $idOuNome = trim(fgets(STDIN));

    echo "Digite o nome do arquivo CSV:" . PHP_EOL;
    $nomeArquivo = trim(fgets(STDIN));

    $arquivo = fopen($nomeArquivo, 'r');
    while ($campos = fgetcsv($arquivo)) {
        $pet = [
            'tipo' => $campos[0],
            'nome' => $campos[1],
            'raca' => $campos[2],
            'idade' => $campos[3],
            'cor' => $campos[4],
            'peso' => $campos[5],
        ];
        $curl = curl_init("https://66f610a1436827ced975d41f.mockapi.io/abrigos/$idOuNome/pets");
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($pet));
        curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

        $responseBody = curl_exec($curl);
        $statusCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);

        if ($statusCode == 201) {
            echo "Pet cadastrado com sucesso: $pet[nome]" . PHP_EOL;
        } else if ($statusCode == 404) {
            echo "Id do abrigo não encontrado!" . PHP_EOL;
            break;
        } else {
            echo "$statusCode - Erro ao cadastrar o pet: $pet[nome]" . PHP_EOL;
            echo $responseBody . PHP_EOL;
            break;
        }
    }
}

Lendo o projeto

Com isso, vamos ler novamente a parte principal do nosso programa. No loop do-while, temos o menu inicial com os comandos echo. Inclusive, poderíamos extrair isso para uma função chamada menu(). Fica a critério de cada um fazer isso ou não.

Em seguida, recuperamos a $opcaoEscolhida. Se a opção escolhida for 1, chamamos a função listarAbrigos(). Se for 2, chamamos cadastrarAbrigo(). Se for 3, listarPetsDeAbrigo(). E se for 4, importarPets(). As demais opções não precisam ser refatoradas, pois são apenas uma ou duas linhas.

try {
    do {
        echo "\nDIGITE O NÚMERO DA OPERAÇÃO DESEJADA:" . PHP_EOL;
        echo "1 -> Listar abrigos cadastrados" . PHP_EOL;
        echo "2 -> Cadastrar novo abrigo" . PHP_EOL;
        echo "3 -> Listar pets do abrigo" . PHP_EOL;
        echo "4 -> Importar pets do abrigo" . PHP_EOL;
        echo "5 -> Sair" . PHP_EOL;

        $opcaoEscolhida = trim(fgets(STDIN));

        if ($opcaoEscolhida == 1) {
            listarAbrigos();
        } else if ($opcaoEscolhida == 2) {
            cadastrarAbrigo();
        } else if ($opcaoEscolhida == 3) {
            listarPetsDeAbrigo();
        } else if ($opcaoEscolhida == 4) {
            importarPets();
        } else if ($opcaoEscolhida == 5) {
            break;
        } else {
            echo "NÚMERO INVÁLIDO!" . PHP_EOL;
            $opcaoEscolhida = 0;
        }
    } while ($opcaoEscolhida != 5);
    echo "Finalizando o programa..." . PHP_EOL;
} catch (Throwable $erro) {
    echo $erro->getMessage() . PHP_EOL;
}

Note que, ao observar o loop do programa principal, que seria uma função main em outras linguagens, temos um código mais sucinto e fácil de ler. Mesmo que o comportamento não tenha sido alterado, fica mais fácil dar manutenção em um sistema com essa organização.

Caso desejemos, podemos extrair cada função para um arquivo ou ter um arquivo de funções. Isso seria interessante e organizaria ainda mais. Não faremos isso porque, em algum momento, essas funções serão movidas para outro lugar de outra forma.

Mas, se você quiser, pode extrair cada função para um arquivo ou todas para um único arquivo, utilizando o autoloader do Composer para fazer um único require. Isso é opcional.

Testando o código

Sempre que realizamos uma refatoração, precisamos executar o código para garantir que não mudamos o comportamento. Por isso, vamos executar o projeto-inicial.php no terminal:

php projeto-inicial.php

Usamos a opção 1 para listar os abrigos e a opção 3 para listar os pets desse abrigo.

Poderíamos testar o cadastro de novo abrigo e a importação de animais com as opções 2 e 4, respectivamente, mas isso geraria dados duplicados. Se você quiser fazer isso, uma dica é zerar os dados da API.

Para isso, vamos acessar o site mockapi.io onde criamos nossa API e atualizar a página. Na API Abrigos, temos apenas um abrigo cadastrado e oito pets, exatamente o que cadastramos e importamos anteriormente. Podemos zerar todos os dados, clicando no botão "Reset all".

Ou, se você preferir, pode cadastrar um novo abrigo e importar os mesmos pets em outro abrigo.

Dessa forma, nos asseguramos que a aplicação está funcionando após a refatoração. Por fim, podemos apertar 5 para sair do sistema.

Próximos passos

Dica: Você pode usar o atalho "Ctrl + clique" na chamada de uma função para ser redirecionado ao código de declaração dessa função.

Na função cadastrarAbrigo(), temos um trecho de código que faz uma requisição do tipo POST. Essa requisição pode ter um corpo e um status code. Em importarPets(), temos várias requisições do tipo POST dentro de um loop, também com um corpo de requisição e um status code.

Note que isso é um código duplicado. A cURL, uma extensão para realizar requisições HTTP, tanto com PHP quanto com outras linguagens, não é muito amigável. Precisamos chamar uma função para iniciar, outra para definir opções e outra para executar. Como isso não é muito claro, é preciso consultar a documentação para entender cada parte.

Existem componentes em PHP que tornam isso mais interessante. Se quisermos usar um desses componentes com o PHP Composer, por exemplo, precisaríamos modificar tanto em importarPets() quanto em cadastrarAbrigos().

Sempre que precisamos mudar algo em vários lugares, isso é conhecido como bad smell ou code smell, ou seja, um mau cheiro no código.

Um mau cheiro indica que algo pode ser melhorado. É comum realizar uma refatoração e identificar um novo bad smell no código.

Assim como existe um catálogo de técnicas de refatorações, há um catálogo de bad smells. Um desses indicativos de que algo pode ser melhorado no código é ter código duplicado, ou seja, código que está em mais de um lugar.

No próximo vídeo, vamos lidar com esse mau cheiro com uma técnica de refatoração. Para isso, vamos extrair uma nova função para fazer requisições do tipo POST.

Sobre o curso PHP: aplicando boas práticas de código

O curso PHP: aplicando boas práticas de código possui 144 minutos de vídeos, em um total de 43 atividades. Gostou? Conheça nossos outros cursos de PHP em Programação, ou leia nossos artigos de Programação.

Matricule-se e comece a estudar com a gente hoje! Conheça outros tópicos abordados durante o curso:

Aprenda PHP acessando integralmente esse e outros cursos, comece hoje!

Conheça os Planos para Empresas