Prestashop 1 Click Upgrade : 20 problèmes et solutions pour corriger
Mise à Jour PrestaShop avec 1-Click Upgrade : 20 Problèmes Courants et Leurs Solutions
Le module 1-Click Upgrade est un outil pratique pour mettre à jour PrestaShop, mais il peut parfois poser des problèmes techniques. Que ce soit des erreurs PHP, des incompatibilités de modules, ou des problèmes de performances, chaque souci a sa solution adaptée. Voici 20 problèmes courants et comment les résoudre efficacement.
📌 Sommaire
- Le module 1-Click Upgrade de PrestaShop ne fonctionne pas
- Erreur de connexion à la base de données lors de la mise à jour de PrestaShop
- Problème de compatibilité PHP avec PrestaShop
- Extensions PHP manquantes pour PrestaShop
- Limite de mémoire insuffisante pour PrestaShop
- Permissions incorrectes des fichiers et dossiers PrestaShop
- Erreur 504 Gateway Timeout lors de la mise à jour de PrestaShop
- Problèmes liés au fichier .htaccess après la mise à jour de PrestaShop
- Modules incompatibles après la mise à jour de PrestaShop
- Thème PrestaShop cassé après la mise à jour
- Erreur "Backup name not specified" dans PrestaShop
- Problèmes SSL après la mise à jour de PrestaShop
- Erreur "Ajax / Server Error for action upgradeFiles" dans PrestaShop
- Problèmes de cache après la mise à jour de PrestaShop
- Erreur "Settings file not found" après la mise à jour de PrestaShop
- Langue et traductions perdues après la mise à jour de PrestaShop
- Erreur "Zip module not enabled" lors de la mise à jour de PrestaShop
- Le mode maintenance de PrestaShop reste activé après la mise à jour
- Erreur "Cannot write settings file" dans PrestaShop
- Navigation et affichage cassés après la mise à jour de PrestaShop
Le module 1-Click Upgrade de PrestaShop ne fonctionne pas
Le module 1-Click Upgrade peut ne pas se lancer correctement à cause d’un module tiers en conflit. Désactivez temporairement les modules non natifs et videz le cache PrestaShop avant de réessayer.
Un autre problème peut être lié à un manque de permissions sur certains fichiers. Assurez-vous que les dossiers /admin/autoupgrade et /modules/autoupgrade ont bien les permissions 755 et que les fichiers sont accessibles en écriture.
Erreur de connexion à la base de données lors de la mise à jour de PrestaShop
Si PrestaShop ne parvient pas à se connecter à la base de données, vérifiez que les identifiants sont corrects dans le fichier settings.inc.php. Une base de données surchargée peut aussi être la cause, essayez d’optimiser les tables via phpMyAdmin.
Un problème d’hébergement peut également empêcher la connexion. Contactez votre hébergeur pour vérifier que les ports MySQL sont bien ouverts et que les ressources serveur ne sont pas limitées.
Problème de compatibilité PHP avec PrestaShop
Si la mise à jour échoue, assurez-vous que la version de PHP est compatible avec votre version cible de PrestaShop. Certaines fonctionnalités requièrent PHP 7.4 ou 8.0, tandis que d'autres ne sont pas compatibles avec PHP 8.1.
Un problème fréquent est l’absence de certaines fonctions PHP désactivées par défaut. Vérifiez dans le fichier php.ini que allow_url_fopen et file_get_contents sont activés pour éviter les erreurs.
Extensions PHP manquantes pour PrestaShop
Le module 1-Click Upgrade nécessite des extensions PHP comme zip, curl, gd et intl. Une mise à jour peut échouer si une extension essentielle est désactivée. Vérifiez leur présence avec la commande php -m.
Si une extension est manquante, installez-la en utilisant apt install php-zip ou yum install php-zip selon votre système. Redémarrez Apache ou Nginx pour appliquer les modifications.
Limite de mémoire insuffisante pour PrestaShop
Si la mise à jour échoue avec un message d'erreur mémoire, cela signifie que la limite PHP est trop basse. Augmentez-la en modifiant memory_limit = 512M dans le fichier php.ini, puis redémarrez votre serveur.
Un autre facteur peut être une exécution trop longue des scripts. Augmentez la valeur de max_execution_time = 300 pour éviter un timeout pendant la mise à jour de PrestaShop.
Permissions incorrectes des fichiers et dossiers PrestaShop
Des permissions incorrectes peuvent empêcher 1-Click Upgrade de modifier les fichiers nécessaires. Assurez-vous que les dossiers importants (/admin/autoupgrade, /modules/autoupgrade, /config, /var) sont définis sur 755 et les fichiers sur 644.
Si l’erreur persiste, essayez de changer le propriétaire des fichiers avec la commande chown -R www-data:www-data /var/www/prestashop/. Cela garantit que le serveur web peut bien les modifier.
Erreur 504 Gateway Timeout lors de la mise à jour de PrestaShop
Un timeout serveur peut survenir si la mise à jour est trop longue. Augmentez le timeout PHP et Apache (max_execution_time = 300) et dans Nginx, ajoutez fastcgi_read_timeout 300s;.
Si votre hébergeur limite les ressources, essayez de faire la mise à jour sur un serveur local avant de la transférer sur votre hébergement en ligne.
Problèmes liés au fichier .htaccess après la mise à jour de PrestaShop
Après la mise à jour, votre site peut afficher une erreur 500 à cause d’un fichier .htaccess corrompu. Supprimez-le et régénérez-le en allant dans SEO & URLs > Réécrire les URL dans PrestaShop.
Si votre site utilise Nginx, assurez-vous que la configuration inclut bien la prise en charge des URLs réécrites, en ajoutant try_files $uri $uri/ /index.php?$args; dans le fichier de configuration.
Modules incompatibles après la mise à jour de PrestaShop
Certains modules tiers peuvent casser PrestaShop après la mise à jour. Avant d’effectuer la migration, vérifiez la compatibilité des modules avec la version cible.
Si votre site affiche une page blanche, désactivez les modules un par un via phpMyAdmin en mettant active = 0 dans la table ps_module. Puis, réactivez-les progressivement après avoir vérifié leur fonctionnement.
Thème PrestaShop cassé après la mise à jour
Un thème personnalisé peut être incompatible avec la nouvelle version de PrestaShop, provoquant un affichage incorrect. Passez temporairement sur le thème natif en modifiant ps_theme dans la base de données.
Si le problème vient des CSS ou JS, videz le cache dans Paramètres avancés > Performances, puis régénérez les fichiers CSS via l'option CCC (Combine, Compress, Cache).
Erreur "Backup name not specified" dans PrestaShop
Si l’erreur "Backup name not specified" apparaît, le module de sauvegarde ne fonctionne pas. Vérifiez que le dossier /admin/autoupgrade/backup/ a bien les permissions en écriture (755).
Si la sauvegarde échoue, réalisez-en une manuellement via phpMyAdmin pour la base de données, et copiez les fichiers du site par FTP avant de relancer la mise à jour.
Problèmes SSL après la mise à jour de PrestaShop
Après une mise à jour, votre site peut afficher des erreurs SSL si la redirection HTTPS est mal configurée. Dans SEO & URLs, activez Forcer SSL sur toutes les pages et assurez-vous que Shop URL est bien en HTTPS.
Un problème de contenu mixte peut aussi empêcher certaines pages de se charger. Vérifiez que tous les fichiers CSS, JS et images sont bien appelés en HTTPS dans votre thème.
Erreur "Ajax / Server Error for action upgradeFiles" dans PrestaShop
Si la mise à jour plante avec cette erreur, le serveur bloque certaines requêtes AJAX nécessaires au module 1-Click Upgrade. Désactivez temporairement ModSecurity sur votre hébergement.
Vous pouvez aussi essayer de diminuer la taille des lots de fichiers mis à jour dans les paramètres du module 1-Click Upgrade, ce qui réduit la charge sur le serveur.
Problèmes de cache après la mise à jour de PrestaShop
Après une mise à jour, certains éléments de PrestaShop peuvent ne pas s'afficher correctement à cause du cache obsolète. Allez dans Paramètres avancés > Performances et videz le cache Smarty.
Si le problème persiste, supprimez manuellement les dossiers /var/cache/dev et /var/cache/prod/. Puis, régénérez le cache en rechargeant votre site.
Erreur "Settings file not found" après la mise à jour de PrestaShop
Si PrestaShop affiche cette erreur après la mise à jour, cela signifie que le fichier settings.inc.php dans /config/ a été supprimé ou corrompu. Vérifiez que ce fichier est bien présent et que les permissions sont correctes (644).
Une solution consiste à restaurer une sauvegarde du fichier settings.inc.php et à s’assurer que les informations de connexion à la base de données sont bien renseignées. Si nécessaire, réinstallez le module 1-Click Upgrade et relancez la mise à jour.
Langue et traductions perdues après la mise à jour de PrestaShop
Après la mise à jour, certaines traductions peuvent disparaître ou être réinitialisées en anglais. Pour les restaurer, allez dans International > Traductions, sélectionnez la langue et cliquez sur Ajouter / Mettre à jour une langue.
Un problème fréquent est la suppression de fichiers de traduction pendant l’upgrade. Assurez-vous que les fichiers dans /translations/ sont toujours présents et rechargez les packs de langues via le back-office de PrestaShop.
Erreur "Zip module not enabled" lors de la mise à jour de PrestaShop
Si PrestaShop affiche cette erreur, cela signifie que l’extension PHP Zip est désactivée, empêchant la mise à jour des fichiers. Vérifiez la liste des extensions avec php -m | grep zip et activez-la si nécessaire (apt install php-zip sous Debian/Ubuntu).
Une fois activée, redémarrez votre serveur web (service apache2 restart ou systemctl restart nginx) et relancez la mise à jour. Contactez votre hébergeur si vous n’avez pas accès aux configurations PHP.
Le mode maintenance de PrestaShop reste activé après la mise à jour
Parfois, après la mise à jour, PrestaShop reste bloqué en mode maintenance. Pour le désactiver, allez dans Paramètres > Paramètres généraux et désactivez l’option Mode Maintenance.
Si vous n’avez plus accès au back-office, connectez-vous à phpMyAdmin et modifiez la table ps_configuration. Recherchez PS_SHOP_ENABLE, mettez la valeur à 1 et rechargez votre site.
Erreur "Cannot write settings file" dans PrestaShop
Si PrestaShop affiche cette erreur, cela signifie que le fichier settings.inc.php ou d’autres fichiers système ne peuvent pas être écrits. Vérifiez que les permissions des dossiers /config/, /var/, et /themes/ sont bien définies sur 755, et les fichiers en 644.
Une autre solution est de changer temporairement le propriétaire des fichiers avec chown -R www-data:www-data /var/www/prestashop/, puis réessayer la mise à jour. Si cela ne fonctionne pas, restaurez une ancienne version du fichier settings.inc.php.
Navigation et affichage cassés après la mise à jour de PrestaShop
Si après la mise à jour, PrestaShop a un affichage décalé ou brisé, cela peut être dû à un cache obsolète ou à des fichiers CSS et JavaScript non chargés. Videz le cache Smarty dans Paramètres avancés > Performances et désactivez la mise en cache du thème.
Si le problème persiste, utilisez l’outil Inspecteur du navigateur (F12) pour identifier les fichiers manquants et vérifiez dans /themes/ que les fichiers CSS et JS sont bien présents. Une réinstallation du thème peut être nécessaire en dernier recours.