Fixer Parse error: syntax error facilement et rapidement sur WordPress ?

Chaque fois qu’un nouvel utilisateur de WordPress obtient une erreur « Parse error: Syntax error, unexpected », son cœur flanche. Vous avez l’impression que vous avez tout fait correctement, ce qui rend l’erreur encore plus décourageante. Il est également possible que vous obteniez une erreur « Parse error: Syntax error, unexpected » mais que vous ne pouvez pas voir ce message d’erreur en raison de la suppression des rapports d’erreur par WordPress. Dans ce cas, il est fortement recommandé d’activer le debug d’erreur WordPress .

Nous sommes là pour vous dire que c’est complètement normal si vous êtes l’un de ces utilisateurs, car WordPress peut parfois être déroutant avec des erreurs de syntaxe ennuyeuses. Ces erreurs se produisent si les bonnes règles de syntaxe PHP ne sont pas suivies. Dans ce tutoriel, nous vous montrerons comment réparer les erreurs de syntaxe sur WordPress avec des instructions simples destinées aux débutants.

Ce dont vous aurez besoin

Avant de commencer ce tutoriel, vous aurez besoin des éléments suivants

Accès à votre compte d’hébergement

Qu’est-ce qu’une erreur de syntaxe (syntax error) ?

À ce stade, vous vous demandez peut-être : Qu’est-ce qu’une erreur de syntaxe ? En programmation informatique, les erreurs de syntaxe sont causées par le non-respect des règles de langages de programmation spécifiques. Dites-vous que les erreurs de syntaxe reviennent à placer incorrectement des verbes et des noms dans une phrase écrite en français. Tout comme un locuteur de français ne pourra pas comprendre la phrase, le compilateur ou l’interprète du langage de programmation ne pourra pas traiter un bloc de code syntaxiquement incorrect. Que vous perdiez un point-virgule ou que vous écriviez un fichier complet de manière incorrecte, vous rencontrerez une erreur de syntaxe. Dans le cas des erreurs de syntaxe apparaissant sur WordPress, les utilisateurs commettent souvent l’erreur d’écrire leur propre script php pour leur site. Les erreurs de syntaxe entrent dans la catégorie plus large d’erreurs d’analyse, car elles sont capturées en analysant chaque ligne de code écrite pour un programme.

Correction de l’erreur de syntaxe (syntax error) dans WordPress

Les erreurs de syntaxe peuvent être facilement corrigées dans WordPress. Essentiellement, c’est un processus en deux étapes :

1. Localisez la(les) ligne(s) de code responsable(s) de l’erreur
2. Modifiez le code en vous connectant à votre serveur.

Examinons ces étapes plus en détail une par une.

Étape 1 – Détermination du fichier corrompu

La première étape de la correction d’une erreur de syntaxe est d’abord de reconnaître la source du problème. Plus précisément, vous voulez savoir quel fichier provoque le problème et quel bloc de code dans le fichier est particulièrement responsable de l’erreur.

Une bonne heuristique dans de tels cas, c’est de vous rappeler quels plugins thèmes récents vous pourriez avoir incorporés sur votre site WordPress. Si une erreur de syntaxe a commencé à apparaître juste après l’installation de ce plugin/thème, vous avez votre réponse.

Heureusement, même si vous ne savez pas où est la source de l’erreur, vous pouvez facilement retrouver son origine. Lorsque vous ouvrez votre site à l’aide d’un navigateur web, vous recevez le message d’erreur. Le message commence par « Parse error: Syntax error, unexpected », suivi des informations spécifiques à l’erreur. Le message d’erreur contiendra également le chemin d’accès complet du fichier responsable de l’erreur, ainsi que la ligne où le code défectueux peut être trouvé. C’est le fichier que vous devez modifier afin de corriger l’erreur de syntaxe.

Jetons un coup d’œil au message d’erreur de syntaxe suivant sur WordPress :

À partir du message d’erreur ci-dessus, nous pouvons voir que nous avons une fin inattendue du fichier. Nous pouvons également voir quel fichier est corrompu (/home/u694443746/public_html/wp2/wp-content/themes/twentyseventeen/single.php) et la ligne de code (43) qui résulte de cette erreur. Cette information est plus que suffisante pour que nous puissions réparer notre WordPress et éliminer l’erreur de syntaxe.

Étape 2 – Réparation du fichier avec le client FTP

Maintenant que vous avez repéré le fichier provoquant l’erreur, vous pouvez passer à l’édition de ce fichier pour rendre votre site WordPress à nouveau fonctionnel. Dans le cas où vous êtes bloqué hors de l’espace d’administration (en anglais), ce qui se produit si le code responsable de l’erreur a été injecté via la zone Apparence -> Editeur  du tableau de bord de WordPress, vous devez utiliser un client FTP. Pour nos besoins, FileZilla suffira.

La réparation du fichier corrompu est simple : il suffit de vous connecter à votre compte avec FileZilla, maintenant, naviguez vers le fichier corrompu qui contient un mauvais dossier de code, dans notre exemple c’est /home/u694443746/public_html/wp2/wp-content/themes/twentyseventeen/single.php, puis faites un clic droit sur le fichier et choisissez l’option Afficher / Editer.

Le fichier corrompu s’ouvrira dans votre éditeur de texte par défaut.

Vous avez maintenant le choix: vous pouvez supprimer le code défectueux ou apporter les modifications nécessaires pour qu’il fonctionne correctement.

Le simple fait de supprimer la ligne peut résoudre le problème dans certains cas (exemple : un commentaire auquel manquent des caractères, et qui est donc interprété comme du code), mais peut introduire d’autres problèmes non présents auparavant (exemple : une ligne responsable du calcul d’une variable, qui est utilisée dans les lignes ultérieures). Cette option n’est pas recommandée.

Voyons maintenant le fichier corrompu plus complètement. Nous savons déjà où effectuer une recherche – à partir du message d’erreur, nous pouvons voir que la ligne 43 provoque cette erreur. Voyons le code sur cette ligne :

<?php get_footer()

Il appelle la fonction get_footer et ne semble pas différent du reste du code. Pas tout à fait. Une petite partie, mais très importante, manque – un point-virgule au bout de la ligne. Et c’est la cause de l’erreur « Parse error: Syntax error, unexpected ».

Dans notre exemple, cette erreur peut être facilement corrigée en ajoutant un point-virgule à la fin de la ligne et en uploadant le fichier à nouveau sur le serveur. Si vous êtes un novice en PHP, utilisez le Vérificateur de code php pour vérifier le code et voir les erreurs de syntaxe PHP les plus courantes. Ces outils vous aideront à déboguer l’erreur et à la réparer.

Conclusion

Les débutants ne doivent pas se décourager lorsqu’ils voient une erreur « Parse error: Syntax error, unexpected » sur WordPress. C’est l’une des erreurs les plus facilement identifiables et les plus susceptibles d’être corrigées dans votre apprentissage en tant que développeur. Tout ce que vous devez faire, c’est reconnaître quel fichier provoque l’erreur, en le réduisant à des lignes spécifiques, et en éditant ce fichier pour corriger l’erreur de syntaxe. Bien sûr, il est toujours préférable d’éviter les erreurs de syntaxe, en écrivant le code plus attentivement ou en le testant dans un environnement isolé, avant de l’incorporer correctement dans votre site.