Déboguer les erreurs dans WordPress

WordPress permet de configurer le débogage dans wp-config.php. Pour enquêter sur un échec sur un site public, envoyez les détails vers un journal privé et gardez l'affichage des erreurs masqué.

Faites ces tests de préférence sur une copie de staging. En production, n'affichez pas les erreurs à l'écran : elles peuvent révéler des chemins, des requêtes et des données internes à n'importe quel visiteur.

Enregistrer les erreurs sans les afficher

Créez un répertoire de journaux en dehors de public_html, assurez-vous que PHP peut y écrire et appliquez la permission 0600 au fichier lorsque le système le permet. Ajoutez temporairement ces lignes à wp-config.php, en remplaçant CPANEL_USUARIO. Placez-les avant le chargement de wp-settings.php, généralement avant le commentaire qui demande d'arrêter les modifications. Si une constante existe déjà, changez sa valeur au lieu de la déclarer une seconde fois :

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', '/home/CPANEL_USUARIO/logs/wordpress-debug.log');
@ini_set('display_errors', '0');

N'utilisez pas wp-content/debug.log sur un site public, sauf si le serveur bloque expressément son téléchargement. Reproduisez l'échec une seule fois, notez l'heure et conservez la première erreur de cette requête avec quelques lignes de contexte. Vérifiez qu'elle ne contient ni mots de passe, ni jetons, ni données personnelles avant d'en partager des extraits.

J'obtiens une page blanche

Si le journal de WordPress ne capture pas l'échec, activez temporairement le journal PHP depuis cPanel et consultez la même heure, ou demandez à l'assistance de le vérifier. Gardez toujours display_errors désactivé en production.

Désactiver et nettoyer

À la fin, rétablissez les valeurs précédentes de WP_DEBUG, WP_DEBUG_LOG et WP_DEBUG_DISPLAY, retirez la ligne temporaire ini_set et supprimez le fichier lorsqu'il n'est plus nécessaire. Le débogage ne doit pas rester actif indéfiniment en production.

Si l'entrée attendue n'apparaît pas

Vérifiez que vous avez modifié le wp-config.php utilisé par cette installation et que PHP peut écrire dans le chemin choisi. Utilisez les booléens true et false sans guillemets : le texte 'false' n'équivaut pas au booléen faux.

WP_DEBUG élargit les niveaux d'erreur et peut générer de nombreux avertissements qui ne causent pas l'échec. Reliez la première erreur pertinente à la requête et à son heure. S'il y a une erreur de syntaxe avant que WordPress ne charge ces options, consultez le journal PHP du serveur. Le guide officiel de débogage détaille la portée de chaque constante.