Testes de integração com PHP: testando o acesso à API e ao banco de dados

Testando o banco de dados - Introdução

Boas-vindas à Alura. Meu nome é Vinicius Dias e vou guiar vocês durante esse treinamento de introdução aos testes de integração com PHP. Primeiro, vamos conversar um pouco sobre o que são os testes de integração e porque realizar esse tipo de teste.

Porque iríamos querer fazer um teste que acessa o banco de dados, por exemplo, se o banco de dados não fomos nós quem criamos. Não precisamos testar o sistema do banco de dados. Vamos conversar bastante sobre isso. Enquanto converso sobre isso, vamos implementar alguns testes e descobrir problemas quando fazemos testes acessando o banco de dados, quando fazemos testes de integração no geral.

Uma das soluções que encontramos para o problema de inserção duplicada foi remover todos os dados. Depois vimos sobre transações. Vamos ver como levantar um banco de dados inteiro em memória, ou seja, sem acessar o disco para otimizar a performance dos nossos testes. Vamos conversar também um pouco sobre um assunto polêmico que é quebrar aquele padrão de arrage, act e assert ou Given when then para realizar alguns testes intermediários antes do bloco de assert.

Isso é um pouco polêmico, mas vamos bater um papo sobre isso. No final de tudo, de bônus, ainda vamos fazer alguns outros testes de integração sem utilizar o banco de dados. Então vamos, no final de tudo, ter alguns testes de uma API que vamos disponibilizar. Algo bem simples. Não é uma API completa, mas vamos ver o que é um teste de API e como realizar.

E não só com o PHP fazendo, vamos também utilizar o Postman para gerar alguns testes. Vamos criar alguns testes, executar e ver eles passando e entender como se cria um teste no Postman e quais as possibilidades para automatizar testes utilizando essa ferramenta que é o Postman.

Então espero que você esteja preparado para começar esse treinamento e no próximo vídeo já vamos começar a preparar o nosso ambiente e discutir o que é necessário ter na sua máquina para que você continue o treinamento. Se durante esse curso você tiver qualquer dúvida, não hesite, abra uma dúvida no fórum, abra um tópico no fórum.

Sempre tento responder pessoalmente. Infelizmente não consigo todas às vezes. Mas quando eu não consigo responder pessoalmente, a nossa comunidade é muito solícita e com certeza alguém já passou pelo mesmo problema que você e vai poder te ajudar. Então espero que você tire bastante proveito e até o próximo vídeo para começarmos a conversar sobre esse treinamento que vai ser bastante interessante.

Testando o banco de dados - Preparando o ambiente

Vamos configurar o nosso ambiente para poder continuar esse treinamento. Se você acabou de fazer os treinamentos anteriores sobre testes na Alura, você já tem praticamente tudo configurado. Pode até pular esse vídeo e partir para o próximo onde vamos começar a conversar sobre os testes atuais.

Mas se você está começando por esse treinamento e já tem algum tempo que fez o antigo e baixou o projeto inicial agora, vamos lá, passo a passo sobre o que temos que fazer. Primeiro, obviamente você precisa do PHP e do Composer instalado.

Com isso, vamos acessar o terminal na pasta do projeto e vamos digitar composer install. Esse comando vai instalar todas as dependências que estão definidas no Composer Json. No meu caso já estão instaladas, então foi rápido.

Mas no seu caso você vai baixar o PHP Unit. Basicamente só isso. O próximo passo é, repara que temos um arquivo de banco de dados em "sqlite". Então só para fazermos alguns testes, algumas verificações, vamos configurar no PhpStorm uma conexão com esse "sqlite".

Então vou clicar em "Database" aqui no canto direito, clicar em "+ > Data Source > SQLite". Vou criar uma nova conexão com o banco SQLite, vou clicar nos três pontos, pasta do projeto e seleciono o "banco.sqlite". Posso clicar em "Testar conexão".

Se for a primeira vez que você se conecta com o banco de dados SQLite utilizando o PhpStorm, ele vai te apresentar um botão para você baixar esse drive. Mas é automático, clicou, ele já instala e configura para você.

No meu caso já está conectado. Vou aplicar e dar "OK". Automaticamente, ele abre um arquivo onde podemos fazer alguns SQLs. Mas caso você já tenha a conexão configurada e queira abrir esse arquivo depois, é só vir em "Scratches and Consoles" e "Database Consoles". Aqui você vai selecionar sua conexão e abrir o arquivo de console.

