Errores PHP para principiantes: entiende los mensajes de error

PHP no muerde: cómo dejar de temer a los errores y empezar a entenderlos

¿Alguna vez has visto una pantalla en blanco en lugar de tu sitio web? ¿O un mensaje como Parse error: syntax error, unexpected '}' y has sentido un escalofrío? ¡Bienvenido al club! Todos los desarrolladores PHP, desde principiantes hasta expertos, pasan por esto. Pero la buena noticia es que la mayoría de los errores no son maldiciones malvadas de la computadora, sino pistas. Te están diciendo: «Oye, no entendí lo que quieres de mí. ¡Mira aquí!».

En este artículo, analizaremos los errores PHP más comunes que asustan a los principiantes. No solo los enumeraremos: aprenderemos a leer los mensajes de error, entender su esencia y corregirlos. Después de leerlo, mirarás un Fatal error con una sonrisa, no con terror. ¡Allá vamos!

1. Anatomía de un error PHP: aprende a leer los mensajes

Antes de analizar errores específicos, entendamos cómo está estructurado un mensaje de error en PHP. Siempre contiene varias partes clave:

\n
• Tipo de error (Parse error, Fatal error, Warning, Notice)
\n
• Mensaje — qué salió mal exactamente
\n
• Archivo — en qué archivo ocurrió
\n
• Línea — el número de línea donde se detectó el error
\n

Ejemplo:

Parse error: syntax error, unexpected '}' in /var/www/script.php on line 15

Aquí PHP dice claramente: «En el archivo script.php, en la línea 15, encontré una llave de cierre } que no esperaba ver». Esto significa que en algún lugar anterior olvidaste abrir una llave o pusiste una de más. Ve a la línea 15 y revisa el contexto.

2. Errores de sintaxis (Parse Error): la pesadilla de los principiantes

Los visitantes más frecuentes en la fiesta de un programador PHP novato son los errores de sintaxis. PHP es un lenguaje con una sintaxis estricta, y si te olvidas un punto y coma o no cierras un paréntesis, te lo señalará de inmediato.

2.1. Punto y coma olvidado

Un clásico. Cada instrucción en PHP debe terminar con un punto y coma (;).

Incorrecto:

<?php\necho "¡Hola, mundo!"\necho "¿Cómo estás?";\n?>

Error: Parse error: syntax error, unexpected 'echo' (T_ECHO)

Correcto:

<?php\necho "¡Hola, mundo!";\necho "¿Cómo estás?";\n?>

2.2. Comillas o paréntesis sin cerrar

Otra trampa común. Si abres una cadena con una comilla doble pero olvidas cerrarla, PHP «se comerá» el resto del código hasta la siguiente comilla, lo que provocará un error extraño.

Incorrecto:

<?php\n$texto = "Hola, mundo;\necho $texto;\n?>

Error: Parse error: syntax error, unexpected end of file (porque PHP busca la comilla de cierre hasta el final del archivo)

Correcto:

<?php\n$texto = "Hola, mundo";\necho $texto;\n?>

2.3. Llaves sobrantes o faltantes

En bucles y condicionales, las llaves definen un bloque de código. Una de más y todo se rompe.

Incorrecto:

<?php\nif ($a > 5) {\n    echo "Mayor que 5";\n}\n} // Llave sobrante\n?>

Error: Parse error: syntax error, unexpected '}'

Consejo: Usa siempre un editor de código con resaltado de sintaxis. Te mostrará qué llave no tiene pareja. O cuenta las llaves manualmente: por cada una que abras, cierra una.

3. Errores fatales (Fatal Error): cuando el script muere

Un error fatal es un problema grave. PHP no puede continuar la ejecución y el script se detiene por completo. La pantalla blanca suele ser un Fatal Error, pero la visualización de errores puede estar desactivada.

3.1