Installation Prestashop : 20 problèmes et solutions pour corriger
Installation de PrestaShop : 20 Problèmes Courants et Leurs Solutions
L'installation de PrestaShop peut être un défi, en raison de divers problèmes techniques qui peuvent survenir. Que ce soit une erreur serveur, un problème de compatibilité PHP ou un problème de base de données, chaque obstacle a une solution adaptée. Voici 20 problèmes fréquents, accompagnés de leurs solutions détaillées.
📌 Sommaire
- Erreur HTTP 500 lors de l’installation de PrestaShop
- Problèmes de permissions des fichiers et dossiers dans PrestaShop
- Compatibilité PHP avec PrestaShop
- Extensions PHP manquantes pour PrestaShop
- Limite de mémoire insuffisante pour PrestaShop
- Erreur de connexion à la base de données PrestaShop
- Problèmes de configuration du serveur pour PrestaShop
- Erreur 404 après l’installation de PrestaShop
- Problèmes liés au fichier .htaccess de PrestaShop
- Timeout lors de l’installation de PrestaShop
- Erreur lors de l’installation du thème par défaut de PrestaShop
- Compatibilité entre PrestaShop et les modules Apache
- Erreur "Settings file not found" dans PrestaShop
- Problèmes de configuration de la langue dans PrestaShop
- Erreur "Zip module not enabled" dans PrestaShop
- Problèmes de configuration SSL pour PrestaShop
- Erreur "Cannot write settings file" dans PrestaShop
- Compatibilité entre PrestaShop et les navigateurs
- Erreur "Invalid shop URL" dans PrestaShop
- Problèmes de configuration des paramètres régionaux de PrestaShop
Erreur HTTP 500 lors de l’installation de PrestaShop
L’erreur HTTP 500 est l’un des problèmes fréquents lors de l’installation de PrestaShop. Elle est souvent causée par un mauvais paramétrage PHP, des fichiers corrompus ou un problème de serveur web. Pour identifier la cause, activez le mode debug en modifiant le fichier config/defines.inc.php et en définissant define('_PS_MODE_DEV_', true);.
Si l'erreur persiste, vérifiez que toutes les extensions PHP obligatoires sont activées. Certaines comme PDO_MySQL ou cURL sont essentielles au bon fonctionnement de PrestaShop. Consultez les logs du serveur pour trouver des erreurs spécifiques et appliquer les correctifs nécessaires.
Problèmes de permissions des fichiers et dossiers dans PrestaShop
Si PrestaShop ne s’installe pas, cela peut être dû à des permissions incorrectes sur les fichiers et dossiers. Par défaut, les fichiers doivent avoir la permission 644 et les dossiers 755. Assurez-vous que les répertoires essentiels (/config, /cache, /log, /img, /mails, /modules) sont accessibles en écriture.
Vous pouvez modifier les permissions via FTP ou en utilisant la ligne de commande avec chmod -R 755 dossier/. Un autre problème courant est l’absence des droits d’exécution pour l’utilisateur du serveur web, ce qui bloque la modification des fichiers PrestaShop.
Compatibilité PHP avec PrestaShop
PrestaShop requiert une version PHP spécifique pour fonctionner. Si la version PHP est trop récente ou trop ancienne, l’installation peut échouer. Vérifiez la compatibilité PHP dans la documentation officielle de PrestaShop et ajustez votre configuration en conséquence.
Certaines fonctions PHP obsolètes peuvent être désactivées sur certains hébergements. Pour vérifier votre version de PHP, utilisez la commande php -v ou créez un fichier phpinfo.php. Une mise à jour ou un downgrade de PHP peut être nécessaire en fonction de votre version actuelle.
Extensions PHP manquantes pour PrestaShop
Si certaines extensions PHP ne sont pas activées, PrestaShop peut rencontrer des erreurs lors de son installation. Les extensions couramment requises incluent PDO_MySQL, GD, OpenSSL, Intl, Zip et cURL. Pour vérifier celles qui sont activées, utilisez un fichier phpinfo.php ou exécutez la commande php -m.
Si une extension manque, installez-la via votre hébergeur ou en utilisant une commande comme sudo apt install php-intl pour les serveurs sous Linux. Ensuite, redémarrez Apache ou Nginx pour appliquer les modifications.
Limite de mémoire insuffisante pour PrestaShop
Un manque de mémoire PHP peut provoquer des erreurs lors de l’installation de PrestaShop. Par défaut, la mémoire est souvent limitée à 128M, ce qui peut être insuffisant. Augmentez cette valeur à 256M ou 512M en modifiant le fichier php.ini (memory_limit = 512M).
Une autre solution est d’ajouter cette ligne dans .htaccess : php_value memory_limit 512M. Si le problème persiste, consultez votre hébergeur pour voir s’il existe une restriction sur l’allocation mémoire.
Erreur de connexion à la base de données PrestaShop
Si PrestaShop ne parvient pas à se connecter à la base de données, vérifiez que les informations de connexion (hôte, utilisateur, mot de passe, nom de la base) sont correctes. Utilisez phpMyAdmin ou un outil en ligne de commande pour tester la connexion.
Un autre problème peut être dû à un mot de passe utilisateur incorrect ou à un port MySQL mal configuré. Pour les hébergements mutualisés, remplacez localhost par l’adresse fournie par l’hébergeur.
Problèmes de configuration du serveur pour PrestaShop
Si l’installation bloque, vérifiez que votre serveur web (Apache, Nginx) est correctement configuré. Assurez-vous que mod_rewrite est activé pour Apache (a2enmod rewrite && systemctl restart apache2). Pour Nginx, ajoutez une règle de réécriture des URL dans le fichier de configuration.
Un pare-feu ou un module de sécurité peut aussi bloquer certaines requêtes. Désactivez temporairement ModSecurity ou d’autres restrictions pour tester l’installation de PrestaShop.
Erreur 404 après l’installation de PrestaShop
Si vous obtenez une erreur 404 après l’installation, il est possible que la réécriture d’URL ne soit pas activée. Vérifiez le fichier .htaccess et activez mod_rewrite sur Apache.
Une autre cause peut être un problème de cache. Videz le cache de votre navigateur et supprimez le cache PrestaShop situé dans /var/cache/prod.
Problèmes liés au fichier .htaccess de PrestaShop
Un fichier .htaccess mal configuré peut empêcher PrestaShop de fonctionner correctement. Supprimez le fichier et régénérez-le en allant dans Paramètres > SEO & URLs > Réécrire le fichier .htaccess.
Si le fichier n’est pas recréé, assurez-vous que Apache autorise la réécriture d’URL en activant AllowOverride All dans le fichier de configuration du serveur.
Timeout lors de l’installation de PrestaShop
Un timeout peut se produire si le temps d’exécution PHP est trop court. Augmentez max_execution_time à 300 secondes dans php.ini (max_execution_time = 300).
Un hébergement trop lent peut aussi provoquer cette erreur. Essayez l’installation sur un serveur local avant de transférer votre boutique sur un hébergement plus performant.
Erreur lors de l’installation du thème par défaut de PrestaShop
Si le thème par défaut ne s’installe pas, cela peut être dû à un problème de droits sur les dossiers. Vérifiez que le dossier /themes/ a bien les permissions en écriture (chmod 755).
Un autre problème peut venir d’un fichier CSS ou JS corrompu. Essayez de supprimer le cache (/var/cache/) et réinstallez le thème.
Compatibilité entre PrestaShop et les modules Apache
Certains modules Apache comme mod_security ou mod_evasive peuvent bloquer certaines fonctionnalités de PrestaShop. Désactivez-les temporairement et essayez de relancer l’installation.
Si PrestaShop ne charge pas les pages correctement, vérifiez que mod_rewrite est activé et bien configuré pour permettre les réécritures d’URL.
Erreur "Settings file not found" dans PrestaShop
Si vous obtenez l’erreur "Settings file not found", vérifiez que le fichier settings.inc.php est bien présent dans /config. S’il est absent, recréez-le avec les informations de connexion à la base de données.
Dans certains cas, une installation incomplète peut être la cause. Essayez de réinstaller PrestaShop en supprimant tous les fichiers avant une nouvelle tentative propre.
Problèmes de configuration de la langue dans PrestaShop
Lors de l’installation de PrestaShop, la langue sélectionnée peut ne pas être correctement appliquée. Cela peut être dû à un module de traduction non activé ou à un problème de permissions sur les fichiers de langue. Vérifiez dans International > Traductions que toutes les traductions sont bien installées.
Si certaines chaînes de texte apparaissent en anglais, essayez de réinitialiser la langue par défaut et d’importer les traductions manuellement depuis le back-office. Une mise à jour de PrestaShop peut parfois corriger ce problème.
Erreur "Zip module not enabled" dans PrestaShop
L'erreur "Zip module not enabled" apparaît lorsque l'extension PHP Zip est manquante, empêchant l'installation des thèmes et modules. Vérifiez si l’extension est activée en exécutant php -m | grep zip.
Si l’extension est absente, installez-la avec la commande sudo apt install php-zip, puis redémarrez Apache ou Nginx. Pour les hébergements mutualisés, contactez votre hébergeur pour demander son activation.
Problèmes de configuration SSL pour PrestaShop
Si PrestaShop ne fonctionne pas en HTTPS, vérifiez que le certificat SSL est bien installé et activé dans Paramètres > Général > Activer SSL.
Une autre cause fréquente est un contenu mixte (HTTP/HTTPS). Pour éviter cela, activez l’option Forcer SSL sur toutes les pages et vérifiez que toutes les ressources (images, scripts) utilisent bien des liens HTTPS.
Erreur "Cannot write settings file" dans PrestaShop
Si le fichier settings.inc.php ne peut pas être écrit, cela signifie que les permissions du dossier /config sont incorrectes. Utilisez chmod 755 /config pour corriger les permissions.
Dans certains cas, le serveur bloque l’écriture dans les fichiers système pour des raisons de sécurité. Testez sur un autre hébergement ou contactez le support de votre hébergeur pour vérifier les restrictions en place.
Compatibilité entre PrestaShop et les navigateurs
Certains navigateurs obsolètes ou ayant des extensions de blocage peuvent empêcher PrestaShop de fonctionner correctement. Si des boutons ou champs ne s'affichent pas, testez avec un autre navigateur récent (Chrome, Firefox, Edge).
Les cookies et le cache du navigateur peuvent aussi causer des erreurs. Supprimez les données de navigation, désactivez les extensions de blocage, puis rechargez la page.
Erreur "Invalid shop URL" dans PrestaShop
Cette erreur signifie que l’URL de la boutique définie dans la base de données ne correspond pas à l’URL actuelle du site. Accédez à phpMyAdmin, ouvrez la table ps_shop_url et mettez à jour le champ domain avec la bonne adresse.
Si vous avez activé le mode multiboutique, assurez-vous que chaque boutique possède une URL valide et correspond bien au domaine configuré dans le serveur.
Problèmes de configuration des paramètres régionaux de PrestaShop
Si les devises, formats de date ou unités de mesure sont incorrects après l’installation, vérifiez dans International > Localisation que le bon pays et la bonne langue sont sélectionnés.
Dans certains cas, il peut être nécessaire d’importer manuellement les paramètres régionaux via le menu Importation des packs de localisation. Cela permet d’appliquer les formats corrects pour chaque pays.