Encontrar e corrigir um erro

Neste capítulo você vai usar a mensagem de erro e uma verificação pequena para corrigir uma falha.

Seu ponto de partida

Estude depois do capítulo 11. O exemplo deste capítulo é 12-investigar-erros, no pacote que acompanha o volume. Copie a pasta inicio para um diretório de prática e preserve o original. A raiz do exemplo é a referência concluída desta etapa. Sua cópia permite experimentar sem perder a referência.

Execute o PHP na raiz da sua cópia com php -S 127.0.0.1:8000 -t public. Abra http://127.0.0.1:8000/. Não abra PHP por duplo clique nem use o servidor de Python. Encerre com Ctrl+C antes de trocar de etapa.

Como praticar

Leia a explicação e digite ou confira o código indicado. Mude uma coisa. Antes de conferir, anote sua previsão. Salve, recarregue e compare. Se não acontecer o esperado, investigue o erro antes de avançar. Cada experiência parte dos valores da referência. Depois de conferir, desfaça somente a mudança desse experimento antes de começar a próxima lição. Você pode parar depois de uma lição e retomar mais tarde.

Confira a sintaxe antes do navegador

Um erro de sintaxe impede o PHP de entender as instruções. Pode faltar uma aspa, uma chave ou um ponto e vírgula. PHP -l verifica a sintaxe sem executar a página. Ele não prova que a lógica está certa.

A linha apontada pode ser onde o PHP percebeu a falha, e não onde ela começou. Confira também a linha anterior. Faça a experiência somente numa cópia e restaure antes de avançar.

Faça no seu exemplo

Em public/index.php, localize o bloco indicado. A referência completa acompanha esta etapa.

$mensagem = "Prática de investigação.";

Mude uma coisa e preveja

Remova somente o ponto e vírgula desta linha. No terminal, execute php -l public/index.php.

Anote o que você acha que vai acontecer antes de salvar e recarregar.

Recarregue e confira

A verificação informa erro. Reponha o ponto e vírgula e confirme No syntax errors detected.

Se não acontecer

Se a verificação disser que o arquivo não existe, confira a pasta do terminal. -l recebe um caminho no disco, não um endereço HTTP.

Investigue um valor fictício

Quando a página executa mas mostra um resultado inesperado, verifique os dados do cálculo. Var_dump pode revelar tipo e valor numa cópia local. Não deixe esse diagnóstico numa entrega e não use dados reais.

A referência oferece diagnóstico visível para uma quantidade fictícia. Não despeja $_SERVER ou a sessão completa. A investigação deve responder uma pergunta pequena: que valor chegou a este cálculo?

Faça no seu exemplo

Em public/index.php, localize o bloco indicado. A referência completa acompanha esta etapa.

$quantidade = 3;
$dobro = $quantidade * 2;

Mude uma coisa e preveja

Troque somente quantidade para 4.

Anote o que você acha que vai acontecer antes de salvar e recarregar.

Recarregue e confira

O diagnóstico mostra int(4) e o resultado muda para 8.

Se não acontecer

Se o diagnóstico muda e o resultado não, confira se dobro usa quantidade ou um número fixo escrito por engano.

Um erro de lógica não é erro de sintaxe

Um programa válido pode fazer a conta errada. Por isso precisamos de uma previsão e de exemplos de entrada com resultado conhecido. A referência dobra uma quantidade. Somar 2 produziria outro comportamento, embora fosse sintaxe válida.

Corrija uma coisa de cada vez. Use o mesmo dado antes e depois da correção, anote o resultado e retire o diagnóstico quando terminar. Não esconda o aviso sem resolver sua causa.

Faça no seu exemplo

Em public/index.php, localize o bloco indicado. A referência completa acompanha esta etapa.

$dobro = $quantidade * 2;

Mude uma coisa e preveja

Troque somente * por + e use quantidade 3.

Anote o que você acha que vai acontecer antes de salvar e recarregar.

