Convenções para executar testes remotos em PHP

Justificativa: ambientes legados (PHP 5.6 e anteriores) não conseguem rodar bibliotecas de testes utitários. Também é inviável simular esses ambientes legados em ambientes locais de desenvolvimento pois normalmente incluem, por exemplo, algum banco de dados antigo, SO antigos, etc. Estas convenções são somente um facilitador para que mesmo nesses ambientes inóspitos seja possível ter código testável rapidamente com um único comando.

Na raiz do projeto crie um diretório chamado tests e adicione seus arquivos de testes dentro. Os arquivos devem inicar com o nome test para que o executor saiba qual arquivo deve ser executado.

Dentro do diretório tests clone este repositório com o comando:

git clone https://github.com/mmannes/cqTester

Para conseguir rodar os testes diretamente no Visual Studio Code copie o arquivo launch.json para o diretório .vscode da raiz do projeto e altere o endereço https://dev.remote.address.com para a URL válida do projeto.

Um teste passa quando não produz nenhuma saída. Sempre que um teste imprimir algo ele é considerado falho.

A classe cqTest pode ser extendida para criar uma classe de testes com algumas funcionalidades como:

• Fazer com que a função assert() atire uma Exception com detalhes do runtime
• Executar automaticamente os métodos da classe cujos nomes iniciam com test
• Uma função setup para incluir tudo o que é necessário para o teste executar (autenticação, includes, requires, etc)

Vide https://github.com/mmannes/cqTester/blob/main/exemplo_cqTester.php