Référence WordPress orientée incident : logs, plugins, thèmes, base, WP-CLI, cron, permaliens, SMTP, permissions et erreurs 500/critiques.
Fichiers & chemins
Contient notamment accès DB, salts et constantes de debug.
Un plugin défaillant peut être neutralisé en renommant son dossier, avec précaution.
Conservez au moins un thème par défaut compatible comme solution de repli.
Vérifiez espace disque, droits et URLs avant d’accuser la médiathèque.
Debug & logs
define('WP_DEBUG', true);À activer temporairement sur une fenêtre de diagnostic.
define('WP_DEBUG_LOG', true);Écrit normalement dans wp-content/debug.log selon configuration.
define('WP_DEBUG_DISPLAY', false);Évite d’exposer des erreurs détaillées aux visiteurs.
Pour un HTTP 500, le log serveur est souvent plus précis que l’écran WordPress.
Plugins & thèmes
wp plugin listAffiche statut et versions depuis le shell.
wp plugin deactivate nom-pluginPlus propre qu’un renommage si WP-CLI fonctionne.
wp plugin deactivate --allAction de diagnostic forte : planifiez l’impact applicatif.
wp theme activate twentytwentysixÀ faire seulement si un thème de repli est installé et compatible.
Base de données
wp db checkVérifie l’accès et l’état logique des tables supportées.
Confirme le préfixe réellement attendu par l’instance.
wp option get siteurlCompare siteurl et home en cas de redirection ou migration.
wp option get homeUne incohérence peut provoquer redirections ou liens incorrects.
Cron & tâches
wp cron event listRepère tâches très fréquentes, en retard ou inconnues.
wp cron event run --due-nowPeut exécuter de nombreuses tâches ; à utiliser avec conscience de l’impact.
Si activé, un cron système externe doit appeler wp-cron.php.
Corrélez avec logs PHP et charge DB.
Permaliens, cache & HTTP
wp rewrite flushNe pas appeler à chaque requête ; seulement après changement de règles.
wp rewrite list | head -50Utile pour vérifier qu’une route attendue existe.
wp cache typeSelon WP-CLI/version, identifie ou non la couche cache active.
curl -I https://exemple.fr/page/Compare comportement public et admin sans navigateur.
Email & formulaires
Un formulaire peut fonctionner côté validation mais échouer à la livraison.
Conservez l’ID du message ou la trace fournisseur pour diagnostic.
Une mauvaise identité d’envoi peut causer spam ou rejet.
wp eval "var_dump(wp_mail('admin@example.com','Test BOAI','Test'));"Un true indique seulement que WordPress a remis le message au transport configuré.
Erreur critique / HTTP 500
L’écran “erreur critique” ne contient souvent pas la cause complète.
Une limite PHP/FPM peut primer sur la constante WordPress.
Évitez de modifier plusieurs variables simultanément.
Utile pour isoler une extension sans FTP, mais dépend de la livraison email.
À retenir
- Avant toute modification, sauvegardez fichiers et base ou assurez-vous d’un point de restauration.
- Ne laissez pas WP_DEBUG_DISPLAY actif sur un site public.
- Un HTTP 500 doit être corrélé aux logs serveur, pas uniquement au journal WordPress.
- Évitez les flush/rebuild automatiques à chaque requête : ils peuvent provoquer charge et instabilité.