TDD em PHP: como testes transformam código em arte

Introdução: por que seu código merece respeito (e testes)

Imagine: você escreve um código, ele funciona, tudo perfeito. Mas um mês depois, você volta ao projeto, adiciona uma nova funcionalidade — e de repente tudo quebra. Familiar? Se sim, o TDD em PHP é exatamente o que você precisa. O Desenvolvimento Guiado por Testes (Test-Driven Development) não é apenas uma tendência da moda, mas uma filosofia que transforma sua relação com o código. Neste artigo, vamos explorar como o TDD transforma o caos em ordem e os bugs em relíquias do passado. Você aprenderá a escrever testes em PHP que realmente economizam tempo, com exemplos práticos de código. Vamos nessa!

O que é TDD e por que você precisa dele em PHP?

TDD em PHP é uma metodologia onde você primeiro escreve o teste, e depois o código que passa nesse teste. Parece estranho? Na verdade, é genial. Em vez de adivinhar se seu código funciona, você recebe feedback instantâneo. Os princípios básicos do TDD são:

\n
• Vermelho — escreva um teste que falha (porque o código ainda não foi escrito).
\n
• Verde — escreva o código mínimo necessário para o teste passar.
\n
• Refatoração — melhore o código sem quebrar os testes.
\n

Esse ciclo se repete continuamente. Em PHP, o TDD é especialmente útil porque a linguagem é muito usada em aplicações web, onde erros podem custar caro. Testes com PHPUnit (o principal framework de testes) ajudam a evitar regressões e tornam o código mais transparente. Além disso, o TDD disciplina: você começa a pensar no design antes mesmo de escrever o código.

Configurando o ambiente para testes em PHP

Antes de mergulharmos nos exemplos, vamos preparar o ambiente. Para o desenvolvimento guiado por testes em PHP, precisamos do PHPUnit. A instalação é simples:

composer require --dev phpunit/phpunit ^10

Crie uma pasta tests na raiz do projeto. Dentro dela, crie o arquivo CalculatorTest.php. Certifique-se de ter o PHP 8.0+ instalado. Agora tudo está pronto para o primeiro teste.

Primeiro teste: construindo uma calculadora com TDD

Vamos criar uma calculadora simples. Primeiro, o teste. Este é um exemplo clássico de TDD PHP para iniciantes.

Passo 1: Vermelho (escrevendo um teste que falha)

Crie o arquivo tests/CalculatorTest.php:

<?php\n\nuse PHPUnit\\Framework\\TestCase;\n\nclass CalculatorTest extends TestCase\n{\n    public function testAddition()\n    {\n        $calculator = new Calculator();\n        $result = $calculator->add(2, 3);\n        $this->assertEquals(5, $result);\n    }\n}

Execute o teste:

./vendor/bin/phpunit tests/CalculatorTest.php

Espere um erro: Class "Calculator" not found. Tudo dentro do planejado — esta é a fase vermelha.

Passo 2: Verde (escrevendo o código mínimo)

Crie o arquivo src/Calculator.php:

<?php\n\nclass Calculator\n{\n    public function add(int $a, int $b): int\n    {\n        return $a + $b;\n    }\n}

Não se esqueça de incluir o autoload no teste:

require_once __DIR__ . '/../src/Calculator.php';

Execute o teste novamente — verde! Agora, a refatoração. Nesta fase, o código é simples, mas depois você poderá melhorá-lo sem medo de quebrar algo.

Passo 3: Refatoração com confiança

Suponha que queiramos adicionar uma verificação de tipos. Alteramos o código:

public function add(int $a, int $b): int\n{\n    if (!is_int($a) || !is_int($b)) {\n        throw new InvalidArgumentException('Only integers allowed');\n    }\n    return $a + $b;\n}

Execute os testes novamente — eles ainda passam. O TDD lhe dá coragem para experimentar.

TDD Avançado: trabalhando com exceções e mocks

Depois de dominar o básico, avance para cenários mais complexos. Por exemplo, testar exceções. Em testes unitários PHP, isso é