O que é o PHPSpec?
O PHPSpec é um framework de teste baseado em comportamento (BDD), escrito em PHP. Com o PHPSpec, podemos escrever especificações que descrevem o comportamento esperado de nossos objetos e testá-los, verificando se eles cumprem essas expectativas. O PHPSpec permite que o desenvolvedor especifique o comportamento de um objeto antes mesmo de implementá-lo, tornando-se uma excelente ferramenta para a prática do Desenvolvimento Orientado a Comportamento (BDD).
Por que usar o PHPSpec?
O PHPSpec nos permite escrever especificações e testes em uma linguagem clara e simples, em vez de focar em detalhes técnicos. Com o PHPSpec, podemos definir o comportamento esperado de nossos objetos, o que nos ajuda a entender melhor o que estamos construindo e a escrever um código de qualidade. O PHPSpec também nos ajuda a manter nossa base de código limpa, ao evitar testes confusos ou redundantes.
Qual a diferença entre o PHPSpec e o PHPUnit?
O PHPUnit é uma estrutura de teste popular para PHP que se concentra em testes de unidade. Embora o PHPSpec também possa ser usado para testes de unidade, ele segue uma abordagem diferente – BDD. O PHPSpec concentra-se em descrever especificações que descrevem o comportamento esperado dos objetos, e testá-los, em vez de testes de unidade tradicionais. O PHPUnit é uma ótima escolha para escrever testes de unidade voltados para as funcionalidades do nosso sistema, e o PHPSpec é uma ótima escolha para escrever testes orientados a comportamento.
Como instalar o PHPSpec?
Para instalar o PHPSpec, primeiro precisamos ter o Composer instalado em nosso sistema. Em seguida, podemos criar um novo projeto adicionando o PHPSpec como uma dependência:
composer require phpspec/phpspec --devIsso irá instalar o PHPSpec e adicioná-lo ao nosso arquivo composer.json como uma dependência de desenvolvimento. Precisamos então criar o arquivo phpspec.yml com o seguinte comando:
phpspec initCom isso, estamos prontos para começar a escrever especificações e testes em nosso projeto.
Como escrever uma especificação no PHPSpec?
Para escrever uma especificação no PHPSpec, precisamos criar uma classe de especificação. Podemos fazer isso executando o seguinte comando:
phpspec describe NomeDaClasseIsso irá criar um arquivo de especificação NomeDaClasseSpec.php em nosso diretório spec/. Nesse arquivo, podemos escrever nossas especificações usando a linguagem de especificação do PHPSpec. Isso geralmente envolve definir o comportamento esperado do objeto que estamos testando.
Por exemplo, se estivéssemos testando uma classe CarrinhoDeCompras, nossa especificação poderia começar assim:
public function it_is_initializable()
{
$this->shouldHaveType(CarrinhoDeCompras::class);
}Isso especifica que nosso CarrinhoDeCompras deve ser inicializável, ou seja, deve poder ser criado sem erros.
Como executar os testes no PHPSpec?
Para executar nossos testes no PHPSpec, precisamos executar o seguinte comando:
vendor/bin/phpspec runIsso irá executar todos os nossos testes em nosso diretório spec/. O PHPSpec nos fornecerá informações sobre os testes que foram executados, incluindo quais passaram e quais falharam.
O que significa “should” no PHPSpec?
No PHPSpec, o “should” é usado para definir uma expectativa sobre o comportamento de um objeto. Por exemplo, em nossa especificação CarrinhoDeCompras, podemos escrever o seguinte:
$this->shouldHaveType(CarrinhoDeCompras::class);Isso especifica que nosso CarrinhoDeCompras deve ter o tipo CarrinhoDeCompras. O “should” é uma maneira clara de definir expectativas em nossa linguagem de especificação.
O que é o Matcher no PHPSpec?
O Matcher no PHPSpec é uma maneira de testar o comportamento esperado de nosso objeto. Podemos usar o Matcher para testar valores de retorno, argumentos passados em métodos e muito mais. O Matcher usa uma sintaxe simples e expressiva que facilita a escrita e compreensão dos testes.
Como criar um Matcher customizado?
Podemos criar um Matcher customizado no PHPSpec definindo uma classe que implementa a interface MatcherInterface. Por exemplo, podemos criar um Matcher para testar se um CarrinhoDeCompras possui um determinado item:
class HaveItemMatcher implements MatcherInterface
{
public function supports(string $name, $subject, array $arguments): bool
{
return $name === ‘haveItem’;
}
public function positiveMatch(string $name, $subject, array $arguments): void
{
// Teste para verificar se o carrinho de compras possui um item específico.
}
public function negativeMatch(string $name, $subject, array $arguments): void
{
// Teste para verificar se o carrinho de compras não possui um item específico.
}
}
Em nossa especificação CarrinhoDeCompras, podemos usar esse Matcher da seguinte maneira:
public function it_should_have_an_item()
{
$item = new Item(‘produto’, 10.0);
$this->shouldHaveItem($item);
}O que é o Stub no PHPSpec?
O Stub no PHPSpec é um objeto simulado que podemos usar em nossas especificações para ajudar a testar o comportamento esperado de nossos objetos. Por exemplo, se estivéssemos testando uma classe que depende de outra classe que ainda não está implementada, poderíamos usar um Stub dessa classe para simular seu comportamento.
Como criar um Stub no PHPSpec?
Podemos criar um Stub no PHPSpec definindo uma classe que implementa a interface StubInterface. Por exemplo, podemos criar um Stub para simular o comportamento de uma classe de e-mail:
class EmailStub implements StubInterface
{
public function send(string $to, string $subject, string $body): void
{
// Simulação de envio de e-mail.
}
public function __call($method, $args)
{
// Escrever um método __call garantirá que esse objeto seja capaz de responder a qualquer método de chamada.
}
}
Em nossa especificação, podemos usar esse stub da seguinte maneira:
public function it_should_send_an_email()
{
$email = new EmailStub();
$this->enviarEmail($email);
// Teste para verificar se o método enviarEmail() é chamado com sucesso.
}