Apprendre à déboguer une erreur WordPress

Une page blanche ou une réponse 500 n'identifie pas à elle seule la cause : l'échec peut provenir de PHP, de WordPress, du serveur web ou d'une dépendance. Commencez par le journal associé à la requête et à l'heure exacte de l'erreur, sans l'attribuer encore à un plugin ou à une modification récente.

Faites le test de préférence sur une copie de staging. Si vous devez le reproduire en production, gardez display_errors désactivé et envoyez les erreurs vers un journal privé en dehors de public_html, en suivant le guide pour déboguer les erreurs dans WordPress.

Si WordPress affiche le message d'erreur critique, consultez d'abord la boîte mail du compte administrateur. Depuis WordPress 5.2, le lien du mode de récupération permet de se connecter avec le plugin ou le thème problématique mis en pause pour cette session.

Reproduisez uniquement l'opération qui échoue et consultez immédiatement le journal. Dans cet exemple, l'erreur fatale suivante apparaît :

Fatal error: require(): Failed opening required 
'/home/user/public_html/wp-content/plugins/woocommerce/src/Packages.php' 
(include_path='.:/opt/alt/php74/usr/share/pear') 
in /home/user/public_html/wp-content/plugins/woocommerce/woocommerce.php on line 25

Le message démontre que require n'a pas pu ouvrir ce fichier :

public_html/wp-content/plugins/woocommerce/src/Packages.php

et que l'appel a été fait depuis la ligne 25 de :

public_html/wp-content/plugins/woocommerce/woocommerce.php

Cela situe l'échec pendant le chargement de WooCommerce, mais ne démontre pas à lui seul que le plugin est endommagé ni pourquoi le fichier n'a pas pu être ouvert. Examinez aussi l'avertissement qui précède Failed opening required : il indique généralement si le fichier n'existe pas, n'est pas lisible ou est bloqué par une restriction de chemin. Vérifiez son existence, la casse, les permissions, le propriétaire et la correspondance avec la version installée.

Si le fichier manque réellement et que l'erreur est apparue pendant une mise à jour, une installation incomplète est une hypothèse compatible avec les éléments observés. Pour retrouver temporairement l'accès, utilisez d'abord le mode de récupération ou renommez wp-content/plugins/woocommerce ; ne supprimez pas le répertoire avant d'en avoir conservé une copie pour l'analyse.

Vous pouvez ensuite réinstaller la même version ou une version compatible depuis une source officielle. Ne restaurez le répertoire depuis une sauvegarde que si la sauvegarde est antérieure à l'échec, considérée comme saine et compatible avec l'état actuel de la base de données.

Remettre la boutique en service et vérifier toute la commande

La trace est un exemple historique : le chemin php74 ne recommande pas d'utiliser PHP 7.4. Utilisez la version compatible et maintenue qui correspond à votre WooCommerce actuel.

Tant que WooCommerce est en pause, la boutique peut perdre des fonctions d'achat. Conservez les commandes récentes et évitez de restaurer une ancienne base uniquement pour récupérer un fichier du plugin. Après avoir réparé les fichiers, vérifiez le catalogue, le panier, le début du paiement et la notification de paiement dans un environnement de test. Si vous installez une version qui migre la base, prévoyez aussi la compatibilité d'un retour en arrière : copier ensuite un ancien dossier n'annule pas cette migration.