Comment corriger l’erreur ‘Destination folder already exists’ lors de l’installation d’un plugin ?

Comprendre l’erreur ‘Destination folder already exists’

Lorsque vous tentez d’installer ou de mettre à jour un plugin sur WordPress, vous pouvez rencontrer le message d’erreur : ‘Destination folder already exists’. Cette erreur se produit généralement lorsque WordPress détecte que le dossier de destination du plugin existe déjà sur votre serveur. Cela peut être dû à une installation incomplète, à une mise à jour interrompue ou à un conflit de permissions. Dans cet article, nous allons explorer les causes, les solutions et les bonnes pratiques pour éviter cette erreur à l’avenir.

Causes courantes de l’erreur ‘Destination folder already exists’

Avant de résoudre le problème, il est essentiel de comprendre ce qui le déclenche. Voici les causes les plus fréquentes :

• Installation manuelle interrompue : Si vous avez téléchargé un plugin via FTP et que le processus a été interrompu, le dossier peut rester vide ou partiellement rempli.
• Mise à jour échouée : Une mise à jour automatique peut échouer, laissant le dossier du plugin en place.
• Plugin déjà installé : Vous essayez d’installer un plugin qui existe déjà, mais qui est désactivé ou corrompu.
• Permissions de fichiers : Des permissions incorrectes peuvent empêcher WordPress de supprimer ou de remplacer le dossier.
• Cache ou plugins de cache : Parfois, un cache peut interférer avec le processus d’installation.

Solutions pour corriger l’erreur ‘Destination folder already exists’

Voici plusieurs méthodes pour résoudre cette erreur, de la plus simple à la plus avancée.

1. Supprimer manuellement le dossier du plugin via FTP

La solution la plus directe consiste à supprimer le dossier du plugin existant via FTP ou le gestionnaire de fichiers de votre hébergement.

• Connectez-vous à votre serveur via un client FTP (comme FileZilla) ou via le gestionnaire de fichiers de votre cPanel.
• Naviguez vers le dossier /wp-content/plugins/.
• Repérez le dossier du plugin qui pose problème (par exemple, mon-plugin).
• Supprimez-le complètement.
• Retournez dans l’administration WordPress et réinstallez le plugin.

Cette méthode élimine tout dossier résiduel et permet une nouvelle installation propre.

2. Utiliser la fonction de désinstallation de WordPress

Si le plugin est répertorié dans votre liste de plugins (même s’il est désactivé), vous pouvez le désinstaller directement depuis le tableau de bord.

• Allez dans Extensions > Plugins installés.
• Trouvez le plugin concerné.
• Cliquez sur Désinstaller (si l’option est disponible).
• Confirmez la suppression.
• Réinstallez le plugin.

Attention : cette option n’est disponible que si WordPress a des informations sur le plugin. Si le dossier est corrompu, la désinstallation peut échouer.

3. Renommer le dossier du plugin via FTP

Si vous ne souhaitez pas supprimer définitivement le plugin, vous pouvez renommer son dossier pour le désactiver.

• Accédez au dossier /wp-content/plugins/ via FTP.
• Renommez le dossier du plugin en ajoutant un suffixe comme -old (ex : mon-plugin-old).
• Retournez dans l’administration WordPress : le plugin devrait apparaître comme désactivé.
• Supprimez-le ou réinstallez-le.

Cette astuce permet de conserver une sauvegarde du dossier au cas où.

4. Vérifier les permissions des fichiers

Des permissions incorrectes peuvent empêcher WordPress de modifier le dossier. Assurez-vous que le dossier /wp-content/plugins/ a les bonnes permissions (généralement 755 pour les dossiers et 644 pour les fichiers).

• Via FTP, faites un clic droit sur le dossier plugins et sélectionnez Permissions de fichiers.
• Définissez la valeur numérique sur 755.
• Cochez Appliquer aux sous-dossiers si vous voulez modifier récursivement.

Si vous utilisez un hébergement mutualisé, contactez votre support pour ajuster les permissions.

5. Vider le cache et désactiver les plugins de cache

Parfois, un plugin de cache peut interférer avec l’installation. Essayez de vider le cache de votre site et de désactiver temporairement tous les plugins de cache.

• Allez dans Extensions > Plugins installés.
• Désactivez tous les plugins liés au cache (W3 Total Cache, WP Super Cache, etc.).
• Essayez à nouveau d’installer votre plugin.
• Réactivez les plugins de cache après l’installation réussie.

6. Utiliser un outil de réparation de base de données

Dans de rares cas, une corruption de la base de données peut causer cette erreur. Utilisez un plugin comme WP-DBManager ou l’outil de réparation intégré de WordPress.

• Installez et activez un plugin de gestion de base de données.
• Lancez une réparation et une optimisation de la base de données.
• Tentez à nouveau l’installation du plugin.

Prévenir l’erreur ‘Destination folder already exists’

Pour éviter cette erreur à l’avenir, suivez ces bonnes pratiques :

• Mettez à jour vos plugins régulièrement : Les mises à jour fréquentes réduisent les risques de conflit.
• Utilisez l’installation automatique : Préférez l’installation depuis le dépôt WordPress plutôt que manuellement.
• Vérifiez les permissions : Assurez-vous que les permissions des dossiers sont correctes.
• Faites des sauvegardes régulières : Avant toute installation ou mise à jour, sauvegardez votre site.
• Désactivez les plugins inutiles : Un site épuré est moins sujet aux erreurs.

Conclusion

L’erreur ‘Destination folder already exists’ lors de l’installation d’un plugin peut sembler bloquante, mais elle est généralement facile à résoudre. La plupart du temps, supprimer ou renommer le dossier du plugin via FTP suffit. Si le problème persiste, vérifiez les permissions, videz le cache ou réparez la base de données. En adoptant de bonnes pratiques de maintenance, vous réduirez considérablement les risques de rencontrer cette erreur. N’oubliez pas de toujours sauvegarder votre site avant d’effectuer des modifications importantes. Avec ces solutions, vous pourrez installer vos plugins en toute sérénité.

Photo by ELG21 on Pixabay