PHP Mensagens de Erro

Quando algo dá errado, o PHP escreve uma mensagem em inglês com o tipo do problema, o texto, o arquivo e a linha. Esta página junta as mensagens que você mais vai encontrar, cada uma com o código que a provoca, o que ela quer dizer, como consertar e a aula onde o assunto é explicado. Todas foram provocadas de verdade no PHP 8.5, na máquina da Ana. Para aprender a ler erros com calma, veja Lendo Erros do PHP e Tipos de Erro.

Atalhos: Ler uma mensagem · Os níveis · Terminal × navegador · Parse error · Variáveis e arrays · Tipos e contas · Funções · Classes e objetos · Arquivos, include e cabeçalhos · Banco de dados · JSON, datas e valores · Limites · Deprecated

Como ler uma mensagem

Um exemplo completo. A Ana chamou uma função com um texto onde ela esperava um número:

<?php
function dobro(int $n): int {
    return $n * 2;
}
echo dobro("quatro");

$ php e17.php

Fatal error: Uncaught TypeError: dobro(): Argument #1 ($n) must be of type int, string given, called in /home/ana/erros/e17.php on line 5 and defined in /home/ana/erros/e17.php:2
Stack trace:
#0 /home/ana/erros/e17.php(5): dobro('quatro')
#1 {main}
  thrown in /home/ana/erros/e17.php on line 2

Os níveis de erro

Avisos não param o programa, mas não os ignore: quase sempre são um defeito de verdade. Neste exemplo, o aviso da linha 3 deixou a aluna sem nome, o da linha 4 escreveu "Array", e só a divisão por zero, na linha 6, parou tudo:

$ php missao.php

Warning: Undefined array key "Nome" in /home/ana/erros/missao.php on line 3
Aluna:

Warning: Array to string conversion in /home/ana/erros/missao.php on line 4
Notas: Array

Fatal error: Uncaught DivisionByZeroError: Division by zero in /home/ana/erros/missao.php:6
Stack trace:
#0 {main}
  thrown in /home/ana/erros/missao.php on line 6
$ echo $?
255

(Você vai consertar esse programa na missão do fim da página.)

No terminal × no navegador

A mesma mensagem aparece de jeitos diferentes conforme o lugar e a configuração (php.ini):

Com log_errors ligado, a mensagem sai duas vezes. A primeira (PHP Warning: …, com dois espaços) é o log, na saída de erro; a segunda é a exibição:

$ php -d log_errors=1 e08.php
PHP Warning:  Undefined variable $nome in /home/ana/erros/e08.php on line 2

Warning: Undefined variable $nome in /home/ana/erros/e08.php on line 2
$ php -d log_errors=1 e08.php 2>/dev/null

Warning: Undefined variable $nome in /home/ana/erros/e08.php on line 2

No navegador, a página aviso.php (que usa $_GET["nome"] sem conferir e chama uma função que não existe) chega assim. O curl -si mostra a resposta crua, com os cabeçalhos:

<?php
echo "<p>Olá, " . $_GET["nome"] . "</p>";
echo dobro(2);

$ curl -si localhost:8000/aviso.php
HTTP/1.1 200 OK
Host: localhost:8000
Date: Fri, 16 Oct 2026 23:45:59 GMT
Connection: close
X-Powered-By: PHP/8.5.8
Content-type: text/html; charset=UTF-8

<br />
<b>Warning</b>:  Undefined array key "nome" in <b>/home/ana/web/aviso.php</b> on line <b>2</b><br />
<p>Olá, </p><br />
<b>Fatal error</b>:  Uncaught Error: Call to undefined function dobro() in /home/ana/web/aviso.php:3
Stack trace:
#0 {main}
  thrown in <b>/home/ana/web/aviso.php</b> on line <b>3</b><br />

E, no terminal onde o servidor roda:

$ php -S localhost:8000
[Fri Oct 16 20:45:59 2026] PHP 8.5.8 Development Server (http://localhost:8000) started
[Fri Oct 16 20:45:59 2026] 127.0.0.1:57888 Accepted
[Fri Oct 16 20:45:59 2026] 127.0.0.1:57888 [200]: GET /aviso.php - Uncaught Error: Call to undefined function dobro() in /home/ana/web/aviso.php:3
Stack trace:
#0 {main}
  thrown in /home/ana/web/aviso.php on line 3
[Fri Oct 16 20:45:59 2026] 127.0.0.1:57888 Closing

$ php -l e01.php

Parse error: syntax error, unexpected token "echo" in e01.php on line 3
Errors parsing e01.php
$ php -l e08.php
No syntax errors detected in e08.php

Parse error (sintaxe)

O PHP lê o arquivo inteiro antes de rodar. Se a "gramática" estiver errada, nada é executado. A linha apontada é onde o PHP percebeu o problema, que muitas vezes está na linha anterior. Aula: Sintaxe.

Variáveis e arrays

<?php
$nome = "Ana";
echo "Olá, $nome!\n";

<?php
$nome = "Ana";
echo "Olá, $name!\n";

Tipos e contas

Funções

Classes e objetos

Arquivos, include, cabeçalhos e sessão

Banco de dados (PDO)

Desde o PHP 8.0 o PDO lança PDOException em todo erro. O texto depois de SQLSTATE[…] vem do próprio banco (aqui, SQLite). Aula: Conectar com PDO.

JSON, datas e valores inválidos

Limites: memória, tempo e recursão

Deprecated (vai deixar de funcionar)

O código funciona hoje, mas o PHP avisa que aquilo será removido. Conserte agora: na próxima versão pode virar erro.

Missão: zero avisos

O programa da seção Os níveis tem três problemas, um em cada linha que gera mensagem. Rode, leia as mensagens de cima para baixo e conserte uma por vez.

<?php
$aluno = ["nome" => "Ana", "notas" => [7, 8]];
echo "Aluna: " . $aluno["Nome"] . "\n";
echo "Notas: " . $aluno["notas"] . "\n";
$quantidade = 0;
echo "Média: " . array_sum($aluno["notas"]) / $quantidade . "\n";

<?php
$aluno = ["nome" => "Ana", "notas" => [7, 8]];
echo "Aluna: " . $aluno["nome"] . "\n";
echo "Notas: " . implode(", ", $aluno["notas"]) . "\n";
$quantidade = count($aluno["notas"]);
echo "Média: " . array_sum($aluno["notas"]) / $quantidade . "\n";

$ php missao-sol.php
Aluna: Ana
Notas: 7, 8
Média: 7.5

Exercícios

Resumo

• Toda mensagem tem nível, texto, arquivo e linha. "Uncaught X" = exceção X não tratada; o Stack trace mostra o caminho até ela.
• Parse error: nada roda; olhe também a linha anterior. Fatal error: para. Warning/Notice: continua com valor errado. Deprecated: funciona, mas vai mudar.
• Os campeões: Undefined variable, Undefined array key, … on null, Call to undefined function, headers already sent, no such table.
• Conserte a primeira mensagem e rode de novo; muitas das seguintes somem junto.
• php -l confere a sintaxe; no site no ar, os erros vão para o log, não para a tela (Depurar).