{"id":1638,"date":"2026-10-15T23:13:19","date_gmt":"2026-10-16T02:13:19","guid":{"rendered":"https:\/\/micheladrianomedeiros.com.br\/blog\/?p=1638"},"modified":"2026-10-15T23:13:21","modified_gmt":"2026-10-16T02:13:21","slug":"php-code-coverage","status":"publish","type":"post","link":"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/","title":{"rendered":"PHP Code Coverage \u2014 Li\u00e7\u00e3o 2: arquitetura, drivers e importa\u00e7\u00e3o Clover"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Quando executamos testes com o PHPUnit e abrimos um relat\u00f3rio de cobertura, normalmente vemos porcentagens, arquivos coloridos e linhas que passaram ou n\u00e3o pelos testes. Entretanto, de onde v\u00eam essas informa\u00e7\u00f5es? Quem decide quais arquivos entram no relat\u00f3rio? Como um resultado bruto se transforma em HTML, Clover ou JSONL?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Nesta segunda li\u00e7\u00e3o da trilha de <strong>PHP Code Coverage<\/strong>, investigaremos a arquitetura do projeto <a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\" target=\"_blank\" rel=\"noopener\">sebastianbergmann\/php-code-coverage<\/a> e come\u00e7aremos um produto pr\u00f3prio: o <strong>CoverageRadar PHP<\/strong>, um analisador de relat\u00f3rios com potencial para evoluir at\u00e9 um servi\u00e7o web.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A proposta \u00e9 dupla. Primeiro, <strong>dominar o projeto de refer\u00eancia e suas decis\u00f5es de engenharia<\/strong>. Depois, <strong>usar o conhecimento para criar uma aplica\u00e7\u00e3o independente, com c\u00f3digo e identidade pr\u00f3prios<\/strong>. N\u00e3o precisamos escrever outro Xdebug nem copiar as classes do projeto original para oferecer algo \u00fatil.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Vers\u00e3o verificada em 15\/10\/2026:<\/strong> a \u00faltima release est\u00e1vel consultada foi <strong>14.4.1, de 03\/10\/2026<\/strong>. Exemplos de API desta li\u00e7\u00e3o foram alinhados ao c\u00f3digo da tag <a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/releases\/tag\/14.4.1\" target=\"_blank\" rel=\"noopener\">14.4.1<\/a>. A branch principal pode evoluir e apresentar APIs de vers\u00f5es futuras; por isso, sempre devemos indicar qual vers\u00e3o estamos estudando.<\/p>\n<\/blockquote>\n\n\n\n<div class=\"markdown-heading\"><div id=\"ez-toc-container\" class=\"ez-toc-v2_0_90 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#PHP_Code_Coverage_1_O_que_vamos_dominar_hoje\" >PHP Code Coverage: 1. O que vamos dominar hoje<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#2_Antes_do_relatorio_o_fluxo_completo\" >2. Antes do relat\u00f3rio: o fluxo completo<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#3_Conhecendo_os_diretorios_do_repositorio\" >3. Conhecendo os diret\u00f3rios do reposit\u00f3rio<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#4_Filter_estabelecer_os_limites_da_analise\" >4. Filter: estabelecer os limites da an\u00e1lise<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Erro_comum_cobertura_artificialmente_alta\" >Erro comum: cobertura artificialmente alta<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#5_Driver_coletar_dados_de_execucao\" >5. Driver: coletar dados de execu\u00e7\u00e3o<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Granularity_as_tres_opcoes\" >Granularity: as tr\u00eas op\u00e7\u00f5es<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#6_CodeCoverage_o_coordenador_do_sistema\" >6. CodeCoverage: o coordenador do sistema<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Uma_sutileza_de_engenharia\" >Uma sutileza de engenharia<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#7_Data_e_StaticAnalysis_dados_brutos_nao_bastam\" >7. Data e StaticAnalysis: dados brutos n\u00e3o bastam<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#8_Node_e_ReportFacade_organizar_e_apresentar\" >8. Node e Report\\Facade: organizar e apresentar<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Por_que_Clover_e_uma_boa_primeira_integracao\" >Por que Clover \u00e9 uma boa primeira integra\u00e7\u00e3o?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#E_a_novidade_JSONL\" >E a novidade JSONL?<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#9_Laboratorio_A_%E2%80%94_Usando_a_biblioteca_diretamente\" >9. Laborat\u00f3rio A \u2014 Usando a biblioteca diretamente<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-15\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#91_Diagnostique_o_ambiente\" >9.1. Diagnostique o ambiente<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-16\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#92_Instale_a_dependencia_de_desenvolvimento\" >9.2. Instale a depend\u00eancia de desenvolvimento<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-17\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#93_Crie_um_script_de_coleta\" >9.3. Crie um script de coleta<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-18\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#94_Compare_com_o_PHPUnit\" >9.4. Compare com o PHPUnit<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-19\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#10_Laboratorio_B_%E2%80%94_Comecando_o_CoverageRadar_PHP\" >10. Laborat\u00f3rio B \u2014 Come\u00e7ando o CoverageRadar PHP<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-20\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#101_Primeiro_contrato_de_entrada_e_saida\" >10.1. Primeiro contrato de entrada e sa\u00edda<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-21\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#102_Entendendo_as_metricas_Clover\" >10.2. Entendendo as m\u00e9tricas Clover<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-22\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#103_Crie_o_nosso_primeiro_leitor\" >10.3. Crie o nosso primeiro leitor<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-23\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#O_que_acabamos_de_construir\" >O que acabamos de construir?<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-24\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#11_Por_que_separar_nosso_sistema_do_coletor\" >11. Por que separar nosso sistema do coletor?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-25\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#12_Nossa_arquitetura_futura\" >12. Nossa arquitetura futura<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-26\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#13_Qualidade_de_dados_armadilhas_que_o_produto_precisara_tratar\" >13. Qualidade de dados: armadilhas que o produto precisar\u00e1 tratar<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-27\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#14_Exercicios_praticos\" >14. Exerc\u00edcios pr\u00e1ticos<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-28\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Exercicio_1_%E2%80%94_Mude_o_filtro\" >Exerc\u00edcio 1 \u2014 Mude o filtro<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-29\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Exercicio_2_%E2%80%94_Teste_branches\" >Exerc\u00edcio 2 \u2014 Teste branches<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-30\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Exercicio_3_%E2%80%94_Compare_formatos\" >Exerc\u00edcio 3 \u2014 Compare formatos<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-31\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Exercicio_4_%E2%80%94_Valide_XML_invalido\" >Exerc\u00edcio 4 \u2014 Valide XML inv\u00e1lido<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-32\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Exercicio_5_%E2%80%94_Ordenacao_e_metricas\" >Exerc\u00edcio 5 \u2014 Ordena\u00e7\u00e3o e m\u00e9tricas<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-33\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Desafio_extra_%E2%80%94_Primeiro_teste_automatizado_do_produto\" >Desafio extra \u2014 Primeiro teste automatizado do produto<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-34\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#15_Questoes_de_revisao\" >15. Quest\u00f5es de revis\u00e3o<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-35\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Gabarito_comentado\" >Gabarito comentado<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-36\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#16_Checklist_de_conclusao\" >16. Checklist de conclus\u00e3o<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-37\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#17_Proxima_licao_da_trilha\" >17. Pr\u00f3xima li\u00e7\u00e3o da trilha<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-38\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Referencias_oficiais_e_leitura_complementar\" >Refer\u00eancias oficiais e leitura complementar<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-39\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/php-code-coverage\/#Php_Mysql_JavaScript_All-In-One_for_Dummies\" >Php, Mysql, &#038; JavaScript All-In-One for Dummies<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"PHP_Code_Coverage_1_O_que_vamos_dominar_hoje\"><\/span>PHP Code Coverage: 1. O que vamos dominar hoje<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-1-o-que-vamos-dominar-hoje\" class=\"anchor\" aria-label=\"Permalink: 1. O que vamos dominar hoje\" href=\"#1-o-que-vamos-dominar-hoje\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Ao concluir a aula, voc\u00ea dever\u00e1 conseguir:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>descrever a diferen\u00e7a entre <strong>coleta<\/strong>, <strong>processamento<\/strong> e <strong>relat\u00f3rio<\/strong> de cobertura;<\/li>\n\n\n\n<li>explicar as responsabilidades de <strong>Filter<\/strong>, <strong>Driver<\/strong>, <strong>CodeCoverage<\/strong>, <strong>Data<\/strong>, <strong>StaticAnalysis<\/strong>, <strong>Node<\/strong> e <strong>Report<\/strong>;<\/li>\n\n\n\n<li>compreender como o <strong>Selector<\/strong> escolhe PCOV ou Xdebug;<\/li>\n\n\n\n<li>identificar os n\u00edveis <strong>Line<\/strong>, <strong>LineAndBranch<\/strong> e <strong>LineBranchAndPath<\/strong>;<\/li>\n\n\n\n<li>usar a API atual para iniciar e encerrar uma coleta;<\/li>\n\n\n\n<li>gerar relat\u00f3rios de texto, HTML, Clover e JSONL;<\/li>\n\n\n\n<li>compreender por que arquivos n\u00e3o executados precisam entrar no denominador;<\/li>\n\n\n\n<li>ler a cobertura geral de um arquivo <strong>Clover XML<\/strong> usando nosso pr\u00f3prio PHP;<\/li>\n\n\n\n<li>listar arquivos com menor cobertura e obter um JSON simples;<\/li>\n\n\n\n<li>separar o c\u00f3digo do futuro SaaS da execu\u00e7\u00e3o de testes de terceiros.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Na primeira li\u00e7\u00e3o, aprendemos que <strong>cobertura mede execu\u00e7\u00e3o, n\u00e3o corre\u00e7\u00e3o<\/strong>. Um teste pode percorrer uma linha sem verificar o resultado esperado. Nesta aula, veremos como a pr\u00f3pria arquitetura da ferramenta reflete essa diferen\u00e7a.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"2_Antes_do_relatorio_o_fluxo_completo\"><\/span>2. Antes do relat\u00f3rio: o fluxo completo<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-2-antes-do-relat\u00f3rio-o-fluxo-completo\" class=\"anchor\" aria-label=\"Permalink: 2. Antes do relat\u00f3rio: o fluxo completo\" href=\"#2-antes-do-relat%C3%B3rio-o-fluxo-completo\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O fluxo de cobertura pode ser representado assim:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Projeto PHP + testes\n         |\n         v\nPHPUnit \/ executor de testes\n         |\n         v\nExtens\u00e3o nativa: PCOV ou Xdebug\n         |\n         v\nDriver -&gt; coleta bruta\n         |\n         v\nFilter + StaticAnalysis\n         |\n         v\nCodeCoverage + Data\n         |\n         v\nNode (\u00e1rvore de projeto, arquivos e unidades)\n         |\n         v\nReport\\Facade\n         |\n         +--&gt; HTML\n         +--&gt; Texto\n         +--&gt; Clover \/ Cobertura \/ OpenClover\n         +--&gt; XML\n         +--&gt; JSONL\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Essa \u00e9 uma <strong>vis\u00e3o did\u00e1tica<\/strong>. Internamente, as etapas n\u00e3o s\u00e3o uma fila isolada de classes: <strong>CodeCoverage<\/strong> coordena o driver, filtros, processamento e constru\u00e7\u00e3o dos dados consumidos pelos relat\u00f3rios.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A distin\u00e7\u00e3o central \u00e9:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Etapa<\/th><th>Pergunta que responde<\/th><th>Exemplo<\/th><\/tr><\/thead><tbody><tr><td>Coleta<\/td><td>O que foi executado?<\/td><td>Xdebug informa linhas e caminhos percorridos<\/td><\/tr><tr><td>Filtragem<\/td><td>Qual c\u00f3digo pertence \u00e0 aplica\u00e7\u00e3o?<\/td><td>Incluir apenas arquivos de src<\/td><\/tr><tr><td>Processamento<\/td><td>Como representar os dados de forma \u00fatil?<\/td><td>Associar linhas executadas aos testes<\/td><\/tr><tr><td>An\u00e1lise est\u00e1tica<\/td><td>Quais linhas s\u00e3o execut\u00e1veis?<\/td><td>Interpretar o c\u00f3digo PHP<\/td><\/tr><tr><td>Agrega\u00e7\u00e3o<\/td><td>Como somar por arquivo e projeto?<\/td><td>Total de linhas cobertas<\/td><\/tr><tr><td>Relat\u00f3rio<\/td><td>Como apresentar ou exportar?<\/td><td>HTML, Clover, JSONL<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Uma boa arquitetura mant\u00e9m essas responsabilidades separadas. Isso facilita testes, evolu\u00e7\u00e3o das APIs e inclus\u00e3o de novos formatos.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"3_Conhecendo_os_diretorios_do_repositorio\"><\/span>3. Conhecendo os diret\u00f3rios do reposit\u00f3rio<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-3-conhecendo-os-diret\u00f3rios-do-reposit\u00f3rio\" class=\"anchor\" aria-label=\"Permalink: 3. Conhecendo os diret\u00f3rios do reposit\u00f3rio\" href=\"#3-conhecendo-os-diret%C3%B3rios-do-reposit%C3%B3rio\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A estrutura de c\u00f3digo-fonte da biblioteca inclui estas \u00e1reas:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>src\/\n\u251c\u2500\u2500 CodeCoverage.php\n\u251c\u2500\u2500 Filter.php\n\u251c\u2500\u2500 FilterProcessor.php\n\u251c\u2500\u2500 Data\/\n\u251c\u2500\u2500 Driver\/\n\u251c\u2500\u2500 Node\/\n\u251c\u2500\u2500 Report\/\n\u251c\u2500\u2500 Serialization\/\n\u251c\u2500\u2500 StaticAnalysis\/\n\u251c\u2500\u2500 Test\/\n\u2514\u2500\u2500 Util\/\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Veja como estudar cada uma:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>M\u00f3dulo<\/th><th>Responsabilidade predominante<\/th><\/tr><\/thead><tbody><tr><td>CodeCoverage<\/td><td>Orquestrar captura, anexa\u00e7\u00e3o, combina\u00e7\u00e3o e resultados<\/td><\/tr><tr><td>Filter<\/td><td>Definir arquivos eleg\u00edveis para a cobertura<\/td><\/tr><tr><td>FilterProcessor<\/td><td>Refinar os dados coletados conforme regras de inclus\u00e3o<\/td><\/tr><tr><td>Driver<\/td><td>Comunicar-se com o mecanismo de cobertura<\/td><\/tr><tr><td>Data<\/td><td>Armazenar informa\u00e7\u00f5es brutas e processadas<\/td><\/tr><tr><td>StaticAnalysis<\/td><td>Examinar o c\u00f3digo-fonte para enriquecer os dados<\/td><\/tr><tr><td>Node<\/td><td>Organizar os dados em uma \u00e1rvore de diret\u00f3rios e arquivos<\/td><\/tr><tr><td>Report<\/td><td>Exportar resultados em formatos consum\u00edveis<\/td><\/tr><tr><td>Serialization<\/td><td>Persistir e recuperar dados em formato pr\u00f3prio<\/td><\/tr><tr><td>Test<\/td><td>Modelar informa\u00e7\u00f5es relacionadas a testes e seus alvos<\/td><\/tr><tr><td>Util<\/td><td>Compartilhar funcionalidades auxiliares<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Recomenda\u00e7\u00e3o de leitura:<\/strong> abra primeiro a <a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/CodeCoverage.php\" target=\"_blank\" rel=\"noopener\">classe CodeCoverage<\/a>, mas n\u00e3o tente memorizar todas as linhas. Procure suas depend\u00eancias e os m\u00e9todos p\u00fablicos. Depois navegue para cada componente utilizado.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"4_Filter_estabelecer_os_limites_da_analise\"><\/span>4. Filter: estabelecer os limites da an\u00e1lise<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-4-filter-estabelecer-os-limites-da-an\u00e1lise\" class=\"anchor\" aria-label=\"Permalink: 4. Filter: estabelecer os limites da an\u00e1lise\" href=\"#4-filter-estabelecer-os-limites-da-an%C3%A1lise\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Suponha que um projeto contenha c\u00f3digo pr\u00f3prio, depend\u00eancias instaladas pelo Composer e testes. Se incluirmos todos os arquivos no relat\u00f3rio, a porcentagem poder\u00e1 perder significado.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u00c9 o <strong>Filter<\/strong> que delimita os arquivos eleg\u00edveis.<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-smi\">Filter<\/span>;\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">Filter<\/span>();\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>-&gt;<span class=\"pl-en\">includeFiles<\/span>([\n    <span class=\"pl-c1\">__DIR__<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">\/src\/Calculator.php<\/span>'<\/span>,\n]);<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Na vers\u00e3o 14.4.1, a classe <strong>Filter<\/strong> oferece m\u00e9todos como <strong>includeFile()<\/strong>, <strong>includeFiles()<\/strong>, <strong>files()<\/strong>, <strong>isEmpty()<\/strong> e <strong>isExcluded()<\/strong>. O caminho inclu\u00eddo \u00e9 normalizado com <strong>realpath()<\/strong>; caminhos inexistentes n\u00e3o s\u00e3o adicionados.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Isso produz um detalhe importante: <strong>incluir arquivos n\u00e3o \u00e9 o mesmo que executar arquivos<\/strong>. Um arquivo eleg\u00edvel pode aparecer com zero linhas cobertas se nunca for exercitado.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Erro_comum_cobertura_artificialmente_alta\"><\/span>Erro comum: cobertura artificialmente alta<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-erro-comum-cobertura-artificialmente-alta\" class=\"anchor\" aria-label=\"Permalink: Erro comum: cobertura artificialmente alta\" href=\"#erro-comum-cobertura-artificialmente-alta\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Imagine:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><br><strong>Calculator.php:<\/strong> 50 linhas execut\u00e1veis, 50 cobertas.<\/li>\n\n\n\n<li><br><strong>PaymentService.php:<\/strong> 50 linhas execut\u00e1veis, nenhuma coberta.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Se filtrarmos apenas a calculadora, o projeto parecer\u00e1 ter 100% de cobertura. Se considerarmos os dois arquivos eleg\u00edveis, a cobertura global ser\u00e1 <strong>50%<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Portanto, antes de comemorar um n\u00famero alto, pergunte: <strong>qual \u00e9 o denominador?<\/strong><\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"5_Driver_coletar_dados_de_execucao\"><\/span>5. Driver: coletar dados de execu\u00e7\u00e3o<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-5-driver-coletar-dados-de-execu\u00e7\u00e3o\" class=\"anchor\" aria-label=\"Permalink: 5. Driver: coletar dados de execu\u00e7\u00e3o\" href=\"#5-driver-coletar-dados-de-execu%C3%A7%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A biblioteca n\u00e3o monitora o interpretador PHP sozinha. Para isso, utiliza uma extens\u00e3o compat\u00edvel.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>PCOV<\/strong> \u00e9 voltado \u00e0 cobertura de linhas. <strong>Xdebug<\/strong>, quando configurado para coverage, fornece granularidade mais avan\u00e7ada, incluindo branches e paths.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Na tag 14.4.1, a classe <a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Driver\/Selector.php\" target=\"_blank\" rel=\"noopener\">Driver\\Selector<\/a> cont\u00e9m uma API importante:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-v\">Driver<\/span>\\<span class=\"pl-smi\">Granularity<\/span>;\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-v\">Driver<\/span>\\<span class=\"pl-smi\">Selector<\/span>;\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>driver<\/span> = (<span class=\"pl-k\">new<\/span> <span class=\"pl-v\">Selector<\/span>())-&gt;<span class=\"pl-en\">select<\/span>(\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>,\n    Granularity::Line\n);<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O comportamento principal \u00e9:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Para <strong>Granularity::Line<\/strong>, o seletor prefere PCOV quando dispon\u00edvel.<\/li>\n\n\n\n<li>Caso contr\u00e1rio, tenta Xdebug.<\/li>\n\n\n\n<li>Para granularidade de branches\/paths, utiliza Xdebug quando dispon\u00edvel e compat\u00edvel.<\/li>\n\n\n\n<li>Se n\u00e3o houver mecanismo suportado, lan\u00e7a uma exce\u00e7\u00e3o.<\/li>\n<\/ol>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Granularity_as_tres_opcoes\"><\/span>Granularity: as tr\u00eas op\u00e7\u00f5es<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-granularity-as-tr\u00eas-op\u00e7\u00f5es\" class=\"anchor\" aria-label=\"Permalink: Granularity: as tr\u00eas op\u00e7\u00f5es\" href=\"#granularity-as-tr%C3%AAs-op%C3%A7%C3%B5es\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre>Granularity::Line\nGranularity::LineAndBranch\nGranularity::LineBranchAndPath<\/pre><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li><br><strong>Line:<\/strong> quais linhas execut\u00e1veis foram percorridas?<\/li>\n\n\n\n<li><br><strong>LineAndBranch:<\/strong> quais linhas e desvios foram exercitados?<\/li>\n\n\n\n<li><br><strong>LineBranchAndPath:<\/strong> quais linhas, desvios e caminhos foram percorridos?<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">No c\u00f3digo atual, os antigos m\u00e9todos <strong>forLineCoverage()<\/strong> e <strong>forLineAndPathCoverage()<\/strong> ainda aparecem, mas est\u00e3o marcados como <strong>deprecated<\/strong>. Para nosso estudo, adotaremos <strong>select()<\/strong> e <strong>Granularity<\/strong>.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Aten\u00e7\u00e3o:<\/strong> habilitar a granularidade no PHP n\u00e3o garante que um teste seja bom. Tamb\u00e9m n\u00e3o significa que todos os projetos ter\u00e3o dados de branch se o driver utilizado n\u00e3o suportar essa modalidade.<\/p>\n<\/blockquote>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"6_CodeCoverage_o_coordenador_do_sistema\"><\/span>6. CodeCoverage: o coordenador do sistema<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-6-codecoverage-o-coordenador-do-sistema\" class=\"anchor\" aria-label=\"Permalink: 6. CodeCoverage: o coordenador do sistema\" href=\"#6-codecoverage-o-coordenador-do-sistema\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A classe principal recebe dois objetos: o driver e o filtro.<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-smi\">CodeCoverage<\/span>;\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">CodeCoverage<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>driver<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>);<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O ciclo mais simples \u00e9:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span>-&gt;<span class=\"pl-en\">start<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">exemplo-de-execucao<\/span>'<\/span>);\n\n<span class=\"pl-c\">\/\/ C\u00f3digo que queremos observar.<\/span>\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>calculator<\/span> = <span class=\"pl-k\">new<\/span> \\<span class=\"pl-v\">App<\/span>\\<span class=\"pl-v\">Calculator<\/span>();\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>calculator<\/span>-&gt;<span class=\"pl-en\">add<\/span>(<span class=\"pl-c1\">2<\/span>, <span class=\"pl-c1\">3<\/span>);\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span>-&gt;<span class=\"pl-en\">stop<\/span>();<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Nesse fluxo:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><br><strong>start()<\/strong> registra um identificador para a coleta e aciona o driver.<\/li>\n\n\n\n<li>O c\u00f3digo de produ\u00e7\u00e3o executa normalmente.<\/li>\n\n\n\n<li><br><strong>stop()<\/strong> encerra a captura no driver.<\/li>\n\n\n\n<li>Os dados recebidos passam pelo processamento e s\u00e3o associados ao identificador da execu\u00e7\u00e3o.<\/li>\n\n\n\n<li>O objeto fica dispon\u00edvel para relat\u00f3rios e agrega\u00e7\u00f5es.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Esse exemplo <strong>n\u00e3o substitui um teste PHPUnit<\/strong>: executa c\u00f3digo sob medi\u00e7\u00e3o, mas n\u00e3o verifica automaticamente os resultados. Podemos usar PHPUnit para unir execu\u00e7\u00e3o e asser\u00e7\u00f5es.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Uma_sutileza_de_engenharia\"><\/span>Uma sutileza de engenharia<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-uma-sutileza-de-engenharia\" class=\"anchor\" aria-label=\"Permalink: Uma sutileza de engenharia\" href=\"#uma-sutileza-de-engenharia\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O m\u00e9todo <strong>merge()<\/strong> combina informa\u00e7\u00f5es de duas inst\u00e2ncias de cobertura. Na release <strong>14.4.1<\/strong>, uma corre\u00e7\u00e3o evitou copiar repetidamente todos os testes j\u00e1 acumulados a cada combina\u00e7\u00e3o. Isso reduziu um comportamento que podia crescer quadraticamente ao mesclar os resultados de muitos processos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A li\u00e7\u00e3o para nosso produto \u00e9 clara: <strong>um algoritmo aparentemente simples pode ficar caro \u00e0 medida que a quantidade de builds e testes aumenta<\/strong>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"7_Data_e_StaticAnalysis_dados_brutos_nao_bastam\"><\/span>7. Data e StaticAnalysis: dados brutos n\u00e3o bastam<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-7-data-e-staticanalysis-dados-brutos-n\u00e3o-bastam\" class=\"anchor\" aria-label=\"Permalink: 7. Data e StaticAnalysis: dados brutos n\u00e3o bastam\" href=\"#7-data-e-staticanalysis-dados-brutos-n%C3%A3o-bastam\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A extens\u00e3o de cobertura informa dados de execu\u00e7\u00e3o, mas um relat\u00f3rio \u00fatil precisa ir al\u00e9m.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Data<\/strong> organiza os dados capturados. <strong>StaticAnalysis<\/strong> ajuda a entender caracter\u00edsticas dos arquivos PHP e das unidades de c\u00f3digo, como linhas execut\u00e1veis e estrutura de fun\u00e7\u00f5es ou m\u00e9todos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Considere:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-k\">public<\/span> <span class=\"pl-k\">function<\/span> <span class=\"pl-en\">classifyNumber<\/span>(<span class=\"pl-smi\">int<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>number<\/span>): <span class=\"pl-smi\">string<\/span>\n{\n    <span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>number<\/span> &gt; <span class=\"pl-c1\">0<\/span>) {\n        <span class=\"pl-k\">return<\/span> <span class=\"pl-s\">'<span class=\"pl-s\">positive<\/span>'<\/span>;\n    }\n\n    <span class=\"pl-k\">return<\/span> <span class=\"pl-s\">'<span class=\"pl-s\">zero<\/span>'<\/span>;\n}<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O relat\u00f3rio precisa distinguir entre:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>linha de c\u00f3digo real e linha em branco;<\/li>\n\n\n\n<li>linha execut\u00e1vel e estrutura meramente sint\u00e1tica;<\/li>\n\n\n\n<li>linha executada e linha ainda n\u00e3o percorrida;<\/li>\n\n\n\n<li>m\u00e9todo parcialmente coberto e m\u00e9todo completamente coberto.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Nem toda linha f\u00edsica deve entrar no c\u00e1lculo. Al\u00e9m disso, se um arquivo n\u00e3o puder ser analisado estaticamente, o projeto mant\u00e9m mecanismos para trabalhar com os dados brutos dispon\u00edveis, mas perde parte do enriquecimento poss\u00edvel.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Por esse motivo, <strong>quantidade de linhas do arquivo n\u00e3o \u00e9 igual ao total de linhas execut\u00e1veis<\/strong>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"8_Node_e_ReportFacade_organizar_e_apresentar\"><\/span>8. Node e Report\\Facade: organizar e apresentar<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-8-node-e-reportfacade-organizar-e-apresentar\" class=\"anchor\" aria-label=\"Permalink: 8. Node e Report\\Facade: organizar e apresentar\" href=\"#8-node-e-reportfacade-organizar-e-apresentar\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Depois da coleta e do processamento, a biblioteca constr\u00f3i uma representa\u00e7\u00e3o hier\u00e1rquica do projeto. As estruturas em <strong>Node<\/strong> permitem agregar estat\u00edsticas de arquivos e diret\u00f3rios.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A classe <a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Report\/Facade.php\" target=\"_blank\" rel=\"noopener\">Report\\Facade<\/a> re\u00fane a gera\u00e7\u00e3o de relat\u00f3rios. Sua instancia\u00e7\u00e3o acontece por meio de um m\u00e9todo de f\u00e1brica:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-v\">Report<\/span>\\<span class=\"pl-smi\">Facade<\/span> <span class=\"pl-k\">as<\/span> <span class=\"pl-smi\">ReportFacade<\/span>;\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span> = ReportFacade::<span class=\"pl-en\">fromObject<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span>);<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Entre as sa\u00eddas dispon\u00edveis est\u00e3o:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderText<\/span>(<span class=\"pl-c1\">null<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderHtml<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">build\/html<\/span>'<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderClover<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">build\/clover.xml<\/span>'<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderCobertura<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">build\/cobertura.xml<\/span>'<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderJsonl<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">build\/jsonl<\/span>'<\/span>);<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Os caminhos mostrados s\u00e3o <strong>exemplos<\/strong>. Precisamos garantir que o diret\u00f3rio de destino exista e seja grav\u00e1vel, de acordo com o formato.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Por_que_Clover_e_uma_boa_primeira_integracao\"><\/span>Por que Clover \u00e9 uma boa primeira integra\u00e7\u00e3o?<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-por-que-clover-\u00e9-uma-boa-primeira-integra\u00e7\u00e3o\" class=\"anchor\" aria-label=\"Permalink: Por que Clover \u00e9 uma boa primeira integra\u00e7\u00e3o?\" href=\"#por-que-clover-%C3%A9-uma-boa-primeira-integra%C3%A7%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O formato <strong>Clover XML<\/strong> possui m\u00e9tricas de projeto e de arquivos. Ele facilita nosso primeiro experimento: importar um arquivo gerado por outra ferramenta e calcular uma cobertura percentual sem precisar executar o projeto que o produziu.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"E_a_novidade_JSONL\"><\/span>E a novidade JSONL?<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-e-a-novidade-jsonl\" class=\"anchor\" aria-label=\"Permalink: E a novidade JSONL?\" href=\"#e-a-novidade-jsonl\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A release <strong>14.4.0<\/strong> adicionou a sa\u00edda <strong>renderJsonl()<\/strong>, que grava em um diret\u00f3rio:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><br><strong>meta.json:<\/strong> informa\u00e7\u00f5es gerais, vers\u00e3o do esquema e totais;<\/li>\n\n\n\n<li><br><strong>coverage.jsonl:<\/strong> um registro por arquivo com dados de cobertura;<\/li>\n\n\n\n<li><br><strong>tests.jsonl:<\/strong> linhas associadas aos testes que as executaram.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Essa sa\u00edda poder\u00e1 servir para an\u00e1lises mais sofisticadas no CoverageRadar PHP. N\u00e3o a confundiremos com Clover: s\u00e3o <strong>formatos diferentes<\/strong>, com dados e esquemas distintos.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"9_Laboratorio_A_%E2%80%94_Usando_a_biblioteca_diretamente\"><\/span>9. Laborat\u00f3rio A \u2014 Usando a biblioteca diretamente<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-9-laborat\u00f3rio-a--usando-a-biblioteca-diretamente\" class=\"anchor\" aria-label=\"Permalink: 9. Laborat\u00f3rio A \u2014 Usando a biblioteca diretamente\" href=\"#9-laborat%C3%B3rio-a--usando-a-biblioteca-diretamente\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Retomaremos o projeto <strong>coverage-lab<\/strong> da Aula 1, que cont\u00e9m uma classe <strong>App\\Calculator<\/strong> em <strong>src\/Calculator.php<\/strong>. Ela possui m\u00e9todos de soma, divis\u00e3o e classifica\u00e7\u00e3o de n\u00fameros.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"91_Diagnostique_o_ambiente\"><\/span>9.1. Diagnostique o ambiente<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-91-diagnostique-o-ambiente\" class=\"anchor\" aria-label=\"Permalink: 9.1. Diagnostique o ambiente\" href=\"#91-diagnostique-o-ambiente\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">No PowerShell:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>php <span class=\"pl-k\">-<\/span>v\nphp <span class=\"pl-k\">-<\/span>m\ncomposer <span class=\"pl-k\">--<\/span>version<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Para esta vers\u00e3o da biblioteca, o ambiente precisa cumprir os requisitos do pacote, incluindo <strong>PHP 8.4 ou superior<\/strong> e as extens\u00f5es obrigat\u00f3rias de XML e strings. Para obter dados de cobertura, precisamos tamb\u00e9m de <strong>PCOV<\/strong> ou <strong>Xdebug<\/strong> devidamente habilitado no PHP CLI.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Confira:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>php <span class=\"pl-k\">-<\/span>m <span class=\"pl-k\">|<\/span> <span class=\"pl-c1\">Select-String<\/span> <span class=\"pl-k\">-<\/span>Pattern <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>xdebug|pcov<span class=\"pl-pds\">\"<\/span><\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Se estiver usando Xdebug, ative o modo de cobertura na sess\u00e3o:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre><span class=\"pl-smi\">$<span class=\"pl-c1\">env:<\/span>XDEBUG_MODE<\/span> <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>coverage<span class=\"pl-pds\">\"<\/span><\/span><\/pre><\/div>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Se n\u00e3o aparecer PCOV nem Xdebug:<\/strong> n\u00e3o h\u00e1 driver dispon\u00edvel para coletar cobertura. Isso n\u00e3o impede a realiza\u00e7\u00e3o do <strong>Laborat\u00f3rio B<\/strong>, que apenas importa um XML e n\u00e3o executa a su\u00edte de testes.<\/p>\n<\/blockquote>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"92_Instale_a_dependencia_de_desenvolvimento\"><\/span>9.2. Instale a depend\u00eancia de desenvolvimento<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-92-instale-a-depend\u00eancia-de-desenvolvimento\" class=\"anchor\" aria-label=\"Permalink: 9.2. Instale a depend\u00eancia de desenvolvimento\" href=\"#92-instale-a-depend%C3%AAncia-de-desenvolvimento\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Na pasta do projeto:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>composer require <span class=\"pl-k\">--<\/span>dev <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>phpunit\/php-code-coverage:^14.4<span class=\"pl-pds\">\"<\/span><\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A resolu\u00e7\u00e3o do Composer depender\u00e1 das outras depend\u00eancias e do arquivo <strong>composer.lock<\/strong>. Registre a vers\u00e3o instalada:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>composer show phpunit<span class=\"pl-k\">\/<\/span>php<span class=\"pl-k\">-<\/span>code<span class=\"pl-k\">-<\/span>coverage<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">N\u00e3o substitua bibliotecas instaladas nem ignore conflitos de depend\u00eancia \u00e0s cegas. Se o projeto existente ainda usar uma vers\u00e3o incompat\u00edvel de PHPUnit, crie um laborat\u00f3rio separado antes de atualizar.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"93_Crie_um_script_de_coleta\"><\/span>9.3. Crie um script de coleta<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-93-crie-um-script-de-coleta\" class=\"anchor\" aria-label=\"Permalink: 9.3. Crie um script de coleta\" href=\"#93-crie-um-script-de-coleta\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Salve o arquivo <strong>examples\/coverage-direct.php<\/strong>:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-ent\">&lt;?php<\/span>\n\n<span class=\"pl-k\">declare<\/span>(strict_types=<span class=\"pl-c1\">1<\/span>);\n\n<span class=\"pl-k\">require<\/span> <span class=\"pl-en\">dirname<\/span>(<span class=\"pl-c1\">__DIR__<\/span>) . <span class=\"pl-s\">'<span class=\"pl-s\">\/vendor\/autoload.php<\/span>'<\/span>;\n\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">App<\/span>\\<span class=\"pl-smi\">Calculator<\/span>;\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-smi\">CodeCoverage<\/span>;\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-v\">Driver<\/span>\\<span class=\"pl-smi\">Granularity<\/span>;\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-v\">Driver<\/span>\\<span class=\"pl-smi\">Selector<\/span>;\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-smi\">Filter<\/span>;\n<span class=\"pl-k\">use<\/span> <span class=\"pl-v\">SebastianBergmann<\/span>\\<span class=\"pl-v\">CodeCoverage<\/span>\\<span class=\"pl-v\">Report<\/span>\\<span class=\"pl-smi\">Facade<\/span> <span class=\"pl-k\">as<\/span> <span class=\"pl-smi\">ReportFacade<\/span>;\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>root<\/span> = <span class=\"pl-en\">dirname<\/span>(<span class=\"pl-c1\">__DIR__<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>source<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>root<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">\/src\/Calculator.php<\/span>'<\/span>;\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>root<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">\/build<\/span>'<\/span>;\n\n<span class=\"pl-k\">if<\/span> (!<span class=\"pl-en\">is_file<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>source<\/span>)) {\n    <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">Calculator.php n\u00e3o encontrado.<\/span>'<\/span>);\n}\n\n<span class=\"pl-k\">if<\/span> (!<span class=\"pl-en\">is_dir<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span>) &amp;&amp; !<span class=\"pl-en\">mkdir<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span>, <span class=\"pl-c1\">0775<\/span>, <span class=\"pl-c1\">true<\/span>) &amp;&amp; !<span class=\"pl-en\">is_dir<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span>)) {\n    <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">N\u00e3o foi poss\u00edvel criar build.<\/span>'<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">Filter<\/span>();\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>-&gt;<span class=\"pl-en\">includeFiles<\/span>([<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>source<\/span>]);\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>driver<\/span> = (<span class=\"pl-k\">new<\/span> <span class=\"pl-v\">Selector<\/span>())-&gt;<span class=\"pl-en\">select<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>, Granularity::Line);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">CodeCoverage<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>driver<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>);\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span>-&gt;<span class=\"pl-en\">start<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">laboratorio-manual<\/span>'<\/span>);\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>calculator<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">Calculator<\/span>();\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>calculator<\/span>-&gt;<span class=\"pl-en\">add<\/span>(<span class=\"pl-c1\">2<\/span>, <span class=\"pl-c1\">3<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>calculator<\/span>-&gt;<span class=\"pl-en\">divide<\/span>(<span class=\"pl-c1\">10<\/span>, <span class=\"pl-c1\">5<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>calculator<\/span>-&gt;<span class=\"pl-en\">classifyNumber<\/span>(<span class=\"pl-c1\">9<\/span>);\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span>-&gt;<span class=\"pl-en\">stop<\/span>();\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span> = ReportFacade::<span class=\"pl-en\">fromObject<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>coverage<\/span>);\n\n<span class=\"pl-k\">echo<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderText<\/span>(<span class=\"pl-c1\">null<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderClover<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">\/clover.xml<\/span>'<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderHtml<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">\/html<\/span>'<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>report<\/span>-&gt;<span class=\"pl-en\">renderJsonl<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">\/jsonl<\/span>'<\/span>);\n\n<span class=\"pl-k\">echo<\/span> <span class=\"pl-c1\">PHP_EOL<\/span> . <span class=\"pl-s\">'<span class=\"pl-s\">Relat\u00f3rios gerados em: <\/span>'<\/span> . <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>output<\/span> . <span class=\"pl-c1\">PHP_EOL<\/span>;<\/pre><\/div>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>O que esse c\u00f3digo demonstra:<\/strong> utilizamos a API real da biblioteca na vers\u00e3o estudada. Executamos tr\u00eas opera\u00e7\u00f5es manualmente para observar a coleta, mas ainda precisamos de testes com asser\u00e7\u00f5es para validar os comportamentos.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">Execute no PowerShell:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>php .\\examples\\coverage<span class=\"pl-k\">-<\/span>direct.php<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Ao final, procure:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>coverage-lab\/\n\u251c\u2500\u2500 build\/\n\u2502   \u251c\u2500\u2500 clover.xml\n\u2502   \u251c\u2500\u2500 html\/\n\u2502   \u2502   \u2514\u2500\u2500 index.html\n\u2502   \u2514\u2500\u2500 jsonl\/\n\u2502       \u251c\u2500\u2500 meta.json\n\u2502       \u251c\u2500\u2500 coverage.jsonl\n\u2502       \u2514\u2500\u2500 tests.jsonl\n\u2514\u2500\u2500 examples\/\n    \u2514\u2500\u2500 coverage-direct.php\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">A execu\u00e7\u00e3o deve gerar as sa\u00eddas descritas <strong>quando a instala\u00e7\u00e3o e o driver estiverem corretos<\/strong>. N\u00e3o afirmamos uma porcentagem antecipadamente, pois ela depende dos caminhos percorridos, do filtro e da vers\u00e3o exata do c\u00f3digo.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"94_Compare_com_o_PHPUnit\"><\/span>9.4. Compare com o PHPUnit<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-94-compare-com-o-phpunit\" class=\"anchor\" aria-label=\"Permalink: 9.4. Compare com o PHPUnit\" href=\"#94-compare-com-o-phpunit\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Se o laborat\u00f3rio da Aula 1 j\u00e1 estiver configurado com PHPUnit, fa\u00e7a a coleta pela su\u00edte:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>.\\vendor\\bin\\phpunit <span class=\"pl-k\">--<\/span>coverage<span class=\"pl-k\">-<\/span>clover build\\clover.xml<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Compare o XML do teste automatizado com o XML do nosso script manual. Os resultados podem diferir: no segundo caso, somente as tr\u00eas chamadas do exemplo s\u00e3o exercitadas.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"10_Laboratorio_B_%E2%80%94_Comecando_o_CoverageRadar_PHP\"><\/span>10. Laborat\u00f3rio B \u2014 Come\u00e7ando o CoverageRadar PHP<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-10-laborat\u00f3rio-b--come\u00e7ando-o-coverageradar-php\" class=\"anchor\" aria-label=\"Permalink: 10. Laborat\u00f3rio B \u2014 Come\u00e7ando o CoverageRadar PHP\" href=\"#10-laborat%C3%B3rio-b--come%C3%A7ando-o-coverageradar-php\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Agora come\u00e7a a parte do <strong>nosso produto<\/strong>. Em vez de repetir a coleta do php-code-coverage, criaremos um pequeno programa capaz de <strong>importar Clover XML<\/strong>, extrair a cobertura do projeto e produzir um resumo JSON.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esta decis\u00e3o \u00e9 importante para a monetiza\u00e7\u00e3o futura: um dashboard pode receber relat\u00f3rios gerados no computador ou no pipeline de CI de cada equipe, sem executar o c\u00f3digo enviado pelo cliente.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"101_Primeiro_contrato_de_entrada_e_saida\"><\/span>10.1. Primeiro contrato de entrada e sa\u00edda<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-101-primeiro-contrato-de-entrada-e-sa\u00edda\" class=\"anchor\" aria-label=\"Permalink: 10.1. Primeiro contrato de entrada e sa\u00edda\" href=\"#101-primeiro-contrato-de-entrada-e-sa%C3%ADda\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Entrada:<\/strong> caminho para um XML Clover v\u00e1lido.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sa\u00edda:<\/strong> JSON com:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>formato de origem;<\/li>\n\n\n\n<li>total de linhas execut\u00e1veis;<\/li>\n\n\n\n<li>total de linhas executadas;<\/li>\n\n\n\n<li>porcentagem geral;<\/li>\n\n\n\n<li>rela\u00e7\u00e3o de arquivos e suas porcentagens.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">O objetivo \u00e9 manter um primeiro contrato simples e previs\u00edvel.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>clover.xml\n    |\n    v\nCoverageRadar PHP: Clover Reader\n    |\n    +--&gt; valida XML e m\u00e9tricas\n    +--&gt; extrai totais do projeto\n    +--&gt; extrai m\u00e9tricas por arquivo\n    +--&gt; ordena arquivos por menor cobertura\n    |\n    v\nResumo JSON\n<\/code><\/pre>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"102_Entendendo_as_metricas_Clover\"><\/span>10.2. Entendendo as m\u00e9tricas Clover<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-102-entendendo-as-m\u00e9tricas-clover\" class=\"anchor\" aria-label=\"Permalink: 10.2. Entendendo as m\u00e9tricas Clover\" href=\"#102-entendendo-as-m%C3%A9tricas-clover\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Um trecho <strong>simplificado e ilustrativo<\/strong> pode ter este formato:<\/p>\n\n\n\n<div class=\"highlight highlight-text-xml\"><pre>&lt;?<span class=\"pl-ent\">xml<\/span><span class=\"pl-e\"> version<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>1.0<span class=\"pl-pds\">\"<\/span><\/span><span class=\"pl-e\"> encoding<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>UTF-8<span class=\"pl-pds\">\"<\/span><\/span>?&gt;\n&lt;<span class=\"pl-ent\">coverage<\/span> <span class=\"pl-e\">generated<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>0<span class=\"pl-pds\">\"<\/span><\/span>&gt;\n  &lt;<span class=\"pl-ent\">project<\/span> <span class=\"pl-e\">name<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>Exemplo<span class=\"pl-pds\">\"<\/span><\/span> <span class=\"pl-e\">timestamp<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>0<span class=\"pl-pds\">\"<\/span><\/span>&gt;\n    &lt;<span class=\"pl-ent\">file<\/span> <span class=\"pl-e\">name<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>src\/Calculator.php<span class=\"pl-pds\">\"<\/span><\/span>&gt;\n      &lt;<span class=\"pl-ent\">metrics<\/span> <span class=\"pl-e\">statements<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>10<span class=\"pl-pds\">\"<\/span><\/span> <span class=\"pl-e\">coveredstatements<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>7<span class=\"pl-pds\">\"<\/span><\/span>\/&gt;\n    &lt;\/<span class=\"pl-ent\">file<\/span>&gt;\n    &lt;<span class=\"pl-ent\">metrics<\/span> <span class=\"pl-e\">statements<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>10<span class=\"pl-pds\">\"<\/span><\/span> <span class=\"pl-e\">coveredstatements<\/span>=<span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>7<span class=\"pl-pds\">\"<\/span><\/span>\/&gt;\n  &lt;\/<span class=\"pl-ent\">project<\/span>&gt;\n&lt;\/<span class=\"pl-ent\">coverage<\/span>&gt;<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">No formato gerado pela vers\u00e3o estudada, <strong>statements<\/strong> representa linhas execut\u00e1veis e <strong>coveredstatements<\/strong> representa as executadas. A f\u00f3rmula do nosso c\u00e1lculo \u00e9:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Cobertura (%) = 100 \u00d7 linhas executadas \/ linhas execut\u00e1veis.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para o exemplo: <strong>7 \/ 10 = 70%<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cuidado: o arquivo real pode conter <strong>package<\/strong>, <strong>class<\/strong>, <strong>line<\/strong> e outros n\u00f3s <strong>metrics<\/strong>. N\u00e3o devemos pegar o primeiro elemento metrics do documento por acaso. Precisamos selecionar precisamente <strong>\/coverage\/project\/metrics<\/strong> para a cobertura global.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"103_Crie_o_nosso_primeiro_leitor\"><\/span>10.3. Crie o nosso primeiro leitor<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-103-crie-o-nosso-primeiro-leitor\" class=\"anchor\" aria-label=\"Permalink: 10.3. Crie o nosso primeiro leitor\" href=\"#103-crie-o-nosso-primeiro-leitor\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Salve como <strong>coverage-radar\/ler-clover.php<\/strong>, na raiz do laborat\u00f3rio:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-ent\">&lt;?php<\/span>\n\n<span class=\"pl-k\">declare<\/span>(strict_types=<span class=\"pl-c1\">1<\/span>);\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>path<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>argv<\/span>[<span class=\"pl-c1\">1<\/span>] ?? <span class=\"pl-s\">''<\/span>;\n\n<span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>path<\/span> === <span class=\"pl-s\">''<\/span> || !<span class=\"pl-en\">is_file<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>path<\/span>) || !<span class=\"pl-en\">is_readable<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>path<\/span>)) {\n    <span class=\"pl-en\">fwrite<\/span>(<span class=\"pl-c1\">STDERR<\/span>, <span class=\"pl-s\">\"<span class=\"pl-s\">Uso: php coverage-radar\/ler-clover.php build\/clover.xml<\/span>\\n\"<\/span>);\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>size<\/span> = <span class=\"pl-en\">filesize<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>path<\/span>);\n\n<span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>size<\/span> === <span class=\"pl-c1\">false<\/span> || <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>size<\/span> &gt; <span class=\"pl-c1\">5<\/span> * <span class=\"pl-c1\">1024<\/span> * <span class=\"pl-c1\">1024<\/span>) {\n    <span class=\"pl-en\">fwrite<\/span>(<span class=\"pl-c1\">STDERR<\/span>, <span class=\"pl-s\">\"<span class=\"pl-s\">XML ausente ou maior que o limite de 5 MiB.<\/span>\\n\"<\/span>);\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>content<\/span> = <span class=\"pl-en\">file_get_contents<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>path<\/span>);\n\n<span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>content<\/span> === <span class=\"pl-c1\">false<\/span> || <span class=\"pl-en\">preg_match<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">\/&lt;!\\s*(DOCTYPE|ENTITY)\\b\/i<\/span>'<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>content<\/span>)) {\n    <span class=\"pl-en\">fwrite<\/span>(<span class=\"pl-c1\">STDERR<\/span>, <span class=\"pl-s\">\"<span class=\"pl-s\">XML n\u00e3o permitido.<\/span>\\n\"<\/span>);\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>previous<\/span> = <span class=\"pl-en\">libxml_use_internal_errors<\/span>(<span class=\"pl-c1\">true<\/span>);\n\n<span class=\"pl-k\">try<\/span> {\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>document<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">DOMDocument<\/span>();\n\n    <span class=\"pl-k\">if<\/span> (!<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>document<\/span>-&gt;<span class=\"pl-en\">loadXML<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>content<\/span>, <span class=\"pl-c1\">LIBXML_NONET<\/span>)) {\n        <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">XML malformado.<\/span>'<\/span>);\n    }\n} <span class=\"pl-k\">catch<\/span> (<span class=\"pl-smi\"><span class=\"pl-smi\">Throwable<\/span><\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>error<\/span>) {\n    <span class=\"pl-en\">fwrite<\/span>(<span class=\"pl-c1\">STDERR<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>error<\/span>-&gt;<span class=\"pl-en\">getMessage<\/span>() . <span class=\"pl-c1\">PHP_EOL<\/span>);\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n} <span class=\"pl-k\">finally<\/span> {\n    <span class=\"pl-en\">libxml_clear_errors<\/span>();\n    <span class=\"pl-en\">libxml_use_internal_errors<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>previous<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>xpath<\/span> = <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">DOMXPath<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>document<\/span>);\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>projectMetrics<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>xpath<\/span>-&gt;<span class=\"pl-en\">query<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">\/coverage\/project\/metrics<\/span>'<\/span>);\n\n<span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>projectMetrics<\/span> === <span class=\"pl-c1\">false<\/span> || <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>projectMetrics<\/span>-&gt;<span class=\"pl-c1\">length<\/span> !== <span class=\"pl-c1\">1<\/span>) {\n    <span class=\"pl-en\">fwrite<\/span>(<span class=\"pl-c1\">STDERR<\/span>, <span class=\"pl-s\">\"<span class=\"pl-s\">Clover sem m\u00e9tricas do projeto.<\/span>\\n\"<\/span>);\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>metrics<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>projectMetrics<\/span>-&gt;<span class=\"pl-en\">item<\/span>(<span class=\"pl-c1\">0<\/span>);\n\n<span class=\"pl-k\">if<\/span> (!<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>metrics<\/span> <span class=\"pl-k\">instanceof<\/span> DOMElement) {\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n}\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>readCounts<\/span> = <span class=\"pl-k\">static<\/span> <span class=\"pl-k\">function<\/span> (<span class=\"pl-smi\"><span class=\"pl-smi\">DOMElement<\/span><\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>element<\/span>): <span class=\"pl-smi\">array<\/span> {\n    <span class=\"pl-k\">foreach<\/span> ([<span class=\"pl-s\">'<span class=\"pl-s\">statements<\/span>'<\/span>, <span class=\"pl-s\">'<span class=\"pl-s\">coveredstatements<\/span>'<\/span>] <span class=\"pl-k\">as<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>name<\/span>) {\n        <span class=\"pl-k\">if<\/span> (!<span class=\"pl-en\">preg_match<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">\/^\\d+$\/<\/span>'<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>element<\/span>-&gt;<span class=\"pl-en\">getAttribute<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>name<\/span>))) {\n            <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">\"<span class=\"pl-s\">M\u00e9trica inv\u00e1lida: <\/span><span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>name<\/span>\"<\/span>);\n        }\n    }\n\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span> = (<span class=\"pl-smi\">int<\/span>) <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>element<\/span>-&gt;<span class=\"pl-en\">getAttribute<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">statements<\/span>'<\/span>);\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span> = (<span class=\"pl-smi\">int<\/span>) <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>element<\/span>-&gt;<span class=\"pl-en\">getAttribute<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">coveredstatements<\/span>'<\/span>);\n\n    <span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span> &gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>) {\n        <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">Linhas cobertas excedem o total.<\/span>'<\/span>);\n    }\n\n    <span class=\"pl-k\">return<\/span> [<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span>];\n};\n\n<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>percentage<\/span> = <span class=\"pl-k\">static<\/span> <span class=\"pl-k\">function<\/span> (<span class=\"pl-smi\">int<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>, <span class=\"pl-smi\">int<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span>): ?<span class=\"pl-smi\">float<\/span> {\n    <span class=\"pl-k\">return<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span> === <span class=\"pl-c1\">0<\/span> ? <span class=\"pl-c1\">null<\/span> : <span class=\"pl-en\">round<\/span>(<span class=\"pl-c1\">100<\/span> * <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span> \/ <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>, <span class=\"pl-c1\">2<\/span>);\n};\n\n<span class=\"pl-k\">try<\/span> {\n    [<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span>] = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>readCounts<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>metrics<\/span>);\n\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>files<\/span> = [];\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNodes<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>xpath<\/span>-&gt;<span class=\"pl-en\">query<\/span>(\n        <span class=\"pl-s\">'<span class=\"pl-s\">\/coverage\/project\/file | \/coverage\/project\/package\/file<\/span>'<\/span>\n    );\n\n    <span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNodes<\/span> === <span class=\"pl-c1\">false<\/span>) {\n        <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">N\u00e3o foi poss\u00edvel consultar arquivos.<\/span>'<\/span>);\n    }\n\n    <span class=\"pl-k\">foreach<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNodes<\/span> <span class=\"pl-k\">as<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNode<\/span>) {\n        <span class=\"pl-k\">if<\/span> (!<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNode<\/span> <span class=\"pl-k\">instanceof<\/span> DOMElement) {\n            <span class=\"pl-k\">continue<\/span>;\n        }\n\n        <span class=\"pl-c\">\/\/ Busca apenas metrics filho direto do file.<\/span>\n        <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetrics<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>xpath<\/span>-&gt;<span class=\"pl-en\">query<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">.\/metrics<\/span>'<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNode<\/span>);\n\n        <span class=\"pl-k\">if<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetrics<\/span> === <span class=\"pl-c1\">false<\/span> || <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetrics<\/span>-&gt;<span class=\"pl-c1\">length<\/span> !== <span class=\"pl-c1\">1<\/span>) {\n            <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">Arquivo sem m\u00e9tricas v\u00e1lidas.<\/span>'<\/span>);\n        }\n\n        <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetric<\/span> = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetrics<\/span>-&gt;<span class=\"pl-en\">item<\/span>(<span class=\"pl-c1\">0<\/span>);\n\n        <span class=\"pl-k\">if<\/span> (!<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetric<\/span> <span class=\"pl-k\">instanceof<\/span> DOMElement) {\n            <span class=\"pl-k\">throw<\/span> <span class=\"pl-k\">new<\/span> <span class=\"pl-v\">RuntimeException<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">M\u00e9tricas inv\u00e1lidas.<\/span>'<\/span>);\n        }\n\n        [<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileTotal<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileCovered<\/span>] = <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>readCounts<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileMetric<\/span>);\n\n        <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>files<\/span>[] = [\n            <span class=\"pl-s\">'<span class=\"pl-s\">file<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileNode<\/span>-&gt;<span class=\"pl-en\">getAttribute<\/span>(<span class=\"pl-s\">'<span class=\"pl-s\">name<\/span>'<\/span>),\n            <span class=\"pl-s\">'<span class=\"pl-s\">executableLines<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileTotal<\/span>,\n            <span class=\"pl-s\">'<span class=\"pl-s\">executedLines<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileCovered<\/span>,\n            <span class=\"pl-s\">'<span class=\"pl-s\">coveragePercent<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>percentage<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileTotal<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>fileCovered<\/span>),\n        ];\n    }\n\n    <span class=\"pl-en\">usort<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>files<\/span>, <span class=\"pl-k\">static<\/span> <span class=\"pl-k\">function<\/span> (<span class=\"pl-smi\">array<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>a<\/span>, <span class=\"pl-smi\">array<\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>b<\/span>): <span class=\"pl-smi\">int<\/span> {\n        <span class=\"pl-k\">return<\/span> (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>a<\/span>[<span class=\"pl-s\">'<span class=\"pl-s\">coveragePercent<\/span>'<\/span>] ?? -<span class=\"pl-c1\">1<\/span>)\n            &lt;=&gt; (<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>b<\/span>[<span class=\"pl-s\">'<span class=\"pl-s\">coveragePercent<\/span>'<\/span>] ?? -<span class=\"pl-c1\">1<\/span>);\n    });\n\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>result<\/span> = [\n        <span class=\"pl-s\">'<span class=\"pl-s\">format<\/span>'<\/span> =&gt; <span class=\"pl-s\">'<span class=\"pl-s\">clover<\/span>'<\/span>,\n        <span class=\"pl-s\">'<span class=\"pl-s\">summary<\/span>'<\/span> =&gt; [\n            <span class=\"pl-s\">'<span class=\"pl-s\">executableLines<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>,\n            <span class=\"pl-s\">'<span class=\"pl-s\">executedLines<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span>,\n            <span class=\"pl-s\">'<span class=\"pl-s\">coveragePercent<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>percentage<\/span>(<span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>total<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>covered<\/span>),\n        ],\n        <span class=\"pl-s\">'<span class=\"pl-s\">files<\/span>'<\/span> =&gt; <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>files<\/span>,\n    ];\n\n    <span class=\"pl-k\">echo<\/span> <span class=\"pl-en\">json_encode<\/span>(\n        <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>result<\/span>,\n        <span class=\"pl-c1\">JSON_PRETTY_PRINT<\/span> | <span class=\"pl-c1\">JSON_UNESCAPED_UNICODE<\/span>\n        | <span class=\"pl-c1\">JSON_UNESCAPED_SLASHES<\/span> | <span class=\"pl-c1\">JSON_THROW_ON_ERROR<\/span>\n    ), <span class=\"pl-c1\">PHP_EOL<\/span>;\n} <span class=\"pl-k\">catch<\/span> (<span class=\"pl-smi\"><span class=\"pl-smi\">Throwable<\/span><\/span> <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>error<\/span>) {\n    <span class=\"pl-en\">fwrite<\/span>(<span class=\"pl-c1\">STDERR<\/span>, <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>error<\/span>-&gt;<span class=\"pl-en\">getMessage<\/span>() . <span class=\"pl-c1\">PHP_EOL<\/span>);\n    <span class=\"pl-en\">exit<\/span>(<span class=\"pl-c1\">2<\/span>);\n}<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Execute:<\/p>\n\n\n\n<div class=\"highlight highlight-source-powershell\"><pre>php .\\coverage<span class=\"pl-k\">-<\/span>radar\\ler<span class=\"pl-k\">-<\/span>clover.php .\\build\\clover.xml<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Sa\u00edda ilustrativa<\/strong>, n\u00e3o resultado medido nesta li\u00e7\u00e3o:<\/p>\n\n\n\n<div class=\"highlight highlight-source-json\"><pre>{\n  <span class=\"pl-ent\">\"format\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>clover<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"summary\"<\/span>: {\n    <span class=\"pl-ent\">\"executableLines\"<\/span>: <span class=\"pl-c1\">10<\/span>,\n    <span class=\"pl-ent\">\"executedLines\"<\/span>: <span class=\"pl-c1\">7<\/span>,\n    <span class=\"pl-ent\">\"coveragePercent\"<\/span>: <span class=\"pl-c1\">70<\/span>\n  },\n  <span class=\"pl-ent\">\"files\"<\/span>: [\n    {\n      <span class=\"pl-ent\">\"file\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>src\/Calculator.php<span class=\"pl-pds\">\"<\/span><\/span>,\n      <span class=\"pl-ent\">\"executableLines\"<\/span>: <span class=\"pl-c1\">10<\/span>,\n      <span class=\"pl-ent\">\"executedLines\"<\/span>: <span class=\"pl-c1\">7<\/span>,\n      <span class=\"pl-ent\">\"coveragePercent\"<\/span>: <span class=\"pl-c1\">70<\/span>\n    }\n  ]\n}<\/pre><\/div>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"O_que_acabamos_de_construir\"><\/span>O que acabamos de construir?<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-o-que-acabamos-de-construir\" class=\"anchor\" aria-label=\"Permalink: O que acabamos de construir?\" href=\"#o-que-acabamos-de-construir\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Criamos um <strong>prot\u00f3tipo CLI independente<\/strong> capaz de ler m\u00e9tricas reais de um relat\u00f3rio Clover e transform\u00e1-las em dados estruturados. Esse \u00e9 o primeiro passo concreto em dire\u00e7\u00e3o ao CoverageRadar PHP.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Limita\u00e7\u00f5es intencionais deste prot\u00f3tipo:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>n\u00e3o importa dados de branches, m\u00e9todos, hit counts ou complexidade;<\/li>\n\n\n\n<li>n\u00e3o verifica todas as regras do esquema Clover;<\/li>\n\n\n\n<li>limita o XML local a 5 MiB apenas para manter o exerc\u00edcio controlado;<\/li>\n\n\n\n<li>usa o nome de arquivo que consta no relat\u00f3rio, que pode ser um caminho absoluto;<\/li>\n\n\n\n<li>ainda n\u00e3o possui testes pr\u00f3prios, interface web, banco de dados nem autentica\u00e7\u00e3o;<\/li>\n\n\n\n<li><br><strong>n\u00e3o deve ser exposto como servi\u00e7o de upload p\u00fablico<\/strong>.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">No c\u00f3digo de produ\u00e7\u00e3o, precisaremos limitar recursos, endurecer valida\u00e7\u00f5es, evitar exposi\u00e7\u00e3o de caminhos privados e isolar a ingest\u00e3o de dados. O leitor <strong>nunca deve executar arquivos PHP recebidos de terceiros<\/strong>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"11_Por_que_separar_nosso_sistema_do_coletor\"><\/span>11. Por que separar nosso sistema do coletor?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-11-por-que-separar-nosso-sistema-do-coletor\" class=\"anchor\" aria-label=\"Permalink: 11. Por que separar nosso sistema do coletor?\" href=\"#11-por-que-separar-nosso-sistema-do-coletor\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Poder\u00edamos instalar PCOV ou Xdebug no servidor SaaS, receber reposit\u00f3rios e executar testes remotamente? Tecnicamente, h\u00e1 cen\u00e1rios em que isso \u00e9 poss\u00edvel. Por\u00e9m, para o MVP, essa escolha criaria riscos de seguran\u00e7a e custos operacionais muito maiores.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Vamos separar:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>M\u00c1QUINA DO DESENVOLVEDOR \/ CI\n  - executa PHPUnit\n  - usa Xdebug ou PCOV\n  - gera Clover ou JSONL\n               |\n               | envia somente o relat\u00f3rio\n               v\nCOVERAGERADAR PHP\n  - autentica o projeto\n  - valida o arquivo\n  - importa m\u00e9tricas\n  - armazena hist\u00f3rico\n  - compara builds\n  - exibe dashboards\n  - dispara alertas\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Essa divis\u00e3o permite que a plataforma se concentre em <strong>importa\u00e7\u00e3o, an\u00e1lise hist\u00f3rica e apresenta\u00e7\u00e3o<\/strong>, reduzindo a necessidade de executar c\u00f3digo n\u00e3o confi\u00e1vel no servidor.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"12_Nossa_arquitetura_futura\"><\/span>12. Nossa arquitetura futura<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-12-nossa-arquitetura-futura\" class=\"anchor\" aria-label=\"Permalink: 12. Nossa arquitetura futura\" href=\"#12-nossa-arquitetura-futura\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Come\u00e7aremos simples, mas j\u00e1 podemos imaginar responsabilidades de uma aplica\u00e7\u00e3o evolutiva:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>coverage-radar\/\n\u251c\u2500\u2500 src\/\n\u2502   \u251c\u2500\u2500 Domain\/\n\u2502   \u2502   \u251c\u2500\u2500 CoverageSummary.php\n\u2502   \u2502   \u2514\u2500\u2500 FileCoverage.php\n\u2502   \u251c\u2500\u2500 Importer\/\n\u2502   \u2502   \u251c\u2500\u2500 CloverImporter.php\n\u2502   \u2502   \u2514\u2500\u2500 JsonlImporter.php\n\u2502   \u251c\u2500\u2500 Analyzer\/\n\u2502   \u2502   \u251c\u2500\u2500 CoverageTrendAnalyzer.php\n\u2502   \u2502   \u2514\u2500\u2500 RiskAnalyzer.php\n\u2502   \u2514\u2500\u2500 Report\/\n\u2502       \u2514\u2500\u2500 JsonSummaryReport.php\n\u251c\u2500\u2500 tests\/\n\u2502   \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 public\/\n\u2502   \u2514\u2500\u2500 index.php\n\u2514\u2500\u2500 composer.json\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Essa estrutura \u00e9 um <strong>projeto proposto<\/strong>, ainda n\u00e3o um conjunto de arquivos publicados. No exerc\u00edcio de hoje, implementamos apenas o pequeno <strong>ler-clover.php<\/strong> dentro do laborat\u00f3rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Na pr\u00f3xima itera\u00e7\u00e3o, vamos extrair classes, introduzir testes de unidade para o importador e criar dados de exemplo. Depois poderemos adicionar armazenamento de projetos e builds.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"13_Qualidade_de_dados_armadilhas_que_o_produto_precisara_tratar\"><\/span>13. Qualidade de dados: armadilhas que o produto precisar\u00e1 tratar<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-13-qualidade-de-dados-armadilhas-que-o-produto-precisar\u00e1-tratar\" class=\"anchor\" aria-label=\"Permalink: 13. Qualidade de dados: armadilhas que o produto precisar\u00e1 tratar\" href=\"#13-qualidade-de-dados-armadilhas-que-o-produto-precisar%C3%A1-tratar\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Uma plataforma de cobertura pode gerar relat\u00f3rios bonitos e ainda assim apresentar m\u00e9tricas incorretas. Antes da monetiza\u00e7\u00e3o, alguns cuidados ser\u00e3o obrigat\u00f3rios:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Arquivos ignorados:<\/strong> um relat\u00f3rio que exclui metade do c\u00f3digo n\u00e3o oferece um retrato completo do projeto. Precisaremos deixar claro qual foi o escopo informado pela ferramenta coletora.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Zero linhas execut\u00e1veis:<\/strong> dividir por zero seria incorreto. No nosso leitor, retornamos <strong>null<\/strong> quando n\u00e3o existe denominador; isso significa <strong>n\u00e3o aplic\u00e1vel<\/strong>, e n\u00e3o cobertura zero.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Relat\u00f3rios duplicados:<\/strong> importar duas vezes o mesmo build n\u00e3o deveria criar duas vers\u00f5es hist\u00f3ricas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Caminhos absolutos:<\/strong> arquivos Clover podem conter caminhos locais ou nomes que revelam detalhes internos. Em um SaaS, devemos normalizar, restringir acesso e evitar exibi-los publicamente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Dados incompat\u00edveis:<\/strong> relat\u00f3rios gerados por vers\u00f5es e ferramentas diferentes podem exigir adaptadores espec\u00edficos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>M\u00e9tricas de linha versus ramo:<\/strong> um arquivo pode ter todas as linhas executadas e, mesmo assim, conter decis\u00f5es n\u00e3o testadas. Nunca misture duas m\u00e9tricas diferentes como se fossem a mesma porcentagem.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"14_Exercicios_praticos\"><\/span>14. Exerc\u00edcios pr\u00e1ticos<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-14-exerc\u00edcios-pr\u00e1ticos\" class=\"anchor\" aria-label=\"Permalink: 14. Exerc\u00edcios pr\u00e1ticos\" href=\"#14-exerc%C3%ADcios-pr%C3%A1ticos\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_1_%E2%80%94_Mude_o_filtro\"><\/span>Exerc\u00edcio 1 \u2014 Mude o filtro<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-1--mude-o-filtro\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 1 \u2014 Mude o filtro\" href=\"#exerc%C3%ADcio-1--mude-o-filtro\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Inclua outro arquivo PHP de produ\u00e7\u00e3o no filtro do Laborat\u00f3rio A. N\u00e3o execute seu c\u00f3digo. Verifique como a cobertura global muda ao incluir arquivos eleg\u00edveis que ficaram sem execu\u00e7\u00e3o.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_2_%E2%80%94_Teste_branches\"><\/span>Exerc\u00edcio 2 \u2014 Teste branches<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-2--teste-branches\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 2 \u2014 Teste branches\" href=\"#exerc%C3%ADcio-2--teste-branches\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Se tiver Xdebug habilitado, troque o seletor para:<\/p>\n\n\n\n<div class=\"highlight highlight-text-html-php\"><pre><span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>driver<\/span> = (<span class=\"pl-k\">new<\/span> <span class=\"pl-v\">Selector<\/span>())-&gt;<span class=\"pl-en\">select<\/span>(\n    <span class=\"pl-s1\"><span class=\"pl-c1\">$<\/span>filter<\/span>,\n    Granularity::LineAndBranch\n);<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Observe se o relat\u00f3rio passa a exibir informa\u00e7\u00f5es adicionais. N\u00e3o use essa configura\u00e7\u00e3o apenas com PCOV.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_3_%E2%80%94_Compare_formatos\"><\/span>Exerc\u00edcio 3 \u2014 Compare formatos<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-3--compare-formatos\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 3 \u2014 Compare formatos\" href=\"#exerc%C3%ADcio-3--compare-formatos\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Gere <strong>Clover<\/strong> e <strong>JSONL<\/strong> com os mesmos dados. Confira quais informa\u00e7\u00f5es aparecem nos arquivos e quais existem apenas em um dos formatos.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_4_%E2%80%94_Valide_XML_invalido\"><\/span>Exerc\u00edcio 4 \u2014 Valide XML inv\u00e1lido<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-4--valide-xml-inv\u00e1lido\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 4 \u2014 Valide XML inv\u00e1lido\" href=\"#exerc%C3%ADcio-4--valide-xml-inv%C3%A1lido\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Entregue ao nosso importador um arquivo de texto que n\u00e3o seja XML. Depois forne\u00e7a um Clover sem <strong>\/coverage\/project\/metrics<\/strong>. O programa deve recusar as duas entradas.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_5_%E2%80%94_Ordenacao_e_metricas\"><\/span>Exerc\u00edcio 5 \u2014 Ordena\u00e7\u00e3o e m\u00e9tricas<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-5--ordena\u00e7\u00e3o-e-m\u00e9tricas\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 5 \u2014 Ordena\u00e7\u00e3o e m\u00e9tricas\" href=\"#exerc%C3%ADcio-5--ordena%C3%A7%C3%A3o-e-m%C3%A9tricas\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Crie um Clover de teste com tr\u00eas arquivos: 25%, 80% e 60% de cobertura. Verifique se o JSON retorna os arquivos na ordem esperada. Compare tamb\u00e9m os totais globais.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Desafio_extra_%E2%80%94_Primeiro_teste_automatizado_do_produto\"><\/span>Desafio extra \u2014 Primeiro teste automatizado do produto<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-desafio-extra--primeiro-teste-automatizado-do-produto\" class=\"anchor\" aria-label=\"Permalink: Desafio extra \u2014 Primeiro teste automatizado do produto\" href=\"#desafio-extra--primeiro-teste-automatizado-do-produto\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Separe a leitura do XML em uma classe <strong>CloverImporter<\/strong> e teste os cen\u00e1rios:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>projeto com linhas cobertas;<\/li>\n\n\n\n<li>projeto sem linhas execut\u00e1veis;<\/li>\n\n\n\n<li>arquivo com zero execu\u00e7\u00e3o;<\/li>\n\n\n\n<li>m\u00e9trica ausente;<\/li>\n\n\n\n<li>quantidade coberta superior ao total;<\/li>\n\n\n\n<li>XML malformado;<\/li>\n\n\n\n<li>presen\u00e7a de DTD;<\/li>\n\n\n\n<li>arquivo muito grande.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Essa transforma\u00e7\u00e3o ser\u00e1 uma das primeiras etapas necess\u00e1rias para tornar o CoverageRadar PHP confi\u00e1vel.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"15_Questoes_de_revisao\"><\/span>15. Quest\u00f5es de revis\u00e3o<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-15-quest\u00f5es-de-revis\u00e3o\" class=\"anchor\" aria-label=\"Permalink: 15. Quest\u00f5es de revis\u00e3o\" href=\"#15-quest%C3%B5es-de-revis%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>1. Quem coleta diretamente as informa\u00e7\u00f5es de execu\u00e7\u00e3o do PHP?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) A p\u00e1gina HTML do relat\u00f3rio<br>\nB) Uma extens\u00e3o como Xdebug ou PCOV<br>\nC) O banco de dados MySQL<br>\nD) O navegador<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>2. Para que serve o Filter?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Alterar resultados dos testes<br>\nB) Escolher arquivos eleg\u00edveis para cobertura<br>\nC) Salvar senhas<br>\nD) Converter PHP em JavaScript<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>3. Qual API devemos preferir na vers\u00e3o 14.4.1 para selecionar granularidade?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) select() com Granularity<br>\nB) Apenas forLineCoverage(), sem alternativas<br>\nC) selectFormat()<br>\nD) buildDriverFromHtml()<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>4. Qual \u00e9 a principal fun\u00e7\u00e3o de Report\\Facade?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Executar testes no navegador<br>\nB) Gerar relat\u00f3rios a partir dos dados processados<br>\nC) Substituir o Xdebug<br>\nD) Gerenciar usu\u00e1rios do SaaS<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>5. Qual formato usaremos no primeiro importador do CoverageRadar PHP?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) PDF<br>\nB) ZIP de reposit\u00f3rios<br>\nC) Clover XML<br>\nD) Arquivos execut\u00e1veis<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>6. Cobertura de 100% garante aus\u00eancia de bugs?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Sim, sempre<br>\nB) Apenas no Windows<br>\nC) N\u00e3o: execu\u00e7\u00e3o n\u00e3o prova que todas as expectativas foram verificadas<br>\nD) Apenas com PCOV<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>7. Em Clover, onde encontramos as m\u00e9tricas gerais do projeto?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) \/coverage\/project\/metrics<br>\nB) \/coverage\/file\/name<br>\nC) \/html\/body<br>\nD) \/phpunit\/password<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>8. Por que n\u00e3o executaremos c\u00f3digo PHP enviado por clientes no MVP?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Porque Clover exige Java<br>\nB) Porque n\u00e3o existe PHPUnit no servidor<br>\nC) Para reduzir riscos e complexidade de executar c\u00f3digo n\u00e3o confi\u00e1vel<br>\nD) Porque relat\u00f3rios XML n\u00e3o t\u00eam m\u00e9tricas<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Gabarito_comentado\"><\/span>Gabarito comentado<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-gabarito-comentado\" class=\"anchor\" aria-label=\"Permalink: Gabarito comentado\" href=\"#gabarito-comentado\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Quest\u00e3o<\/th><th>Resposta<\/th><th>Coment\u00e1rio<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td>B<\/td><td>O driver conversa com PCOV ou Xdebug.<\/td><\/tr><tr><td>2<\/td><td>B<\/td><td>O filtro delimita o c\u00f3digo eleg\u00edvel.<\/td><\/tr><tr><td>3<\/td><td>A<\/td><td>select() recebe um valor da enum Granularity.<\/td><\/tr><tr><td>4<\/td><td>B<\/td><td>A fachada exp\u00f5e as diferentes sa\u00eddas.<\/td><\/tr><tr><td>5<\/td><td>C<\/td><td>Clover \u00e9 o primeiro contrato de importa\u00e7\u00e3o.<\/td><\/tr><tr><td>6<\/td><td>C<\/td><td>Cobertura \u00e9 um sinal de execu\u00e7\u00e3o, n\u00e3o prova de corre\u00e7\u00e3o.<\/td><\/tr><tr><td>7<\/td><td>A<\/td><td>Esse caminho evita confundir m\u00e9tricas globais com as de classes e arquivos.<\/td><\/tr><tr><td>8<\/td><td>C<\/td><td>Executar c\u00f3digo arbitr\u00e1rio imp\u00f5e controles operacionais e de seguran\u00e7a muito mais complexos.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"16_Checklist_de_conclusao\"><\/span>16. Checklist de conclus\u00e3o<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-16-checklist-de-conclus\u00e3o\" class=\"anchor\" aria-label=\"Permalink: 16. Checklist de conclus\u00e3o\" href=\"#16-checklist-de-conclus%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Considere a Aula 2 conclu\u00edda quando conseguir:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>[ ] Desenhar a arquitetura da coleta at\u00e9 o relat\u00f3rio.<\/li>\n\n\n\n<li>[ ] Distinguir Filter de Driver.<\/li>\n\n\n\n<li>[ ] Explicar o papel de CodeCoverage.<\/li>\n\n\n\n<li>[ ] Reconhecer os tr\u00eas valores de Granularity.<\/li>\n\n\n\n<li>[ ] Identificar os m\u00e9todos deprecated do Selector.<\/li>\n\n\n\n<li>[ ] Executar o Laborat\u00f3rio A com um driver compat\u00edvel.<\/li>\n\n\n\n<li>[ ] Produzir ao menos um Clover XML.<\/li>\n\n\n\n<li>[ ] Gerar o resumo JSON usando nosso leitor.<\/li>\n\n\n\n<li>[ ] Explicar o denominador da cobertura.<\/li>\n\n\n\n<li>[ ] Identificar limita\u00e7\u00f5es de seguran\u00e7a e escopo do prot\u00f3tipo.<\/li>\n\n\n\n<li>[ ] Responder \u00e0s oito quest\u00f5es de revis\u00e3o.<\/li>\n<\/ul>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"17_Proxima_licao_da_trilha\"><\/span>17. Pr\u00f3xima li\u00e7\u00e3o da trilha<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-17-pr\u00f3xima-li\u00e7\u00e3o-da-trilha\" class=\"anchor\" aria-label=\"Permalink: 17. Pr\u00f3xima li\u00e7\u00e3o da trilha\" href=\"#17-pr%C3%B3xima-li%C3%A7%C3%A3o-da-trilha\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Na <strong>Aula 3 \u2014 Construindo o n\u00facleo do CoverageRadar PHP com testes<\/strong>, vamos refatorar o prot\u00f3tipo em classes independentes e desenvolver uma su\u00edte pr\u00f3pria.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Nossa meta ser\u00e1 construir <strong>CloverImporter<\/strong>, <strong>CoverageSummary<\/strong> e <strong>FileCoverage<\/strong> com PHPUnit, incluindo casos de erro e relat\u00f3rios de teste. Assim, estudaremos boas pr\u00e1ticas usando, na pr\u00e1tica, o mesmo conceito que queremos vender como servi\u00e7o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depois avan\u00e7aremos para:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>persist\u00eancia de resultados em MySQL;<\/li>\n\n\n\n<li>projetos e builds com hist\u00f3rico;<\/li>\n\n\n\n<li>detec\u00e7\u00e3o de quedas de cobertura;<\/li>\n\n\n\n<li>importador de JSONL com verifica\u00e7\u00e3o de schemaVersion;<\/li>\n\n\n\n<li>dashboard web;<\/li>\n\n\n\n<li>integra\u00e7\u00e3o com CI\/CD;<\/li>\n\n\n\n<li>publica\u00e7\u00e3o e eventual monetiza\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Marco desta li\u00e7\u00e3o:<\/strong> come\u00e7amos a transi\u00e7\u00e3o do estudo de uma biblioteca reconhecida para a engenharia de uma ferramenta pr\u00f3pria, sem confundir prot\u00f3tipo did\u00e1tico com produto pronto para produ\u00e7\u00e3o.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Referencias_oficiais_e_leitura_complementar\"><\/span>Refer\u00eancias oficiais e leitura complementar<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-refer\u00eancias-oficiais-e-leitura-complementar\" class=\"anchor\" aria-label=\"Permalink: Refer\u00eancias oficiais e leitura complementar\" href=\"#refer%C3%AAncias-oficiais-e-leitura-complementar\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\" target=\"_blank\" rel=\"noopener\">Reposit\u00f3rio php-code-coverage<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/releases\/tag\/14.4.1\" target=\"_blank\" rel=\"noopener\">Release 14.4.1 \u2014 03\/10\/2026<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/CodeCoverage.php\" target=\"_blank\" rel=\"noopener\">C\u00f3digo-fonte CodeCoverage.php \u2014 tag 14.4.1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Filter.php\" target=\"_blank\" rel=\"noopener\">C\u00f3digo-fonte Filter.php \u2014 tag 14.4.1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Driver\/Selector.php\" target=\"_blank\" rel=\"noopener\">C\u00f3digo-fonte Driver\/Selector.php \u2014 tag 14.4.1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Driver\/Granularity.php\" target=\"_blank\" rel=\"noopener\">C\u00f3digo-fonte Driver\/Granularity.php \u2014 tag 14.4.1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Report\/Facade.php\" target=\"_blank\" rel=\"noopener\">C\u00f3digo-fonte Report\/Facade.php \u2014 tag 14.4.1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/src\/Report\/Clover.php\" target=\"_blank\" rel=\"noopener\">C\u00f3digo-fonte Report\/Clover.php \u2014 tag 14.4.1<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/sebastianbergmann\/php-code-coverage\/blob\/14.4.1\/ChangeLog-14.4.md\" target=\"_blank\" rel=\"noopener\">Changelog 14.4: JSONL e desempenho do merge<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/docs.phpunit.de\/en\/13.0\/code-coverage.html\" target=\"_blank\" rel=\"noopener\">Documenta\u00e7\u00e3o oficial PHPUnit \u2014 Code Coverage<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.php.net\/manual\/pt_BR\/domdocument.loadxml.php\" target=\"_blank\" rel=\"noopener\">PHP \u2014 DOMDocument::loadXML<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/getcomposer.org\/doc\/\" target=\"_blank\" rel=\"noopener\">Composer \u2014 documenta\u00e7\u00e3o<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Cr\u00e9ditos e licen\u00e7a:<\/strong> o php-code-coverage \u00e9 um projeto de Sebastian Bergmann e colaboradores, distribu\u00eddo sob a licen\u00e7a BSD-3-Clause. Os c\u00f3digos do laborat\u00f3rio e do importador apresentados aqui foram elaborados didaticamente para esta trilha; n\u00e3o representam uma c\u00f3pia da implementa\u00e7\u00e3o interna da biblioteca.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Metadescri\u00e7\u00e3o:<\/strong> Domine a arquitetura do PHP Code Coverage 14.4.1, entenda Filter, Driver e ReportFacade e crie um importador Clover em PHP para um futuro SaaS.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tags:<\/strong> PHP, PHPUnit, cobertura de c\u00f3digo, PHP Code Coverage, Xdebug, PCOV, Clover, XML, JSONL, Composer, testes automatizados, qualidade de software, CoverageRadar PHP, SaaS.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Veja tamb\u00e9m: <a href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/category\/jogos\/programacao\/\">mais conte\u00fados sobre Programa\u00e7\u00e3o<\/a>.<\/p>\n\n\n    <article class=\"aabp-card aabp-style-card\">\n                            <a href=\"https:\/\/link.amazon\/B06vJFVbP\" target=\"_blank\" rel=\"nofollow sponsored noopener\" class=\"aabp-image\">\n                <img decoding=\"async\" src=\"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-content\/uploads\/2026\/10\/81I4I454DZL._SL1500_1-768x962.jpg\" alt=\"Php, Mysql, &#038; JavaScript All-In-One for Dummies\" loading=\"lazy\">\n            <\/a>\n                <div class=\"aabp-content\">\n            <h3><span class=\"ez-toc-section\" id=\"Php_Mysql_JavaScript_All-In-One_for_Dummies\"><\/span>Php, Mysql, &#038; JavaScript All-In-One for Dummies<span class=\"ez-toc-section-end\"><\/span><\/h3>\n            <div class=\"aabp-rating\">\u2b50 4.4\/5<\/div>            <p>Php, Mysql, &amp; JavaScript All-In-One for Dummies. Produto recomendado para estudos, programa\u00e7\u00e3o e produtividade.<\/p>            <div class=\"aabp-price-row\">\n                                <strong class=\"aabp-price\">R$ 122,01<\/strong>            <\/div>\n            <a class=\"aabp-button\" href=\"https:\/\/link.amazon\/B06vJFVbP\" target=\"_blank\" rel=\"nofollow sponsored noopener\">Ver na Amazon<\/a>\n            <small class=\"aabp-disclaimer\">Como afiliado, posso receber comiss\u00e3o por compras qualificadas.<\/small>\n        <\/div>\n    <\/article>\n    \n\n\n\n<figure class=\"wp-block-embed aligncenter is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"PHP Code Coverage \u2014 Li\u00e7\u00e3o 2 arquitetura, drivers e importa\u00e7\u00e3o Clover\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/nM0LFWNtPwk?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Na li\u00e7\u00e3o 2 da trilha PHP Code Coverage, estudamos a arquitetura da vers\u00e3o 14.4.1 e constru\u00edmos um primeiro importador Clover para o futuro CoverageRadar PHP.<\/p>\n","protected":false},"author":1,"featured_media":1640,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[85],"tags":[690,686,606,689,238,685,691,692,687,688,164],"class_list":["post-1638","post","type-post","status-publish","format-standard","has-post-thumbnail","category-php","tag-clover","tag-code-coverage","tag-composer","tag-pcov","tag-php","tag-phpunit","tag-qualidade-de-codigo","tag-saas","tag-testes-automatizados","tag-xdebug","tag-xml"],"_links":{"self":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/1638","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/comments?post=1638"}],"version-history":[{"count":3,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/1638\/revisions"}],"predecessor-version":[{"id":1644,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/1638\/revisions\/1644"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media\/1640"}],"wp:attachment":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media?parent=1638"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/categories?post=1638"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/tags?post=1638"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}