Corriger l’échec d’écriture du fichier sur le disque dans WordPress

C’est l’un des messages d’erreur les plus directs et les plus frustrants de WordPress. Vous essayez de téléverser une image, un plugin ou un thème, et WordPress vous répond sèchement : "Échec d’écriture du fichier sur le disque". Cette erreur bloque l’une des fonctionnalités les plus fondamentales de votre site : l’ajout de nouveau contenu. Heureusement, ce message, bien que technique, pointe presque toujours vers une seule et même cause, qui est relativement simple à corriger. En effet, ce problème n’est généralement pas un bug de WordPress, mais un simple problème de permissions sur votre serveur d’hébergement. Nous allons vous guider pour résoudre ce problème et retrouver le contrôle de vos téléversements.

La cause principale : Un problème de permissions de fichiers

Pour comprendre cette erreur, il faut visualiser votre serveur d’hébergement comme un immeuble d’appartements. Chaque dossier est un appartement, et chaque fichier est un objet à l’intérieur. Le système d’exploitation a des règles très strictes (les "permissions") qui définissent qui a le droit d’entrer, de regarder, ou de déposer de nouvelles choses dans chaque appartement.

WordPress, pour fonctionner, a besoin d’avoir la permission "d’écrire" dans certains de ses propres dossiers. Le plus important est le dossier wp-content/uploads, où il stocke toutes les images et tous les médias que vous téléversez.

L’erreur "Échec d’écriture du fichier sur le disque" signifie simplement que les permissions du dossier uploads sont incorrectes. WordPress essaie de déposer un nouveau fichier, mais le serveur lui claque la porte au nez en lui disant "Désolé, vous n’avez pas le droit d’écrire ici".

Cette situation peut survenir après une migration de site, à cause d’une mauvaise configuration de l’hébergeur, ou parfois après une mise à jour qui a accidentellement modifié les permissions.

La solution : Corriger les permissions de fichiers et de dossiers

Pour corriger cela, vous devez vous connecter à votre serveur et ajuster manuellement les permissions. Vous pouvez le faire via un client FTP (comme FileZilla) ou, plus simplement, via le Gestionnaire de fichiers de votre panneau d’hébergement (cPanel).

1. Accédez à vos fichiers : Connectez-vous à votre cPanel fourni par votre hébergeur, comme Tswan Hosting, et ouvrez le "Gestionnaire de fichiers".
2. Naviguez jusqu’au bon dossier : Allez dans le dossier racine de votre site (souvent public_html), puis ouvrez le dossier wp-content.
3. Vérifiez les permissions du dossier uploads : Faites un clic droit sur le dossier uploads et sélectionnez "Change Permissions" (ou "Modifier les permissions").
4. Appliquez les bonnes valeurs : Une boîte de dialogue s’ouvrira. Vous devez vous assurer que les permissions sont réglées sur la bonne valeur numérique. La règle standard est la suivante :
   • Tous les dossiers (y compris uploads et ses sous-dossiers) doivent avoir la permission 755.
   • Tous les fichiers doivent avoir la permission 644.
5. Entrez la valeur 755 pour le dossier uploads. Si vous utilisez un client FTP, assurez-vous de cocher l’option "Réappliquer à tous les sous-dossiers" pour que la permission se propage correctement.
6. Retournez sur votre site et essayez de téléverser à nouveau votre fichier. Dans 99% des cas, le problème sera résolu.

Autres causes possibles (plus rares)

Si la correction des permissions n’a pas fonctionné, voici deux autres pistes à explorer.

Votre hébergement est plein

C’est une cause logique : si votre espace disque est plein, il est littéralement impossible d’y écrire de nouveaux fichiers. Vérifiez votre quota d’espace disque dans votre cPanel. S’il est à 100%, vous devrez soit supprimer des fichiers inutiles, soit passer à un plan d’hébergement web supérieur.

Problème avec le répertoire temporaire

Parfois, le problème vient du fait que PHP n’a pas accès à un dossier temporaire pour traiter le fichier avant de le déplacer dans le dossier uploads. C’est un problème de configuration serveur plus complexe. Si vous suspectez cela, le plus simple est de contacter le support de votre hébergeur.

En conclusion, l’erreur "Échec d’écriture du fichier sur le disque" est presque toujours un simple cas de permissions de dossier incorrectes. En apprenant à vérifier et à corriger la permission du dossier wp-content/uploads pour la remettre à 755, vous avez la clé pour résoudre ce problème rapidement et de manière autonome. C’est une compétence de dépannage de base qui vous sera utile tout au long de votre parcours avec WordPress. Et si jamais le problème persiste, un support technique réactif, comme celui proposé par les experts de Tswan Softwares, pourra toujours vous aider.