Reconnaître le blocage avant de recommencer
Vous installez WordPress et l’outil de l’hébergeur refuse de créer un dossier ou de déposer les fichiers. Autre cas : les fichiers sont déjà présents, mais l’assistant natif de WordPress ne peut pas enregistrer sa configuration. Ces étapes ne sont pas identiques. Recommencer avec les mêmes paramètres ne résout pas le refus : identifiez le dossier concerné, l’outil utilisé et le compte qui tente d’y écrire.
Ce guide concerne une nouvelle installation autohébergée. Un refus pendant la mise à jour d’une extension ou l’envoi d’une image demande un diagnostic différent. Sur WordPress.com, la création habituelle du site ne passe pas par l’installation manuelle du cœur : utilisez l’assistance de la plateforme si son parcours de création échoue.
Conservez le message exact, l’heure, le domaine choisi et l’étape qui échoue. Distinguez « impossible de créer le dossier » de « impossible d’écrire le fichier wp-config.php ». Le second cas peut parfois se résoudre en préparant ce fichier manuellement, sans ouvrir davantage les permissions de tout le répertoire.
Si ce domaine affichait déjà votre site avant l’incident, arrêtez l’installation. Un assistant apparu après une migration ne prouve pas que WordPress doit être réinstallé. Il faut d’abord retrouver la bonne installation, sa configuration et sa base. Ajouter un nouveau site au même emplacement pourrait compliquer cette récupération.
Choisir le parcours qui correspond au message
L’approche 1 convient lorsque le répertoire choisi paraît incorrect ou que plusieurs domaines partagent le compte d’hébergement. Elle consiste à retrouver le dossier réellement associé au domaine et à vérifier ce qu’il contient. Vous n’avez pas besoin de changer des droits pour corriger une destination mal sélectionnée.
L’approche 2 vise un refus d’écriture confirmé sur le bon emplacement. Elle sépare les permissions, le propriétaire des fichiers et les ressources disponibles. Certaines corrections appartiennent à l’hébergeur : votre compte de gestion et le programme d’installation ne travaillent pas nécessairement avec la même identité sur le serveur.
L’approche 3 concerne uniquement un assistant WordPress qui ne peut pas produire wp-config.php alors que les fichiers sont déjà correctement déposés. Une configuration préparée avec les bonnes données permet de poursuivre ce cas précis. Elle ne répare ni un stockage plein, ni un dossier appartenant au mauvais compte.
Gardez le même objectif pendant les essais : finir une seule installation, dans le répertoire prévu, sans exposer ses secrets ni modifier les autres sites du compte. Après chaque correction, répétez seulement l’étape concernée et examinez son résultat avant de poursuivre.
Préserver l’existant et vérifier vos accès
Un dossier présenté comme disponible peut contenir une ancienne page, une configuration, des fichiers cachés ou un autre site. Examinez son contenu avant tout remplacement. Si vous ne reconnaissez pas certains éléments, demandez au responsable du compte de les identifier. Un nom de dossier familier ne suffit pas à autoriser son nettoyage.
Si vous reprenez une installation interrompue, conservez une copie des fichiers présents et notez la base éventuellement créée. Pour un emplacement déjà utilisé, faites préserver les fichiers et les données correspondantes avant toute intervention. Ne supprimez pas une base simplement parce que l’installateur propose d’en créer une autre.
Il faut un accès autorisé au panneau d’hébergement ou aux fichiers par un protocole sécurisé prévu par le prestataire. Un compte administrateur WordPress ne donne pas automatiquement ces droits. Vérifiez que l’accès vise le bon abonnement, surtout lorsqu’une agence gère plusieurs clients ou lorsqu’un domaine a récemment changé de compte.
Gardez vos notes et copies de configuration dans un emplacement privé. Ne placez pas un fichier renommé wp-config.php.bak dans le répertoire public. Une copie portant une autre extension peut ne plus être traitée comme du PHP et révéler son contenu. Le dossier d’un site n’est pas l’endroit où archiver ses secrets.
Approche 1 : retrouver le dossier réellement associé au domaine
Dans le panneau d’hébergement, ouvrez la rubrique des sites ou des domaines, puis la fiche du domaine concerné. Repérez la racine des documents : c’est le dossier dont le serveur utilise les fichiers pour répondre à cette adresse. Son nom dépend de l’hébergement ; public_html n’est pas une destination universelle pour tous les domaines.
Avec cPanel, la rubrique Domains, parfois traduite Domaines, présente les domaines du compte et leurs informations. Relevez la racine indiquée pour le bon domaine, puis retrouvez ce chemin dans File Manager, le gestionnaire de fichiers. Les fonctions visibles peuvent varier selon les options activées par le prestataire.
Comparez ce chemin à la destination affichée dans l’installateur. Vérifiez aussi un éventuel champ de sous-dossier. Installer dans un dossier blog signifie généralement préparer un site à cette sous-adresse, et non à la racine du domaine. Ne retirez pas cette partie sans vérifier où les fichiers seront déposés.
Prenons un exemple fictif : le compte contient les dossiers site-client-a et site-client-b. Le domaine du second client doit viser le second dossier. Le premier peut être accessible en écriture, mais y réussir l’installation ne serait pas une réparation : vous auriez simplement installé WordPress au mauvais endroit.
Corriger la destination sans déplacer un site existant
Si l’installateur vise un dossier différent de celui prévu, corrigez son champ de destination avant de le relancer. Revenez ensuite sur l’écran récapitulatif : domaine, sous-dossier et base choisie doivent correspondre au projet. Une modification du seul champ de destination ne demande pas de déplacer les fichiers des autres domaines.
Si le dossier attendu manque, faites confirmer sa création par le panneau ou le responsable de l’hébergement. Évitez de fabriquer plusieurs répertoires ressemblants pour trouver celui qui fonctionne. Vous devez pouvoir relier l’adresse du navigateur, le chemin serveur et la fiche du site sans ambiguïté.
Lorsque des fichiers WordPress sont déjà présents, vérifiez s’ils appartiennent à la tentative interrompue ou à une installation antérieure. L’avertissement signalant des fichiers existants n’est pas nécessairement une erreur de permissions. Ne cochez pas une option d’écrasement pour faire disparaître cet avertissement sans avoir identifié ce qui sera remplacé.
Relancez ensuite une seule fois l’étape qui échouait. Si le même chemin est encore refusé, la destination est désormais confirmée : passez à l’examen des accès. Si l’installation commence dans un autre dossier que celui prévu, interrompez-la par le mécanisme normal de l’outil et faites clarifier ce décalage.
Approche 2 : distinguer permissions et propriétaire
Les permissions indiquent quelles opérations un compte peut effectuer sur un fichier ou un dossier. Sous les hébergements de type Unix, elles distinguent notamment propriétaire, groupe et autres utilisateurs. Pour créer un fichier dans un dossier, le processus doit pouvoir écrire dans ce dossier et le traverser, ainsi que traverser les dossiers parents du chemin. Le droit de traversée d’un dossier ne signifie pas qu’il faut rendre tous les fichiers exécutables.
Le propriétaire désigne le compte auquel l’élément appartient. Un nombre de permissions qui convient à un environnement peut échouer dans un autre si les fichiers ont été déposés par un compte différent. Ce cas peut survenir après une extraction d’archive ou une intervention réalisée avec des droits administratifs sur le serveur.
Les valeurs 755 pour un dossier et 644 pour un fichier sont courantes, mais elles ne constituent pas une correction universelle. D’autres modes peuvent être nécessaires selon l’identité utilisée par PHP et l’organisation du prestataire. Le fichier de configuration mérite aussi une protection adaptée à son contenu sensible.
Demandez donc au support quelle identité exécute l’installation et quelles valeurs sont prévues pour ce chemin précis. Réussir à créer un fichier depuis le gestionnaire ou par SFTP ne prouve pas que PHP possède les mêmes accès. Ne remplacez pas cette vérification par 777, qui autorise l’écriture beaucoup plus largement. Ne transformez pas non plus tous les fichiers et dossiers en éléments ayant la même valeur : leurs besoins diffèrent.
Appliquer une correction limitée depuis le gestionnaire de fichiers
Si le prestataire a confirmé une permission incorrecte que votre compte peut modifier, sélectionnez uniquement l’élément concerné. Dans le gestionnaire de fichiers de cPanel, utilisez Permissions, relevez la valeur actuelle, puis appliquez la valeur confirmée avec Change Permissions. Vérifiez le nom de l’élément sélectionné avant de valider.
Notez le chemin, l’ancienne valeur et la nouvelle. Refusez une application récursive à tous les sous-dossiers si elle ne fait pas partie d’une intervention précisément justifiée. Une correction sur le dossier d’installation ne doit pas toucher les archives privées, les autres sites ni les fichiers de configuration du compte.
Revenez à l’assistant et refaites l’action qui était refusée. Si le résultat ne change pas, n’augmentez pas progressivement les droits au hasard. Restaurez la valeur initiale si elle doit l’être selon l’intervention prévue, puis transmettez l’échec avec le chemin et l’heure. Il faut alors vérifier une autre cause.
Si le panneau refuse la modification ou si le propriétaire est incorrect, passez par l’hébergeur. Ne cherchez pas à obtenir un accès administrateur au serveur uniquement pour appliquer une commande copiée ailleurs. Sur un compte mutualisé, le prestataire doit corriger l’appartenance du chemin concerné sans élargir les droits sur tout l’abonnement.
Examiner le stockage et les restrictions du compte
Un dossier peut avoir des permissions adaptées et rester impossible à remplir faute de place. Consultez les indicateurs de stockage du panneau. Avec cPanel, Disk Usage permet de repérer l’espace utilisé par les fichiers et dossiers. Un message signalant le dépassement du quota indique un problème différent d’une permission refusée.
Vérifiez également les autres limites annoncées par votre hébergement, notamment le nombre de fichiers lorsqu’un tel plafond existe. Une archive compressée peut occuper peu de place avant extraction, puis produire de nombreux fichiers. Le support doit confirmer quelle limite effective empêche l’opération, au lieu de vous faire modifier les droits sans rapport.
Ne libérez pas de l’espace en supprimant les dossiers inconnus du compte. Faites identifier les éléments devenus inutiles et préservez les sauvegardes nécessaires hors du serveur avant un nettoyage ciblé. Si une augmentation de capacité est proposée, examinez le coût et la cause du remplissage ; elle ne remplace pas automatiquement le diagnostic.
Le support peut aussi constater un stockage monté en lecture seule, une restriction de sécurité ou une limite propre à l’outil d’installation. Demandez le contrôle de l’opération exacte. Une règle serveur ne doit pas être désactivée globalement simplement pour voir si l’installation passe ; une correction doit correspondre à la cause observée.
Approche 3 : préparer wp-config.php lorsque seul ce fichier manque
Cette méthode s’applique à une nouvelle installation manuelle dont les fichiers WordPress sont déjà au bon endroit. L’assistant a reçu les renseignements nécessaires mais ne parvient pas à écrire wp-config.php. Si ce fichier existe déjà et correspond à un site antérieur, ne le remplacez pas : faites examiner la configuration existante. Faites aussi vérifier le dossier parent immédiat : WordPress peut y charger une configuration sous certaines conditions. Ne déplacez ni ne supprimez cette configuration pour forcer une nouvelle installation.
Lorsque l’assistant affiche le contenu à copier après son refus d’écriture, vous pouvez le reprendre intégralement dans un fichier local privé. Ce contenu contient des secrets : ne le collez pas dans un forum ou un service public. WordPress permet aussi de partir de wp-config-sample.php, présent dans son paquet officiel. Dans un éditeur de texte, renseignez alors les valeurs prévues : nom de base, utilisateur, mot de passe et serveur de base.
Le compte de base de données est différent du futur administrateur WordPress. Faites confirmer son accès à la base prévue, sans lui attribuer des privilèges globaux sur le serveur. Ne supposez pas que son adresse est toujours localhost. Conservez la syntaxe PHP et des clés de sécurité uniques ; une apostrophe ou une barre oblique inversée dans une valeur doit être représentée correctement. Si vous ne maîtrisez pas cette écriture, utilisez le contenu produit par l’assistant ou faites préparer le fichier par le prestataire, sans simplifier le mot de passe. Un traitement de texte qui transforme les guillemets ne convient pas.
Confirmez également que la base et le préfixe des tables sont destinés à cette nouvelle installation. Une base dédiée évite les confusions. Si plusieurs installations partagent volontairement une base, leur préfixe doit être distinct. Ne changez pas celui d’un site existant pour faire apparaître un nouvel assistant et ne réutilisez pas un groupe de tables inconnu.
Enregistrez le fichier sous le nom exact wp-config.php, en texte UTF-8 sans marqueur BOM ni extension .txt supplémentaire, puis transférez-le vers le répertoire WordPress confirmé. Conservez ses permissions selon les indications du prestataire. N’ajoutez pas de copies contenant les identifiants à des emplacements publics pour faciliter les essais.
Reprendre l’installation et interpréter le prochain résultat
Après le transfert du fichier de configuration, reprenez l’assistant à l’adresse correspondant à cette installation. Le chemin wp-admin/install.php se trouve sous la racine WordPress ; si WordPress est installé dans un sous-dossier, son préfixe fait partie de l’adresse. Vérifiez le domaine avant de saisir les informations du futur site.
Si un message de connexion à la base apparaît désormais, l’installation a franchi une étape différente. Ne revenez pas aux permissions du dossier pour traiter ce nouveau message. Comparez la configuration avec les données de l’hébergement et utilisez le diagnostic consacré à la connexion à la base de données.
Si le fichier de configuration ne peut même pas être transféré, cette méthode ne contournera pas le refus d’écriture. Revenez au diagnostic du chemin, du compte et des ressources. Si le navigateur propose de télécharger du PHP ou montre son contenu, interrompez la procédure et faites bloquer l’accès public concerné par le prestataire pendant la correction du traitement PHP. S’il confirme que des identifiants ou clés ont été exposés, faites-les remplacer et mettre à jour la configuration avant la reprise ; ne transmettez pas leur contenu dans une capture publique.
L’installation doit aboutir à la création du site attendu, puis à un accès normal à son administration. Une disparition du premier avertissement ne suffit pas. Contrôlez l’adresse affichée, le titre du nouveau site et l’absence de modification des autres sites gérés dans le même compte.
Vérifier le fonctionnement et refermer l’intervention
Une fois connecté, ouvrez l’accueil et une page de l’administration. Dans un site neuf, créez un brouillon de contrôle puis rouvrez-le pour vérifier l’enregistrement. Essayez ensuite un petit média non confidentiel si le projet doit en recevoir. Ce contrôle distingue une installation terminée d’un environnement encore incapable d’écrire les fichiers nécessaires.
Si l’envoi du média échoue, relevez son message précis : ne réappliquez pas automatiquement la correction du dossier d’installation à toute la bibliothèque. Le téléversement peut être arrêté par un plafond de taille, un quota ou une étape de traitement distincte. Le guide adapté à ce nouveau symptôme sera plus utile.
Confirmez avec le prestataire les permissions à conserver après l’installation. Retirez les éléments temporaires identifiés et devenus inutiles, sans supprimer les fichiers standards de WordPress ni la configuration active. Gardez le relevé de l’intervention et la copie privée de sécurité selon votre organisation habituelle.
Pour demander de l’aide, transmettez le domaine concerné, le chemin refusé, l’heure, l’outil utilisé, l’étape exacte et les corrections déjà essayées. Une capture du message suffit souvent à commencer ; elle ne doit pas montrer de mot de passe. Demandez une réponse sur la cause confirmée, la correction appliquée et le contrôle effectué. Vous disposerez ainsi d’une installation comprise, pas seulement d’un écran qui a fini par passer.
