Uma fixture é o conjunto de entradas e condições preparado para executar um teste de software. Ela estabelece o estado inicial sobre o qual o código será exercitado, como uma assinatura vencida usada para verificar a recusa de acesso.
A preparação dá ao teste uma condição conhecida. Depois dela, o teste chama o código e compara o resultado com o comportamento esperado. Uma assinatura válida no lugar de uma vencida muda o caso testado, mesmo que a verificação final continue esperando uma recusa.
Uma assinatura com vencimento conhecido
Neste exemplo didático, a consulta de acesso recebe uma assinatura com término em 10 de novembro de 2026. O relógio usado pelo código está fixado em 16 de novembro de 2026. A fixture reúne essa assinatura e a condição de tempo necessária para que ela seja tratada como vencida.
O teste executa a consulta e espera receber a recusa de acesso. Fixar o relógio mantém a relação entre as datas quando o teste roda em outro dia. Esse caso verifica o vencimento já ocorrido, mas exige outro teste para conferir a validade exatamente no instante de término.
Reutilizar a preparação sem herdar alterações
No PHPUnit, o método setUp() pode criar a fixture para cada método de teste. O método tearDown() permite limpar recursos externos usados pelo caso, como um arquivo aberto durante a preparação. A documentação prevê essa limpeza tanto após um teste bem-sucedido quanto após uma falha.
Você pode reutilizar o código de preparação e ainda criar objetos novos em cada execução. Quando dois testes recebem o mesmo objeto mutável, uma alteração feita pelo primeiro pode mudar o resultado do segundo. Ao investigar um teste que só falha depois de outro, confira se a preparação restaura o estado necessário ao caso.
Dúvidas frequentes
Perguntas frequentes sobre fixture
- Fixture precisa ser um arquivo de entrada?
- Ela pode ser um objeto em memória ou incluir recursos externos, como uma tabela preparada para o teste. O formato depende das condições necessárias para executar o caso.
- Como um mock participa da fixture?
- Um mock substitui um objeto colaborador e permite verificar as interações esperadas. Ele pode integrar a preparação do teste, junto com os objetos e valores necessários ao caso.
- Reutilizar a preparação significa compartilhar os mesmos objetos?
- Você pode executar a mesma função de preparação para criar objetos novos a cada teste. Compartilhar um objeto mutável exige restaurar o estado, pois um teste pode alterar a entrada do seguinte.
Para continuar
Recursos relacionados
Documentação
PHPUnit: fixtures
Explica como o PHPUnit prepara e limpa fixtures, incluindo os efeitos do compartilhamento de estado entre testes.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão de orientação técnica ao vivo para revisar a preparação dos testes e investigar falhas que dependem do estado inicial.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Os testes precisam de entradas preparadas que permitam repetir a verificação do comportamento esperado.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.