Comprendre le problème
Un échec de mise à jour d'extension WordPress survient quand le remplacement des fichiers du plugin s'interrompt : timeout, permissions insuffisantes, accès FTP manquant ou conflit avec un dossier existant. Le plugin reste alors partiellement mis à jour, ce qui peut casser le site.
La piste à vérifier
Désactivez le plugin par FTP en renommant son dossier, supprimez le dossier résiduel temporaire, puis réinstallez la dernière version de l'extension.
Comment reconnaître ce bug
- Un message « La mise à jour a échoué » s'affiche pour l'extension
- Le plugin disparaît de la liste ou apparaît en double
- Le site affiche une erreur après la tentative de mise à jour
- Une erreur « le dossier de destination existe déjà » apparaît
Qu’est-ce que ce bug ?
Mettre à jour une extension consiste à télécharger sa nouvelle version, supprimer l'ancien dossier et installer le nouveau. Si le processus est coupé, le plugin peut se retrouver avec des fichiers mélangés ou un dossier incomplet. WordPress affiche alors une erreur de mise à jour, et le plugin défectueux peut faire planter le site.
Pourquoi ce problème apparaît
Timeout pendant la mise à jour
Le téléchargement ou la copie des fichiers dépasse le temps d'exécution autorisé.
Permissions de fichiers incorrectes
WordPress ne peut pas écrire dans le dossier wp-content/plugins.
Dossier de destination existant
Un dossier résiduel d'une mise à jour précédente bloque l'installation.
Identifiants FTP manquants
WordPress réclame un accès FTP qu'il ne reçoit pas pour modifier les fichiers.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Désactiver le plugin par FTP
Renommez le dossier de l'extension dans wp-content/plugins (par exemple en y ajoutant _old) pour la désactiver et rétablir l'accès au site.
Supprimer le dossier temporaire
Cherchez dans wp-content/plugins ou wp-content/upgrade un dossier résiduel lié à l'extension et supprimez-le.
Vérifier les permissions
Assurez-vous que wp-content/plugins est en 755 et que WordPress peut y écrire.
Réinstaller l'extension
Supprimez complètement l'ancienne version, puis réinstallez la dernière version depuis le dépôt officiel ou le fichier ZIP.
Réactiver et tester
Réactivez l'extension et vérifiez que le site fonctionne ; ses réglages, stockés en base, sont conservés.
Comment éviter qu’il revienne
- Sauvegardez le site avant de mettre à jour les extensions
- Mettez à jour les plugins un par un, pas en masse
- Maintenez des permissions de fichiers correctes sur wp-content
- Privilégiez des extensions régulièrement maintenues et compatibles
Questions fréquentes
Que faire quand la mise à jour d'un plugin échoue ?
Désactivez le plugin par FTP en renommant son dossier, supprimez tout dossier temporaire résiduel, puis réinstallez proprement la dernière version. Les réglages du plugin, stockés en base, sont conservés.
Vais-je perdre les réglages du plugin en le réinstallant ?
Non, dans la grande majorité des cas. Les réglages des extensions sont enregistrés dans la base de données, pas dans les fichiers : supprimer et réinstaller le dossier du plugin ne les efface pas.
Pourquoi l'erreur « le dossier de destination existe déjà » ?
Une mise à jour précédente a laissé un dossier résiduel. WordPress refuse d'écraser un dossier existant : il faut supprimer ce dossier temporaire avant de relancer l'installation.
Un plugin mal mis à jour peut-il casser le site ?
Oui. Des fichiers incomplets ou incompatibles peuvent provoquer une erreur critique. Désactiver le plugin par FTP rétablit l'accès, puis une réinstallation propre corrige le problème.