Avisos e Alertas do PHP: como entender e corrigir erros undefined

Introdução: por que o PHP grita com você "Undefined"?

Se você já escreveu em PHP (e você escreve, já que está lendo este artigo), certamente já encontrou mensagens assustadoras como Notice: Undefined variable ou Warning: Undefined array key. Iniciantes costumam se assustar, experientes dão de ombros, mas todos queremos a mesma coisa: que o código funcione sem erros.

Hoje vamos analisar os quatro "gritos" mais populares do PHP: Undefined variable, Undefined index, Undefined array key e Undefined offset. Você aprenderá como eles diferem, por que ocorrem e como corrigi-los corretamente. E o principal: mostrarei as melhores práticas para que seu código seja limpo e seguro.

Este material é baseado em uma pergunta real do Stack Overflow, que reuniu milhares de visualizações. Vamos adaptá-lo para fins educacionais e organizá-lo passo a passo.

O que são Notice e Warning no PHP?

Antes de mergulharmos nos detalhes, vamos entender os níveis de erro no PHP. Notice não é um erro crítico. O PHP diz: "Ei, notei algo estranho, mas continuo funcionando". Warning é mais sério: "Posso executar o código, mas algo deu errado".

Todas as quatro mensagens que estamos analisando pertencem à categoria de erros de acesso a dados inexistentes. Elas não quebram o site completamente, mas podem levar a comportamentos inesperados ou vulnerabilidades.

1. Notice: Undefined variable

Este é, provavelmente, o erro mais comum enfrentado por desenvolvedores PHP iniciantes. Ele ocorre quando você tenta usar uma variável que não foi declarada.

Exemplo típico

<?php\necho $name; // A variável $name não está definida\n?>

Saída: Notice: Undefined variable: name

Por que isso acontece?

\n
• Você esqueceu de atribuir um valor à variável
\n
• A variável foi declarada em outro escopo (por exemplo, dentro de uma função)
\n
• O operador isset() não foi usado para verificação
\n

Como corrigir?

Método 1: Verificação com isset()

<?php\nif (isset($name)) {\n    echo $name;\n} else {\n    echo 'Variável não definida';\n}\n?>

Método 2: Uso do operador null coalescing (PHP 7+)

<?php\necho $name ?? 'Valor padrão';\n?>

Método 3: Inicialização da variável

<?php\n$name = 'João';\necho $name; // Agora está tudo bem\n?>

2. Notice: Undefined index

Este erro ocorre ao tentar acessar uma chave de array inexistente. O caso clássico é o trabalho com os arrays superglobais $_POST, $_GET ou $_SESSION.

Exemplo da vida real

<?php\n// Suponha que o formulário foi enviado sem o campo "email"\necho $_POST['email']; // Notice: Undefined index: email\n?>

Por que isso é perigoso?

\n
• Pode levar a erros inesperados na lógica
\n
• Cria vulnerabilidades: se você não verificar a existência da chave, um invasor pode enviar dados inesperados
\n

Melhores práticas

Método 1: isset()

<?php\nif (isset($_POST['email'])) {\n    $email = $_POST['email'];\n} else {\n    $email = null;\n}\n?>

Método 2: null coalescing (PHP 7+)

<?php\n$email = $_POST['email'] ?? null;\n?>

Método 3: filter_input() — abordagem profissional

<?php\n$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);\nif ($email === false) {\n    // Tratamento do erro de validação\n}\n?>

3. Warning: Undefined array key (PHP 8.0+)

A partir do