Integrando o Framework Codeigniter 3 com o PHPUnit via composer

Olá pessoal, nesse post eu trago para vocês o passo a passo de como integrar o Codeigniter 3 com o PhpUnit que é uma framework de testes unitários para PHP.

Como pré requisitos precisamos de:

Baixar o codeigniter 3: https://codeigniter.com/download
Ter xampp instalado e startado: https://www.apachefriends.org/index.html
Ter o composer instalado: https://getcomposer.org/download/
Ter um editor de código: https://code.visualstudio.com/

Para dar inicio a configuração do PhpUnit, precisamos abrir a pasta do codeigniter com algum editor de código, no meu caso vou utilizar o VSCode.

Com o projeto aberto vamos iniciar o terminal do Vscode ou o terminal do sistema operacional que você está utilizando.

Antes de seguir com os próximos passos, vale ressaltar que eu estou iniciando uma configuração do zero, com o framework do codeigniter totalmente limpa, caso a sua não seja assim vou deixar algumas instruções para isso.

Para quem está iniciando do zero, o arquivo que se encontra na raiz do projeto chamado 'composer.json' tem uma diretiva chamada require-dev e como conteúdo tem o parâmetro do phpunit setado como default.

então caso o seu esteja assim, basta executar o comando a seguir do composer para instalar todas as diretivas e bibliotecas que o codeigniter precisa:

composer install

**Caso já tenha um projeto em andamento, conferir se existe um arquivo de composer.json, caso não exista basta criar um com o seguinte comando: composer init. 

Se o seu projeto já tem um arquivo composer.json, verificar se existe a chamada para o phpunit, caso não exista executar o seguinte comando:

compose require --dev phpunit/phpunit ^versao (lembrar que a versão é definida conforme a versão que se encontra o seu php então vale a pena conferir a página oficial do PHPUnit)

então, após executar o comando de require, pode executar o comando: composer install para que o sistema instale todos os requerimentos necessários.

Pode-se notar que na raiz do projeto foi criado uma pasta chamada vendor, onde dentro dela está setada todas as bibliotecas que o codeigniter usa e necessita para o funcionamento de algumas funcionalidades.

Agora podemos ir para o próximo passo que é criar uma pasta chamada 'tests' dentro da pasta 'application' do codeigniter.

Após criar a pasta, vamos seguir para o site do github destinado a integração do codeigniter 3 com o phpunit. 

acessse: https://github.com/kenjis/ci-phpunit-test

Esse site destina-se a explicar como se instala, configura e executa alguns testes básicos com o phpunit dentro do codeigniter, no nosso caso vamos até a parte que mostra Instalation, onde vamos poder baixar alguns arquivos para colocar dentro da pasta tests que criamos no passo anterior.

acesse: https://github.com/kenjis/ci-phpunit-test/releases

Baixe a ultima versão que é a 3.0.3 na versão zip.

Após efetuar o download, descompactar o arquivo, vamos abrir a pasta descompactada, ir até application, depois entrar na pasta tests e copiar todos os arquivos.

Agora vamos até a pasta tests que criamos no nosso projeto e colar dentro dela todos os arquivos copiados da etapa anterior.

Pronto, agora podemos abrir o terminal e executar o seguinte comando para verificar se a configuração deu certo:

vendor/bin/phpunit -c application/tests/

Se no seu terminal aparecer dessa forma é porque a integração deu certo e já pode começar a executar os testes dentro do seu sistema. 

**Existe um warning informando que não tem um driver disponível para execução do teste de cobertura, caso o seu esteja assim veja o post relacionado a como instalar o xdebug que é um driver de debug do PHP para executar testes e criar um relatório de cobertura.