Recarregue e confira

O resultado passa de 6 para 5. PHP -l continua aprovando a sintaxe. Restaure *.

Se não acontecer

Se só testar quantidade 2, soma e multiplicação dão 4, escondendo a falha. Escolha uma entrada que diferencie as regras.

A captura mostra um trecho da referência concluída. Abra e percorra o exemplo para conferir o restante. Experimentos temporários podem produzir outra aparência; restaure os valores indicados antes de comparar.

Atividades para fazer antes das respostas

Use uma nova cópia do exemplo. Tente aplicar o que aprendeu antes de consultar os comentários.

1. Crie e restaure uma aspa faltante.

2. Escolha um dado que diferencie + 2 de * 2.

3. Explique o limite de php -l.

Respostas comentadas

Compare sua explicação e o que realmente aconteceu. Outra solução pode funcionar se cumprir o objetivo e preservar o acesso ao conteúdo.

1. A verificação aponta uma falha de análise. Reponha a aspa na cópia.

2. 3 produz 5 na soma e 6 no dobro.

3. Confere sintaxe sem executar a lógica, os formulários ou a escrita em arquivo.

Quando seguir

Você corrige uma falha e comprova a correção com um resultado conhecido. Se ainda precisa de ajuda, repita a experiência pequena antes de avançar.

O arquivo completo

Referência do exemplo 12-investigar-erros, reproduzida aqui para que você possa conferir sem sair da página.

public/index.php

<?php
declare(strict_types=1);
$mensagem = "Prática de investigação.";
$quantidade = 3;
$dobro = $quantidade * 2;
?>
<!doctype html>
<html lang="pt-BR">
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
<title>Livro de visitas de prática</title><link rel="stylesheet" href="estilos.css"></head>
<body><a class="pular" href="#conteudo">Pular para o conteúdo</a>
<header><p>Prática de PHP em pequenos passos</p><h1>Livro de visitas</h1>
<p>Conteúdo fictício. Somente neste computador.</p></header>
<main id="conteudo" tabindex="-1">
<h2>Investigar uma coisa por vez</h2><p><?= $mensagem ?></p><p>Diagnóstico fictício:</p><pre><?php var_dump($quantidade); ?></pre><p>Dobro: <?= $dobro ?></p>
</main><footer><p>Servidor de estudo em 127.0.0.1. Encerre com Ctrl+C.</p></footer></body></html>

public/estilos.css

* { box-sizing: border-box; }
body { margin: 0; background: #f4f7fb; color: #203246;
  font: 1.05rem/1.65 Arial, sans-serif; }
header, main, footer { max-width: 48rem; margin-inline: auto; padding: 1.5rem; }
header { padding-top: 2.5rem; }
h1 { font-size: clamp(1.8rem, 5vw, 2.7rem); line-height: 1.2; }
main { background: #fff; border-radius: .8rem; }
article { border-top: 1px solid #cad4df; padding-block: 1rem; }
a { color: #124e77; text-underline-offset: .2em; }
nav { display: flex; flex-wrap: wrap; gap: 1rem; }
label { display: block; font-weight: bold; }
input:not([type=hidden]), textarea { width: 100%; max-width: 34rem;
  border: 2px solid #718095; border-radius: .35rem; padding: .7rem;
  font: inherit; color: inherit; background: #fff; }
button { font: inherit; background: #124e77; color: white;
  border: 0; border-radius: .35rem; padding: .75rem 1.2rem; cursor: pointer; }
button:hover { background: #103b59; }
.mensagem { white-space: pre-wrap; overflow-wrap: anywhere; }
.erros { color: #8b142c; }
.ok { color: #175c30; font-weight: bold; }
:focus-visible { outline: 3px solid #b04d00; outline-offset: 3px; }
.pular { position: absolute; left: -10000px; }
.pular:focus { position: static; display: block; padding: 1rem; background: white; }
@media (max-width: 35rem) { header,main,footer { padding: 1rem; } }