Drupal est un système de gestion de contenu de niveau entreprise connu pour sa flexibilité et sa puissance. Mais avec cette puissance viennent des défis. Dans cet article, nous couvrons les 15 problèmes Drupal les plus courants et comment les résoudre.

1. Écran blanc de la mort (WSOD)

Le redouté écran blanc sans message d'erreur.

Causes

  • Limite de mémoire PHP
  • Erreur PHP fatale
  • Module corrompu
  • Problème de connexion à la base de données

Solution

Activer le rapport d'erreurs:

Ajoutez dans sites/default/settings.php:

error_reporting(E_ALL);
ini_set('display_errors', TRUE);
$config['system.logging']['error_level'] = 'verbose';

Augmenter la mémoire PHP:

ini_set('memory_limit', '512M');

2. Le site a rencontré une erreur inattendue

Page d'erreur générique dans Drupal 8/9/10.

Solution

Voir les logs:

drush watchdog:show

3. Erreurs de connexion à la base de données

Messages d'erreur "PDOException" ou "SQLSTATE".

Solution

Vérifier les identifiants dans settings.php:

$databases['default']['default'] = [
  'database' => 'drupal_db',
  'username' => 'db_user',
  'password' => 'db_password',
  'host' => 'localhost',
  'driver' => 'mysql',
];

4. Problèmes de cache

Les modifications ne sont pas visibles ou le site se comporte étrangement.

Solution

Vider tout le cache:

drush cache:rebuild
# ou plus court:
drush cr

5. L'installation ou mise à jour du module échoue

Composer donne des erreurs ou le module ne fonctionne pas.

Solution

Augmenter la mémoire Composer:

COMPOSER_MEMORY_LIMIT=-1 composer require drupal/module_name

6. Problèmes de téléchargement de fichiers

Le téléchargement de médias ou fichiers échoue.

Solution

Ajuster les paramètres PHP:

upload_max_filesize = 64M
post_max_size = 64M

7. "Accès refusé" pour le contenu ou l'admin

Vous ne pouvez pas accéder de manière inattendue à certaines pages.

Solution

Reconstruire le cache des permissions:

drush php-eval 'node_access_rebuild();'

8. Les Views ne se chargent pas ou donnent des erreurs

Les problèmes du module Views sont courants.

Solution

Cache spécifiquement pour Views:

drush views:invalidate --all
drush cr

9. Performance du site lente

Drupal peut devenir lent sans bonne optimisation.

Solution

Activer la mise en cache:

  1. Configuration → Performance
  2. Réglez "Âge maximum du cache de page" sur une heure ou plus
  3. Cochez "Agréger les fichiers CSS" et "Agréger les fichiers JavaScript"

10. Les hooks de mise à jour échouent

drush updatedb donne des erreurs.

Solution

Réexécuter une mise à jour spécifique:

drush updatedb-status
drush updatedb

11. Problèmes de synchronisation de configuration

L'import/export de config ne fonctionne pas correctement.

Solution

Voir le statut de la config:

drush config:status

12. Problèmes de thème/template

Le frontend semble incorrect ou erreurs Twig.

Solution

Activer le débogage Twig:

Dans sites/default/services.yml:

parameters:
  twig.config:
    debug: true

13. Cron ne s'exécute pas

Les tâches planifiées ne sont pas exécutées.

Solution

Exécuter cron manuellement:

drush cron

14. Contenu mixte SSL/HTTPS

Avertissements de contenu non sécurisé après activation SSL.

Solution

Forcer l'URL de base:

Dans settings.php:

$base_url = 'https://votresite.fr';

15. Erreurs de mémoire épuisée

Message d'erreur "Allowed memory size exhausted".

Solution

Augmenter la mémoire PHP:

ini_set('memory_limit', '512M');

Commandes Drush utiles

drush status
drush sql:dump > backup.sql
drush pm:list
drush watchdog:show --count=20

Articles connexes

Besoin d'aide?

Vous n'y arrivez pas? Notre équipe support est là pour vous! Envoyez un ticket via le portail client et nous vous aiderons généralement en quelques heures.