Aqui podemos fazer um select, por exemplo, de todos os leilões SELECT * FROM leiloes;. No caso, se tudo estiver correto, deve estar vazio. Você está com o banco de dados vazio. Agora já temos o nosso ambiente configurado. Inclusive, se eu rodar vendor\bin\phpunit, os meus testes devem rodar e funcionar. Deve estar tudo configurado para o próximo vídeo começarmos a conversar sobre o que já temos de teste até agora. Te espero lá.

Testando o banco de dados - Por que testar o banco de dados

Vamos fechar esse monte de janela. Já vimos que todos os nossos testes estão ok, estão passando. Vamos abrir na nossa pasta de "src" o arquivo de "Dao > Leilao.php", de Data Access Object. Ou seja, é uma classe que faz a persistência e a busca no banco de dados. Faz o acesso ao banco utilizando o modelo de leilão.

Fizemos alguns testes, inclusive no "EncerradorTest" que utiliza esse Dao. Verificávamos, por exemplo, se os leilões foram encerrados realmente. Esse tipo de coisa. E se analisamos o código do nosso encerrador, esse encerrador utiliza alguns métodos do "leilaoDao", como, por exemplo, recuperarNaoFinalizados. Então vamos ver como esse método está se comportando, o recuperarNaoFinalizados.

Esse método chama um outro, recuperarLeiloesSeFinalizado for false. Beleza, olhei aqui. E quando analiso esse método ele faz um sql onde busca todos os leilões, onde finalizado é igual a 1 ou 0, ou seja, verdadeiro ou falso.

Busca por todos esses leilões e para cada um dos leilões cria um modelo em si, a classe do tipo leilão e marca ele como finalizado caso esteja. Aparentemente é um método tranquilo. Já foi testado pelo nosso "EncerradorTest". Mas se você analisar com calma, esse sql está errado.

Aqui eu preciso informar quais campos quero buscar, por exemplo, select all from, select * from ou os campos individualmente. Então tenho um erro no meu código. Se esse código for para a produção ele não vai funcionar. Só que os nossos testes estão passando.

"Mas Vinicius, como assim? Os nossos testes são muito frágeis? Os testes que fizemos não garantem que o nosso código esteja funcionando?" Aí é que está. Trabalhamos até hoje com um tipo de teste chamado de "testes de unidade" onde só testamos uma unidade do nosso código. Ou seja, um método ou uma classe apenas.

Esse tipo de teste para verificar que alguma coisa esteja errada, precisaria fazer um teste onde o meu sistema se integrasse com o banco de dados para executar essa query efetivamente e garantir que está tudo funcionando. Então esse outro tipo de teste é chamado de "teste de integração".

E a diferença entre um e outro é que nos testes de unidade só testamos uma unidade do código, enquanto nos testes de integração podemos testar mais partes do nosso código. Ou seja, a integração entre uma classe e outra, a integração entre um módulo e outro. Ou como é mais comum testarmos a integração entre o nosso código, entre o nosso sistema e o sistema externo, como, por exemplo, o de banco de dados, o sistema do SQLite.

Esse arquivo do SQLite, um banco de dados ou um sistema de enviar e-mail, um sistema de filas, qualquer sistema externo, uma API, alguma coisa desse tipo. Então para que esse teste falhasse e percebêssemos esse erro, testes de unidade não funcionam. Fazer mock dos leilões, fazer mock do leilaoDao não funciona, não atende as nossas necessidades de teste.

Então o que precisamos fazer agora, que é exatamente o que vamos durante esse curso, é testar a integração entre o nosso sistema e o banco de dados. Fazer a execução de SQLs lá no banco também. Testar realmente a funcionalidade das coisas e não só criar testes que testam somente o código. O que quero no nosso primeiro passo é criar algum teste que faça isso falhar, que mostre que esse erro existe. Vamos começar a colocar a mão na massa no próximo vídeo.

Sobre o curso Testes de integração com PHP: testando o acesso à API e ao banco de dados

O curso Testes de integração com PHP: testando o acesso à API e ao banco de dados possui 95 minutos de vídeos, em um total de 40 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:

• Testando o banco de dados
• Garantindo a integridade
• Testes intermediários
• Testando a alteração
• Bônus: Testando APIs