Cada um dos itens acima destina-se a fornecer uma cartilha sobre como come\u00e7ar a escrever testes de unidade muito b\u00e1sicos. As coisas podem ficar mais complexas, especialmente \u00e0 medida que um aplicativo ou projeto cresce (mas isso \u00e9 sempre verdade, certo?).<\/p>\n
Mas para ter certeza de que est\u00e1 preparado para isso, h\u00e1 um componente final para teste de unidade que acredito que devemos focar e que \u00e9 entender o arquivo de configura\u00e7\u00e3o XML PHPUnit (que voc\u00ea pode ter visto em outros projetos como phpunit.xml).<\/p>\n
Configura\u00e7\u00e3o XML do PHPUnit<\/h2>\n
Ent\u00e3o, neste post, vou configurar um projeto simples que usa PHPUnit, escreve alguns testes como os que j\u00e1 vimos e aproveita um arquivo de configura\u00e7\u00e3o para automatizar os testes.<\/p>\n
Al\u00e9m disso, farei o que puder para explicar melhor as partes necess\u00e1rias do arquivo de configura\u00e7\u00e3o para que voc\u00ea possa incluir uma em seu pr\u00f3ximo projeto.<\/p>\n
1 Apagando os arquivos<\/h3>\n
Antes de come\u00e7ar a escrever c\u00f3digo test\u00e1vel, \u00e9 importante conhecer os arquivos que ser\u00e3o necess\u00e1rios para que o processo funcione.<\/p>\n
O seguinte \u00e9, mais ou menos, como organizamos<\/a><\/strong> as coisas desde o in\u00edcio de um projeto:<\/p>\n Eventualmente, voc\u00ea tamb\u00e9m ver\u00e1:<\/p>\n Neste ponto, por\u00e9m, vamos dar uma olhada no arquivo de configura\u00e7\u00e3o XML e tentar executar o PHPUnit automaticamente sem quaisquer outros par\u00e2metros.<\/p>\n Primeiro, vamos ver o arquivo de configura\u00e7\u00e3o b\u00e1sica:<\/a><\/strong><\/p>\n Agora vamos entender exatamente o que estamos vendo (al\u00e9m do XML simples).<\/p>\n Com tudo isso dito, nosso arquivo XML tem tudo que o PHPUnit precisa para rodar sem outros par\u00e2metros.<\/p>\n Lembre-se, por\u00e9m, antes de prosseguir com o resto deste artigo, suponho que voc\u00ea instalou globalmente o PHPUnit em seu sistema usando o Composer. Caso contr\u00e1rio, revise este artigo<\/a><\/strong>, pois ele fornecer\u00e1 instru\u00e7\u00f5es sobre como faz\u00ea-lo.<\/p>\n Uma vez feito, voc\u00ea pode verificar se o PHPUnit est\u00e1 instalado digitando o seguinte comando no seu terminal:<\/p>\n E voc\u00ea deve ver algo como o seguinte:<\/p>\n<\/p>\n Se voc\u00ea vir algo como o acima, poder\u00e1 executar o PHPUnit em qualquer lugar do seu sistema.<\/p>\n Antes de prosseguir, vamos escrever um arquivo bootstrap b\u00e1sico. Vamos cham\u00e1-lo de bootstrap.php<\/strong> e coloc\u00e1-lo em nosso diret\u00f3rio de testes<\/strong>. Incluir\u00e1 o seguinte:<\/a><\/strong><\/p>\n Este \u00e9 um simples “autoloader" (que eu o chamo hesitantemente, j\u00e1 que est\u00e1 apenas iterando os arquivos e exigindo-os, mas funciona para nossos prop\u00f3sitos).<\/p>\n Neste ponto, vamos configurar um teste b\u00e1sico.<\/p>\n Se voc\u00ea ler algo sobre desenvolvimento orientado a testes, provavelmente ouvir\u00e1 falar sobre o ciclo de repeti\u00e7\u00e3o vermelho-verde. H\u00e1 muito a ser dito sobre isso e eu recomendo ler sobre isso<\/a><\/strong>, mas n\u00e3o \u00e9 o objetivo deste post.<\/p>\n Em vez disso, estamos mais focados em realmente escrever testes que correspondam ao que precisamos fazer, certo? Dito isso, vamos fazer o seguinte:<\/p>\n Agora, a partir do Terminal, mude o diret\u00f3rio para o diret\u00f3rio do projeto (que est\u00e1 faltando, por enquanto) e ent\u00e3o simplesmente execute php<\/em><\/strong> unit<\/em>:<\/p>\n Supondo que tudo esteja configurado corretamente, voc\u00ea dever\u00e1 ver algo assim:<\/p>\n Como n\u00e3o temos c\u00f3digo nem testes, naturalmente veremos a sa\u00edda acima, certo? Ent\u00e3o, vamos escrever um \u00fanico teste que ser\u00e1 executado (e falhar\u00e1), pois n\u00e3o h\u00e1 c\u00f3digo para ele realmente testar.<\/p>\n Primeiro, no diret\u00f3rio de testes<\/strong>, crie um arquivo chamado AcmeCacheTest.php.<\/strong> E vamos fazer algo simples como instanciar um objeto de cache<\/a><\/strong> que eventualmente criaremos.<\/p>\n Antes de executar o teste, observe que:<\/p>\n Isso \u00e9 parte do que torna o uso do PHPUnit t\u00e3o f\u00e1cil. Feito isso, execute o seguinte c\u00f3digo na raiz do seu projeto:<\/p>\n Depois disso, voc\u00ea deve ver o seguinte:<\/p>\n Observe que isso resultar\u00e1 em um teste com falha e informar\u00e1 onde<\/strong> o problema foi encontrado, o arquivo e a linha.<\/p>\n Para corrigir isso, precisamos escrever uma classe:<\/a><\/strong><\/p>\n O teste b\u00e1sico de aprova\u00e7\u00e3o (que ser\u00e1 baseado no c\u00f3digo anterior) incluir\u00e1 o seguinte:<\/p>\n Primeiro, vamos testar se conseguimos configurar a classe e se ela n\u00e3o \u00e9 nula. Esta \u00e9 uma afirma\u00e7\u00e3o um pouco desnecess\u00e1ria, pois sabemos que teremos uma classe devidamente instanciada, mas nos coloca no ritmo de escrever testes:<\/a><\/strong><\/p>\n E execute o teste:<\/p>\n Em seguida, vamos verificar se o valor padr\u00e3o do cache est\u00e1 definido:<\/a><\/strong><\/p>\n Assim como na etapa anterior, execute os testes e agora voc\u00ea ver\u00e1 dois testes aprovados:<\/p>\n Por fim, vamos testar para ver se conseguimos alterar o valor com sucesso:<\/a><\/strong><\/p>\n E os tr\u00eas \u00faltimos testes de aprova\u00e7\u00e3o:<\/p>\n E a\u00ed est\u00e1:<\/p>\n Concedido, \u00e9 simples, mas isso estabelece os fundamentos para muito mais do que muitas pessoas j\u00e1 fazem com seus testes.<\/p>\n Al\u00e9m disso, oferece algo para voc\u00ea construir \u00e0 medida que suas habilidades de teste se fortalecem.<\/p>\n Finalmente, se voc\u00ea estiver ansioso para realmente mergulhar no arquivo de configura\u00e7\u00e3o, poder\u00e1 ler a explica\u00e7\u00e3o detalhada do manual sobre ele.<\/a><\/strong><\/p>\n Observe, no entanto, que tudo o que est\u00e1 descrito acima visa ser o que voc\u00ea precisa para come\u00e7ar a configurar seu pr\u00f3prio arquivo de configura\u00e7\u00e3o XML PHPUnit.<\/p>\n\n
\n
2 No\u00e7\u00f5es b\u00e1sicas para o arquivo de configura\u00e7\u00e3o<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<!-- http:\/\/phpunit.de\/manual\/4.1\/en\/appendixes.configuration.html -->\n<phpunit xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n xsi:noNamespaceSchemaLocation=\"http:\/\/schema.phpunit.de\/4.1\/phpunit.xsd\"\n bootstrap=\".\/tests\/bootstrap.php\"\n backupGlobals=\"false\"\n colors=\"true\"\n convertErrorsToExceptions=\"true\"\n convertNoticesToExceptions=\"true\"\n convertWarningsToExceptions=\"true\"\n>\n <testsuites>\n <testsuite name=\"AcmeTests\">\n <directory>.\/tests<\/directory>\n <\/testsuite>\n <\/testsuites>\n\n <logging>\n <log type=\"coverage-text\" target=\"php:\/\/stdout\" showUncoveredFiles=\"true\"><\/log>\n <\/logging>\n<\/phpunit>\n<\/code><\/pre>\n\n
\n
\n
$ which phpunit<\/code><\/pre>\n3 O arquivo Bootstrap<\/h3>\n
<?php\n\/\/ This array has a single file but could whole the contents of an entire directory.\n$files = [\n dirname(__DIR__).'\/AcmeCache.php',\n];\n\nforeach ($files as $file) {\n if (file_exists($file)) {\n require_once $file;\n }\n}\n<\/code><\/pre>\n4 Um Teste B\u00e1sico e Reprovado<\/h3>\n
\n
$ phpunit<\/code><\/pre>\n![\"Escrevendo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7588ea742f.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n}\n<\/code><\/pre>\n\n
$ phpunit<\/code><\/pre>\n![\"Escrevendo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e75891b9ec8.png\")
<\/a><\/p>\n<?php\n\nnamespace Acme;\n\nclass AcmeCache\n{\n private $duration;\n\n public function __construct()\n {\n $this->duration = 43200;\n }\n\n public function setDuration(int $duration)\n {\n $this->duration = $duration;\n }\n\n public function getDuration(): int\n {\n return $this->duration;\n }\n}\n<\/code><\/pre>\n4 Alguns testes b\u00e1sicos e aprovados<\/h3>\n
\n
<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n}\n<\/code><\/pre>\n![\"Escrevendo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e75894bbad2.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n\n public function testDefaultCacheValue()\n {\n $this->assertSame(43200, $this->cache->getDuration());\n }\n}\n<\/code><\/pre>\n![\"Escrevendo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589770dbe.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n\n public function testDefaultCacheValue()\n {\n $this->assertSame(43200, $this->cache->getDuration());\n }\n\n public function testSetCustomDuration()\n {\n $duration = 4200;\n\n $this->cache->setDuration($duration);\n $this->assertSame($duration, $this->cache->getDuration());\n }\n}\n<\/code><\/pre>\n![\"Escrevendo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589a7745a.png\")
<\/a><\/p>\n\n
H\u00e1 mais? (Sempre certo?)<\/h2>\n