Erreurs PHP parse/syntax : comment les lire et les corriger pour débutants

Introduction : pourquoi PHP se plaint et que faire ?

Vous écrivez du code, tout semble parfait, vous cliquez sur « Actualiser » dans votre navigateur — et vous voyez quelque chose comme :

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

Ça vous dit quelque chose ? Si vous avez déjà rencontré des erreurs PHP parse/syntax, vous connaissez cette petite panique. On a l'impression que l'ordinateur est devenu fou, et que vous êtes un mauvais développeur. Mais en réalité, c'est bien plus simple. PHP ne cherche pas à vous vexer — il vous dit honnêtement : « Je ne comprends pas ce que tu veux de moi ».

Dans cet article, nous allons voir ce qu'est une erreur de syntaxe PHP, comment la lire, la trouver et, surtout, la corriger. Ce guide est conçu pour les débutants, donc pas de magie — seulement de la pratique et des exemples concrets. C'est parti !

Qu'est-ce qu'une erreur PHP parse/syntax en termes simples ?

Imaginez que vous écrivez une lettre à un ami, mais que vous oubliez de mettre un point à la fin de la phrase. Votre ami devinera ce que vous voulez dire. Mais PHP n'est pas un ami. PHP est un professeur strict qui exige un ordre parfait.

Une erreur de parse (parse error) se produit lorsque PHP ne peut pas analyser votre code à cause d'une violation des règles du langage. En clair, vous avez enfreint la syntaxe PHP.

Voici les causes les plus fréquentes :

\n
• Un point-virgule ; oublié
\n
• Une parenthèse ou accolade {}, (), [] en trop ou manquante
\n
• Un guillemet ou une chaîne non fermé
\n
• Une mauvaise utilisation des mots-clés
\n
• Des caractères superflus dans le code
\n

Bonne nouvelle : PHP vous indique toujours la ligne et le type d'erreur. Notre mission est d'apprendre à lire ces indices.

Comment lire un message d'erreur PHP ?

Un message typique ressemble à ceci :

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

Décortiquons-le :

\n
• Parse error — le type d'erreur (syntaxique)
\n
• syntax error, unexpected '}' — ce à quoi PHP ne s'attendait pas
\n
• /var/www/index.php — le fichier où l'erreur s'est produite
\n
• on line 15 — la ligne où PHP a buté
\n

Astuce importante : PHP indique souvent la ligne où il a détecté le problème, mais la vraie cause peut se trouver 1 ou 2 lignes plus haut. Par exemple, si vous avez oublié un point-virgule à la ligne 14, l'erreur peut apparaître à la ligne 15.

Top 5 des erreurs PHP parse/syntax les plus fréquentes (avec exemples)

1. Point-virgule oublié ;

L'erreur la plus courante chez les débutants. Chaque instruction en PHP doit se terminer par ;.

Incorrect :

<?php\necho "Bonjour le monde"\necho "Comment ça va ?";\n?>

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

Correct :

<?php\necho "Bonjour le monde";\necho "Comment ça va ?";\n?>

2. Parenthèses ou accolades non fermées ou mal placées

Chaque parenthèse ouvrante { doit avoir une fermante }. Et vice versa.

Incorrect :

<?php\nif (true {\n    echo "Condition remplie";\n}\n?>

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

Correct :

<?php\nif (true) {\n    echo "Condition remplie";\n}\n?>

3. Accolade fermante en trop

Parfois, on ajoute un } là où il ne faut pas.

Incorrect :

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

Erreur :
\nParse erro