Ir al contenido
01

Erreur « require_once failed opening » sur WordPress : causes et solutions

« Failed opening required » signifie que PHP cherche un fichier qu'il ne trouve pas. Voici comment lire le chemin indiqué, trouver pourquoi le fichier manque et réparer sans casser le site.

Walid Sadfi
Lectura de 4 minutos
Compartir :

Le message ressemble à ceci : Warning: require_once(…): Failed to open stream: No such file or directory, suivi d’un Fatal error: Failed opening required. Le site affiche alors une page blanche ou le message « Il y a eu une erreur critique sur ce site ». Contrairement à beaucoup d’erreurs WordPress, celle-ci est très bavarde : elle donne le chemin exact du fichier manquant. C’est le point de départ de tout le diagnostic.

Lire le message correctement

Le message contient deux chemins : celui du fichier que PHP n’a pas trouvé, et celui du fichier qui a tenté de le charger, avec le numéro de ligne. Le premier dit ce qui manque, le second dit qui le réclame. Si le fichier qui réclame se trouve dans wp-content/plugins/un-plugin, le problème vient de ce plugin. S’il se trouve dans wp-includes ou wp-admin, ce sont les fichiers du cœur de WordPress qui sont incomplets.

Les causes les plus fréquentes

  • Une mise à jour interrompue : le plugin ou WordPress a été partiellement copié, il manque des fichiers.
  • Un plugin de cache supprimé à la main : les fichiers advanced-cache.php ou object-cache.php restent dans wp-content et appellent un plugin qui n’existe plus.
  • Une migration de serveur : un chemin absolu écrit en dur pointe encore vers l’ancien serveur, ou la casse d’un nom de fichier diffère, Linux faisant la différence entre Fichier.php et fichier.php.
  • Un dossier vendor non déployé : un thème ou un plugin installé depuis Git sans lancer composer install ne trouve pas son autoload.
  • Une restriction du serveur : open_basedir ou des droits de fichiers trop stricts empêchent PHP de lire un fichier pourtant présent.

Étape 1 : vérifier si le fichier existe vraiment

Copiez le chemin du message et vérifiez-le en SFTP ou en SSH. Trois cas se présentent : le fichier n’existe pas, il existe avec une casse différente, ou il existe mais PHP n’a pas le droit de le lire.

ls -la /chemin/indique/dans/le/message.php

Étape 2 : réparer selon la cause

Le fichier d’un plugin manque

Réinstallez le plugin à l’identique. Avec WP-CLI, une seule commande suffit et vos réglages, stockés en base de données, sont conservés :

wp plugin install nom-du-plugin --force

Sans accès à l’administration, renommez le dossier du plugin en SFTP, par exemple en ajoutant -off à son nom : WordPress le désactive et le site revient. Vous pourrez ensuite le réinstaller proprement.

Les fichiers du cœur sont incomplets

Comparez vos fichiers aux originaux, puis retéléchargez le cœur sans toucher au dossier wp-content :

wp core verify-checksums
wp core download --force --skip-content

Un ancien fichier de cache est orphelin

Si le fichier qui réclame est wp-content/advanced-cache.php ou object-cache.php, supprimez-le et retirez la ligne define( ‘WP_CACHE’, true ) de wp-config.php si plus aucun plugin de cache n’est installé.

Le chemin est écrit en dur

Dans votre propre code, ne construisez jamais un chemin à partir du dossier courant ou d’un chemin absolu. Partez du fichier lui-même, ce qui fonctionne sur tous les serveurs :

require_once __DIR__ . '/inc/helpers.php';
require_once get_template_directory() . '/inc/helpers.php';

Le fichier existe mais reste illisible

Appliquez les droits standards, 644 pour les fichiers et 755 pour les dossiers, avec le bon propriétaire. Si le message mentionne open_basedir, la restriction se règle dans la configuration PHP de l’hébergement : demandez à votre hébergeur d’y ajouter le dossier concerné.

Éviter que l’erreur revienne

La plupart de ces erreurs naissent d’une mise à jour lancée directement en production ou d’une migration faite à la main. Mettre à jour d’abord sur une préproduction, déployer depuis Git avec une procédure écrite et surveiller les erreurs PHP évitent la quasi-totalité des cas. C’est exactement ce que couvre notre service de maintenance WordPress.

Questions fréquentes

Quelle différence entre require_once et include ?

include ne produit qu’un avertissement si le fichier manque et le script continue. require et require_once arrêtent tout, d’où la page blanche. Le suffixe _once évite seulement de charger deux fois le même fichier.

L’erreur est apparue juste après une migration, que vérifier en premier ?

Les chemins absolus dans wp-config.php et dans les fichiers de cache, puis la casse des noms de fichiers si l’ancien serveur tournait sous Windows ou macOS.

Besoin d’un développeur pour régler le problème ou éviter qu’il revienne ? Découvrez notre service de maintenance WordPress.

Autor

Walid Sadfi

Walid Sadfi est le fondateur d'Evolurise, une équipe d'ingénieurs déployés chez ses clients : développement sur mesure (WordPress, Drupal, React, Laravel), agents IA, DevOps et formation des équipes. Fort de 8 ans d'expérience, il accompagne PME et grands comptes, de la compréhension du problème au déploiement de la solution. Il partage sur ce blog des retours de terrain concrets.