Errores PHP parse/syntax: cómo leerlos y corregirlos para principiantes

Introducción: ¿por qué PHP se queja y qué hacer al respecto?

Escribes código, estás seguro de que todo está perfecto, presionas "Actualizar" en el navegador y ves algo como:

Parse error: syntax error, unexpected '}' in /home/user/index.php on line 15

¿Te suena familiar? Si alguna vez te has topado con errores PHP parse/syntax, sabes esa sensación de leve pánico. Parece que la computadora se volvió loca y que tú eres un pésimo programador. Pero en realidad, todo es mucho más simple. PHP no intenta ofenderte, solo te dice honestamente: "No entiendo lo que quieres de mí".

En este artículo, analizaremos qué es un error de sintaxis PHP, cómo leerlo, encontrarlo y, lo más importante, corregirlo. El material está pensado para principiantes, así que nada de magia: solo práctica y ejemplos reales. ¡Allá vamos!

¿Qué son los errores PHP parse/syntax en palabras sencillas?

Imagina que le escribes una carta a un amigo, pero olvidas poner un punto al final de la oración. Tu amigo, por supuesto, adivinará lo que quisiste decir. Pero PHP no es un amigo. PHP es un profesor estricto que exige un orden perfecto.

Un error de parse (error de análisis) ocurre cuando PHP no puede interpretar tu código debido a una violación de las reglas del lenguaje. En pocas palabras, has infringido la sintaxis de PHP.

Estas son las causas más comunes:

\n
• Un punto y coma ; faltante
\n
• Un paréntesis {}, () o [] de más o de menos
\n
• Una comilla o cadena sin cerrar
\n
• Uso incorrecto de palabras clave
\n
• Símbolos extraños en el código
\n

La buena noticia: PHP siempre indica la línea y el tipo de error. Nuestra tarea es aprender a leer esas pistas.

¿Cómo leer un mensaje de error de PHP?

Un mensaje típico se ve así:

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

Vamos a desglosarlo por partes:

\n
• Parse error — tipo de error (sintáctico)
\n
• syntax error, unexpected '}' — qué es lo que PHP no esperaba ver
\n
• /var/www/index.php — el archivo donde ocurrió el error
\n
• on line 15 — la línea donde PHP se topó con el problema
\n

Truco importante: PHP a menudo señala la línea donde detectó el problema, pero la causa real puede estar 1 o 2 líneas arriba. Por ejemplo, si olvidaste un punto y coma en la línea 14, el error puede aparecer en la línea 15.

Top 5 errores PHP parse/syntax más comunes (con ejemplos)

1. Punto y coma faltante ;

El error más popular entre principiantes. Cada instrucción en PHP debe terminar con ;.

Incorrecto:

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

Error:
\nParse error: syntax error, unexpected 'echo' (T_ECHO) in /test.php on line 3

Correcto:

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

2. Paréntesis sin cerrar o incorrectos

Cada paréntesis de apertura { debe tener su par de cierre }. Y viceversa.

Incorrecto:

<?php\nif (true {\n    echo "Condición cumplida";\n}\n?>

Error:
\nParse error: syntax error, unexpected '{' in /test.php on line 2

Correcto:

<?php\nif (true) {\n    echo "Condición cumplida";\n}\n?>

3. Paréntesis de cierre de más

A veces ponemos un } donde no hace falta.

Incorrecto:

<?php\n$arr = [1, 2, 3];\necho $arr[0];\n}\n?>

Error:
\nParse erro