doganddev
Accueil Blog Boutique

Corriger l'erreur 500 WordPress : guide étape par étape

DOG&DEV · 26/01/2025

Technique Réplication
Corriger l'erreur 500 WordPress : guide étape par étape

Corriger l'erreur 500 WordPress : guide étape par étape

L'erreur 500 Internal Server Error sur WordPress est frustrante : écran blanc, message générique, aucune information utile. Ce guide vous accompagne étape par étape pour identifier et corriger la cause, de la plus simple à la plus complexe.

Prérequis

  • Accès FTP/SFTP ou File Manager (cPanel, Plesk)
  • Accès à la base de données (optionnel mais recommandé)
  • Connaissances de base en administration web

Qu'est-ce que l'erreur 500 ?

L'erreur 500 signifie que le serveur a rencontré un problème inattendu et ne peut pas traiter la requête. Contrairement aux 404 (page non trouvée) ou 403 (accès refusé), le 500 indique un problème côté serveur.

Symptômes courants

  • Écran blanc (White Screen of Death)
  • Message "Internal Server Error"
  • Site inaccessible, même le dashboard /wp-admin

Solutions par ordre de priorité

1. Vérifier et régénérer .htaccess

Le fichier .htaccess corrompu est une cause fréquente.

Via FTP/File Manager :

  1. Localiser .htaccess dans la racine WordPress
  2. Renommer en .htaccess.old
  3. Tester si le site fonctionne
  4. Si oui, régénérer : WordPressRéglagesPermaliensEnregistrer

Contenu .htaccess WordPress standard :

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

2. Augmenter la limite de mémoire PHP

Via wp-config.php :

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Via cPanel/Plesk : modifier memory_limit dans la configuration PHP.

3. Désactiver tous les plugins

Si vous avez accès au dashboard :

  1. ExtensionsExtensions installées
  2. Désactiver toutes les extensions
  3. Tester le site
  4. Réactiver une par une pour identifier le coupable

Si vous n'avez PAS accès au dashboard :

Via FTP/File Manager :

  1. Aller dans wp-content/plugins/
  2. Renommer le dossier plugins en plugins.old
  3. Créer un nouveau dossier plugins (vide)
  4. Tester le site
  5. Si ça fonctionne, renommer plugins.old en plugins et désactiver les plugins un par un

4. Changer de thème

Via FTP/File Manager :

  1. Aller dans wp-content/themes/
  2. Renommer le thème actif (ex. mon-thememon-theme.old)
  3. WordPress basculera automatiquement sur un thème par défaut
  4. Tester le site

5. Réinstaller les fichiers WordPress core

Télécharger WordPress depuis wordpress.org, puis :

  1. Remplacer les dossiers wp-admin/ et wp-includes/
  2. Remplacer les fichiers PHP à la racine (sauf wp-config.php)
  3. Ne PAS toucher à wp-content/ (vos fichiers, thèmes, plugins)

6. Vérifier les permissions de fichiers

Permissions correctes :

  • Dossiers : 755 ou 750
  • Fichiers : 644 ou 640
  • wp-config.php : 600 ou 640

Via FTP : clic droit → Modifier les permissions

Via SSH :

find /chemin/vers/wordpress/ -type d -exec chmod 755 {} \;
find /chemin/vers/wordpress/ -type f -exec chmod 644 {} \;
chmod 600 wp-config.php

7. Activer le mode debug

Dans wp-config.php :

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Les erreurs seront enregistrées dans wp-content/debug.log.

⚠️ Important : désactiver en production après résolution :

define('WP_DEBUG', false);

8. Vérifier les logs serveur

cPanel : MétriquesErreurs

Plesk : JournauxJournaux d'erreur

SSH :

# Apache
tail -f /var/log/apache2/error.log

# Nginx
tail -f /var/log/nginx/error.log

9. Vérifier la base de données

Problèmes courants :

  • Connexion impossible : vérifier DB_HOST, DB_USER, DB_PASSWORD dans wp-config.php
  • Tables corrompues : réparer via phpMyAdmin ou WP-CLI

Réparation via phpMyAdmin :

  1. Sélectionner la base de données WordPress
  2. Réparer la table (onglet ou menu)

Via WP-CLI :

wp db repair

10. Vérifier la configuration PHP

Extensions PHP requises :

  • php-mysql ou php-mysqli
  • php-xml
  • php-mbstring
  • php-curl
  • php-zip

Limites PHP :

  • memory_limit : 256M minimum
  • max_execution_time : 300
  • upload_max_filesize : 64M
  • post_max_size : 64M

Erreur 500 uniquement sur wp-admin

Si le front-end fonctionne mais pas le dashboard :

  1. Augmenter la mémoire pour l'admin :
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
  1. Désactiver les plugins admin spécifiques
  2. Vider le cache du navigateur
  3. Vérifier les cookies et la session PHP

Dépannage avancé

Vérifier les erreurs PHP récentes

# Chercher les erreurs récentes
tail -n 100 /var/log/php_errors.log

Tester avec un fichier PHP simple

Créer test.php à la racine :

<?php
phpinfo();
?>

Si cela fonctionne, le problème est spécifique à WordPress.

Vérifier la version PHP

WordPress nécessite PHP 7.4+ (8.0+ recommandé). Vérifier dans cPanel/Plesk ou :

php -v

Prévention

Avant les mises à jour

  1. Sauvegarder complètement (fichiers + base de données)
  2. Tester en staging si possible
  3. Désactiver les plugins non essentiels temporairement

Maintenance régulière

  • Mettre à jour WordPress, thèmes et plugins régulièrement
  • Surveiller les logs d'erreur
  • Tester les sauvegardes régulièrement
  • Limiter le nombre de plugins actifs

Dépannage

Symptôme Cause possible Correctif
Écran blanc total .htaccess corrompu, plugin fatal Renommer .htaccess ; désactiver plugins
500 après mise à jour Plugin/thème incompatible Désactiver extensions récentes ; restaurer backup
500 uniquement sur certaines pages Plugin spécifique, permalink Désactiver plugins un par un ; régénérer permaliens
500 intermittent Ressources insuffisantes, surcharge Augmenter mémoire PHP ; vérifier ressources serveur
500 avec message d'erreur PHP Erreur de code visible Activer WP_DEBUG ; corriger l'erreur affichée

Bonnes pratiques

  • Sauvegardes régulières : avant toute modification
  • Staging : tester les changements avant production
  • Plugins de qualité : vérifier les avis et mises à jour
  • Monitoring : surveiller les erreurs 500 avec des outils

Ressources


Cet article s'inscrit dans notre série de guides WordPress et hébergement. Pour un hébergement sur-mesure, contact.

Commentaires (0)

Laisser un commentaire