Testes Unitários
Uma vez que o framework de testes do Yii é construído em cima do PHPUnit, é recomendado que você primeiro consulte sua documentação para entender o básico sobre como escrever um teste unitário. Nós resumimos a seguir os princípios básicos de escrita de um teste unitário no Yii:
Um teste unitário é escrito em termos de uma classe
XyzTestque estende de CTestCase ou CDbTestCase, ondeXyzrepresenta a classe sendo testada. Por exemplo, para testar a classePost, por convenção devemos chamar a classe de teste unitário correspondente dePostTest. A classe-mãe CTestCase é destinada para testes unitários genéricos, enquanto a CDbTestCase é adequada para testar classes de modelo active record. Já quePHPUnit_Framework_TestCaseé a classe-mãe de ambas as classes, nós podemos usar todos os métodos herdados desta classe.A classe de teste unitário é salva em um arquivo PHP chamado de
XyzTest.php. Por convenção, o arquivo de teste unitário pode ser armazenado no diretórioprotected/tests/unit.A classe de teste contém na maior parte um conjunto de métodos de teste chamados como
testAbc, ondeAbcgeralmente é o nome do método da classe que será testado.Um método de teste geralmente contém uma série de métodos de asserção (por exemplo,
assertTrue,assertEquals) que servem como checkpoints ao validar o comportamento da classe alvo.
A seguir, descrevemos principalmente como escrever testes unitários para classes de modelo active record. Estenderemos as nossas classes de CDbTestCase porque ela fornece o suporte às fixtures de banco de dados que introduzimos na seção anterior.
Suponha que queremos testar a classe do modelo Comment (comentário) no
exemplo de blog. Começamos criando
uma classe chamada de CommentTest e a salvando como
protected/tests/unit/CommentTest.php:
Nesta classe, especificamos o atributo fixtures como um array que especifica
quais fixtures serão usadas por este teste. O array representa um mapeamento
dos nomes das fixtures aos nomes das classes de modelo ou aos nomes das tabelas
das fixtures (por exemplo, do nome de fixture posts para a classe de modelo
Post). Note que ao mapear para nomes de tabelas de fixtures, devemos prefixar
o nome da tabela com dois pontos (por exemplo, :Post) para diferenciá-lo dos
nomes de classe de modelo. E ao usar nomes de classes de modelo, as tabelas
correspondentes serão consideradas como tabelas de fixtures. Conforme
descrevemos anteriormente, as tabelas das fixtures serão resetadas a algum
estado conhecido toda vez que um método de teste for executado.
Os nomes das fixtures nos permitem acessar os seus dados nos métodos de teste de uma maneira conveniente. O código a seguir demonstra a sua típica utilização:
Nota: Se uma fixture for declarada usando seu nome de tabela (por exemplo,
'posts'=>':Post'), então o terceiro uso acima não é válido porque nós não temos informações sobre com qual classe de modelo a tabela está associada.
Em seguida, escrevemos o método testApprove para testar o método approve na
classe de modelo Comment. O código é bastante claro: primeiro inserimos um
comentário de status pendente; então verificamos que este comentário está em
status pendente retornando ele do banco de dados; e finalmente chamamos o método
approve e verificamos se o status mudou conforme o esperado.