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.
Auteur
Walid SadfiWalid 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.