PHP Notice y Warning: cómo entender y corregir errores undefined

Introducción: ¿por qué PHP te grita "Undefined"?

Si alguna vez has escrito en PHP (y lo haces, ya que estás leyendo este artículo), seguramente te has encontrado con mensajes alarmantes como Notice: Undefined variable o Warning: Undefined array key. Los principiantes suelen asustarse, los experimentados se encogen de hombros, pero todos queremos lo mismo: que el código funcione sin errores.

Hoy analizaremos los cuatro "gritos" más populares de PHP: Undefined variable, Undefined index, Undefined array key y Undefined offset. Aprenderás en qué se diferencian, por qué ocurren y cómo corregirlos correctamente. Y lo más importante: te mostraré las mejores prácticas para que tu código sea limpio y seguro.

Este material está basado en una pregunta real de Stack Overflow que ha acumulado miles de visitas. Lo adaptamos con fines educativos y lo desglosamos paso a paso.

¿Qué son Notice y Warning en PHP?

Antes de sumergirnos en los detalles, analicemos los niveles de error en PHP. Un Notice no es un error crítico. PHP dice: "Oye, noté algo extraño, pero sigo funcionando". Un Warning es más grave: "Puedo ejecutar el código, pero algo salió mal".

Los cuatro mensajes que estamos viendo pertenecen a la categoría de errores de acceso a datos inexistentes. No rompen el sitio por completo, pero pueden provocar comportamientos inesperados o vulnerabilidades.

1. Notice: Undefined variable

Este es, quizás, el error más común al que se enfrentan los desarrolladores PHP principiantes. Ocurre cuando intentas usar una variable que no ha sido declarada.

Ejemplo típico

<?php\necho $name; // La variable $name no está definida\n?>

Salida: Notice: Undefined variable: name

¿Por qué ocurre esto?

\n
• Olvidaste asignar un valor a la variable
\n
• La variable fue declarada en otro ámbito (por ejemplo, dentro de una función)
\n
• No se usó el operador isset() para verificar
\n

¿Cómo corregirlo?

Método 1: Verificación con isset()

<?php\nif (isset($name)) {\n    echo $name;\n} else {\n    echo 'La variable no está definida';\n}\n?>

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

<?php\necho $name ?? 'Valor por defecto';\n?>

Método 3: Inicialización de la variable

<?php\n$name = 'Juan';\necho $name; // Ahora todo está bien\n?>

2. Notice: Undefined index

Este error ocurre al intentar acceder a una clave de array inexistente. El caso clásico es trabajar con los arrays superglobales $_POST, $_GET o $_SESSION.

Ejemplo de la vida real

<?php\n// Supongamos que el formulario se envió sin el campo "email"\necho $_POST['email']; // Notice: Undefined index: email\n?>

¿Por qué es peligroso?

\n
• Puede provocar errores inesperados en la lógica
\n
• Crea vulnerabilidades: si no verificas la existencia de la clave, un atacante podría enviar datos inesperados
\n

Mejores prácticas

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() — enfoque profesional

<?php\n$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);\nif ($email === false) {\n    // Manejo del error de validación\n}\n?>

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

A partir de