Installer Prestashop en local

Le but d’installer Prestashop en local ?

• Installer la boutique
• la configurer
• personnaliser le thème
• installer les extensions
• expérimenter
• tout mettre en place dans un environnement fermé (votre ordinateur).

De cette manière, pas besoin de se poser des questions sur d’éventuels visiteurs ou de référencement par les moteurs de recherche. Les modifications se font en local, plus rapidement et plus aisément, sans passer par un serveur FTP.

Pour pouvoir installer Prestashop en local, il faudra commencer par disposer :

• D’un serveur web type Apache, Nginx, IIS, etc.
• D’un serveur de base de données, par exemple MySQL ou PostgreSQL
• D’une distribution de PHP à installer par là-dessus

Vous êtes découragés ? C’est bien plus simple qu’il n’y paraît. Il existe des outils qui s’occupent de mettre en place toute cette infrastructure.

Voici quelques options :

• WAMPServer pour Windows Apache MySQL PHP Server : installe Apache, MySQL et PHP donc et ne fonctionne que sous Windows. Il a l’avantage d’être en français, mais n’est pas très user-friendly et plutôt laborieux à mettre en place.
• LAMP pour Linux Apache Mysql PHP (ne me dites pas que vous aviez deviné ?) qui fait la même chose sur la plupart des distributions Linux
• MAMP pour… vous avez deviné ? Macintosh Apache MySQL PHP (ou Perl ou Python ou même Ruby mais ça colle moins). Sauf que ce dernier fonctionne aussi sur Windows, qu’il est facile à installer et à utiliser et qu’il a clairement ma préférence !

MAMP a ma préférence et c’est ce dernier outil que je vais vous aider à installer pour commencer.

À noter qu’il existe une version PRO qui permet notamment des migrations facilités de WordPress entre votre poste local et l’hébergeur, l’enregistrement de snapshot de votre environnement (fichiers et données)…

MAMP

INSTALLATION

Pour commencer rendez-vous ici pour télécharger MAMP pour MacOS ou Windows.

Exécutez l’installateur et commencez par désactiver MAMP Pro et l’installation d’Apple Bonjour qui ne vous seront pas utiles.

Ensuite exécutez l’installation normalement, tout devrait se faire sans heurt.

CONFIGURATION

Une fois l’installation terminée, lancez MAMP, il démarrera les serveurs Apache (par défaut) et MySQL au démarrage. Ne faites pas attention à l’option Cloud.

Allez dans le menu MAMP > Preferences, vous y trouverez 6 onglets :

• Start / Stop : Vous permettra de définir plusieurs options liées au démarrage des services. Faut-il démarrer les services au démarrage de MAMP ? Et les fermer à la fermeture ? Ouvrir MAMP ou démarrage de Windows ou MacOS ? Etc.
• Ports : Où vous pourrez définir des ports spécifiques pour les différents serveurs de MAMP, à savoir Apache ou Nginx et MySQL
• PHP : Qui vous permettra de choisir entre deux distributions de PHP, je reviendrai sur ce sujet dans le chapitre suivant, la version de PHP est très importante pour le bon fonctionnement de Prestashop
• Web Server : J’y reviens plus bas
• MySQL : Affiche la version actuelle de MySQL
• Cloud : Pas utilisé dans notre cas. Permets d’enregistrer une base de données sur Dropbox pour la partager, entre autres

Onglet Web Server : Dans cet onglet vous pourrez choisir le WebServer à utiliser (Apache par défaut, mais si vous préférez Nginx c’est à vous de voir), mais surtout de spécifier le dossier racine de MAMP.

C’est-à-dire le dossier sur lequel pointera l’adresse http://localhost. C’est à cet endroit ou dans l’un de ses sous-dossiers que nous installerons Prestashop.

Ici j’ai choisi D:\Dev\Web, et Prestashop sera installé dans D:\Dev\Web\tuts\shop ce qui donnera l’adresse http://localhost/tuts/shop

Une fois le réglage effectué, vous pouvez appliquer les modifications et fermer la fenêtre. MAMP est installé et configuré !

RENDRE MAMP COMPATIBLE AVEC PRESTASHOP

La version de PHP par défaut livrée avec MAMP était la version 7.2.

Si vous allez jeter un œil aux prérequis de Prestashop, plus précisément à quelle version de Prestashop est compatible avec quelle version de PHP, vous verrez peut-être que la version de Prestashop actuel n’est pas compatible avec la version de PHP utilisée par MAMP.

En allant dans les préférences de MAMP, sous l’onglet PHP, il y a des chances que vous voyez des versions de PHP 7.3, 7.4 ou même 8.0 et que même en choisissant la plus ancienne, elle ne soit pas compatible avec votre version de Prestashop.

Mais pas de panique, MAMP est livré avec plusieurs versions de PHP, en général une quinzaine, de la version 5.3 à la version 7.4.

Alors pourquoi est-ce que vous ne pouvez pas choisir une autre de ces versions plutôt que les deux plus récentes qui ne sont pas compatibles avec Prestashop 1.7 ?

Il s’agit simplement d’une limitation de la version gratuite de MAMP.

MAMP Pro lui, vous permet de travailler avec n’importe quelle version de PHP si vous le souhaitez. Et comme à l’installation de MAMP, les données de MAMP Pro sont aussi installées, vous vous retrouvez avec un tas de versions de PHP que vous n’allez pas utiliser.

Alors, comment faire pour forcer MAMP en version gratuite à proposer les bonnes versions de PHP ? Rien de bien compliqué en fait.

Si vous êtes sous Windows, allez dans le dossier PHP d’installation de MAMP, par défaut sous :

C:\MAMP\bin\php

Sous Mac, vous trouverez ça dans :

/Applications/MAMP/bin/php

Et là, on voit apparaître toutes les versions de PHP disponibles. Par défaut, MAMP ne vous affiche que les 2 plus récentes.

Avant d’appliquer des modifications, commencez par fermer MAMP.

S’il est ouvert, il est possible que le processus de MAMP ait chargé une de ces versions de PHP et vous ne puissiez pas faire les modifications nécessaires sur les dossiers.

Maintenant, quelle version souhaitez-vous utiliser ? Il vous suffit de renommer, en ajoutant un underscore en début de dossier par exemple, les dossiers des versions récentes de Prestashop.

MAMP par défaut va regarder dans ce dossier, et afficher les 2 versions les plus récentes de PHP qu’il aura trouvé.

En renommant les plus récentes, il ne trouvera que des versions plus anciennes. Donc en renommant les versions 7.3 et 7.4 pour travailler avec la version 7.2 :

Et en relançant MAMP et en se rendant dans Préférences > PHP :

Tadaaa !

Vous pouvez désormais choisir une version plus ancienne de PHP dans les préférences, il ne vous reste plus qu’à enregistrer et redémarrer les serveurs de MAMP pour terminer la configuration.

Prestashop 1.7

DÉCOMPRESSION / INSTALLATION

Maintenant, attaquons-nous au plat de résistance, vous verrez, ce n’est rien de très compliqué !

Commencez par vous rendre sur la page de téléchargement de Prestashop. Là entrez votre adresse e-mail si vous désirez recevoir la newsletter, acceptez les conditions et cliquez sur Télécharger.

Une fois le fichier téléchargé (un fichier ZIP d’un peu moins de 70 Mo en règle générale) décompressez-le dans le dossier où vous désirez installer Prestashop.

Pour moi ce dossier sera :

D:\Dev\Web\tuts\shop

Qui deviendra donc dans le navigateur, avec MAMP et Apache activé :

http://localhost/tuts/shop

En vous rendant à cette adresse, Prestashop lance automatiquement l’installation. En fait, il va décompresser le fichier prestashop.zip, créer tous les dossiers, fichiers et sous-dossiers qui composent le CMS.

ASSISTANT D’INSTALLATION

Choix de la langue

Une fois l’installation terminée, vous accéderez à l’assistant de Prestashop qui vous guidera dans le processus. La première vue vous proposera de choisir la langue de l’application.

Acceptation des licences

La deuxième vue vous demandera d’accepter les conditions de la licence de Prestashop. Il s’agit d’une licence Open Source pour un CMS gratuit, peut de chance que vous vous fassiez avoir donc 😉

Comptabilité système

La troisième vue corse un peu l’affaire, il s’agit d’une analyse de compatibilité (version de PHP, extensions installées, configuration) de votre environnement (ici MAMP) avec la versions actuelle de Prestashop (ici la 1.7.5.2).

Il y a de grandes chances que vous ayez quelques avertissements et erreurs, voici ce que j’ai eu dans mon cas :

Voici donc la série d’erreurs que j’ai reçue, à noter que certains avertissements sont liés aux erreurs :

• L’extension Fileinfo n’est pas activée : cette extension permet d’interagir avec le système de fichier de votre ordinateur
• Intl extension is not loaded / L’extension Intl n’est pas activée : cette extension s’occupe de l’internationalisation et de la localisation en PHP (le multilingue en gros)

En dessous quelques avertissements liés à la mise en cache notamment.

Pour régler ces problèmes, il faut se rendre dans le fichier de configuration de votre version de PHP (celle utilisée par MAMP) dans les dossiers d’installation de MAMP.

Pour connaître la version de PHP, ouvrez MAMP > Preferences > PHP et regardez le numéro de version dans Standard Version.

Sous Cache il est possible d’activer une option de mise en cache, mais je préfère faire la configuration manuellement pour Prestashop.

Une fois que vous avez la version, ici 7.2.10, rendez-vous dans le dossier d’installation de MAMP, dans le dossier de configuration :

C:\MAMP\conf\php7.2.10

En prenant soin de choisir le dossier de votre version de PHP. Dans ce dossier doit se trouver un fichier php.ini. Ouvrez-le avec un éditeur de texte et recherchez le texte Dynamic Extensions.

Juste en dessous, vous devriez trouver l’activation des différentes extensions. Ajoutez ou enlevez le commentaire des extensions suivantes :

On active donc les extensions fileinfo et intl, puis les différentes extensions liées au cache.

Pour corriger les autres avertissements, remontez un peu le fichier et recherchez le texte short_open_tag. La première occurrence devrait être dans un descriptif en commentaire, mais plus bas vous devriez pouvoir modifier le paramètre de on en off :

Lorsque cette option est on, il est possible de commencer du code PHP par <? sans s’embarrasser du <?php. Chose que refuse Prestashop, pour des raisons de sécurité.

Dernière chose demandée par Prestashop, augmenter la valeur de realpath_cache_size que vous devriez trouver un peu plus bas dans le fichier.

Commencez par enlever le ; et passez la valeur de 16k à 5M :

Cette option peut améliorer les performances de Prestashop de manière significative sous Windows.

Dernière opération qui ne sera peut-être pas obligatoire pour tout le monde, mais qui a été nécessaire dans mon cas. Il faut copier les fichiers suivants :

• icudt60.dll
• icuin60.dll
• icuio60.dll
• icuuc60.dll

Que vous trouverez dans votre installation de MAMP sous (attention, ce dossier dépend de votre version de PHP) :

C:\MAMP\bin\php\php7.2.10

Dans le dossier d’Apache :

C:\MAMP\bin\apache\bin

Ces fichiers sont nécessaires au bon fonctionnement de l’extension, mais il arrive que Apache ne parvienne pas à y accéder. En les copiant dans le dossier d’installation d’Apache ça règle le problème.

Une fois ces modifications réalisées, cliquez sur Stop Servers puis Start Servers dans MAMP pour redémarrer tout ça et recharger les fichiers de configuration.

Et là, quel bonheur de se rendre à nouveau sur la page de diagnostic de Prestashop et de cliquer une nouvelle fois sur Rafraîchir pour voir disparaître les erreurs.

Il ne me reste qu’un avertissement, quant à la version de l’extension intl, mais c’est un détail.

Note : Si ce n’est pas le cas lors de cotre installation, n’hésitez pas à me laisser un commentaire avec le message que vous recevez, j’essaierai de vous aider.

Informations

Une fois que vous avez fait suivant, vous accéderez à la page vous permettant d’entrer les informations générales de votre boutique.

Voici les différents champs à remplir :

• Nom de la boutique : Ce nom sera le titre de votre site et apparaîtra sur toutes vos pages.
• Activité principale : Vous pouvez choisir une activité spécifique pour aider l’assistant Prestashop lors de la configuration initiale. Pas très important.
• Pays : Ce choix définira pas mal de paramètres dans l’application : fuseau horaire, monnaie utilisée, codes ISO, TVA, etc.
• Prénom / Nom : Seront utilisés pour votre compte utilisateur
• Adresse e-mail : Idem et sera surtout votre identifiant pour accéder à l’interface d’administration
• Mot de passe / confirmation : Mot de passe pour accéder au back-office de Prestashop, lié à votre e-mail

Une fois ces informations renseignées vous pourrez continuer.

Configuration du système

Dans la fenêtre suivante, il faudra entrer les informations de connexion à la base de données. Avant de remplir ces infos, il faut donc commencer par créer un utilisateur qui pourra accéder à votre base Prestashop et aussi, éventuellement, la créer, cette base !

Pour faire les choses bien on va éviter l’utilisateur root sans mot de passe, même s’il est disponible par défaut dans les installations locales de MAMP.

Rendez-vous à l’adresse (attention à bien respecter les majuscules) :

http://localhost/phpMyAdmin

Pour accéder à l’interface de PHPMyAdmin qui vous permettra de gérer vos bases de données.

Si comme moi vous avez utilisé cet outil au début des années 2000 pour de la création web, sachez que visuellement et techniquement, ça n’a pas changé. Bref, c’est toujours aussi moche 🙂

Première étape, nous allons donc créer un utilisateur disposant de tous les privilèges. Pour se faire allez dans l’onglet User accounts et cliquez sur Add user account en dessous de la liste d’utilisateurs (vous en aurez moins que moi, ne vous en faites pas, ce n’est pas un problème) :

Dans la nouvelle fenêtre, il vous faudra renseigner quelques informations importantes sur votre nouveau compte utilisateur :

• User name : Nom de votre utilisateur, il sera utilisé lors de la connexion à la base de données de Prestashop
• Host name : Je vous conseille de choisir Local dans la liste pour bien définir que l’utilisateur est spécifique à localhost.
• Password : Mot de passe que vous utiliserez pour vous connecter à la base.
• Global privileges > Check all : Ne vous embêtez pas, donnez tous les droits à votre utilisateur pour éviter le moindre problème à l’installation ou à la gestion de votre boutique.

Ensuite, tout en bas à droite, cliquez sur le bouton Go pour exécuter la requête.

Votre utilisateur créé, il vous reste encore à ajouter la base de données qui sera utilisée par votre boutique. Pour se faire, cliquez sur Add New dans le menu de gauche.

Puis entrez le nom de la base que vous désirez créer, dans mon cas demo_shop, laissez le menu déroulant sur Collation pour prendre celle par défaut (normalement UTF8) et faites Create.

Revenons à l’assistant d’installation de Prestashop, c’est le moment d’entrer les informations de connexion à la base de données. Entrez simplement les infos telles que vous les avez saisis juste au-dessus.

Vous pouvez laisser 127.0.0.1 comme adresse de base, il s’agit en vérité de l’adresse IP de localhost. Quant au préfixe des tables, vous pouvez le laisser également, il s’agit du texte qui sera ajouté en préfixe du nom de chaque table dans votre base de données.

Testez la connexion à la base de données pour vous assurer que ça fonctionne. Et cliquez sur suivant pour valider vos réglages.

Installation de la boutique

Dernière étape qui prendra un peu de temps : l’installation finale de Prestashop. Enregistrement de vos réglages, création des tables, données de bases, traductions, etc.

Une fois l’installation terminée, Prestashop vous rappelle de bien conserver vos infos de connexion, vous pouvez les imprimer et afficher le mot de passe en clair au besoin.

Erreur à l’installation

Il est possible que durant l’installation, Prestashop plante et vous affiche une erreur arbitraire, par exemple :

Unable to write into « fr-FR » » (data layer : « PrestaShop\PrestaShop\Core\Data\Layer\AbstractDataLayer »)

Ou encore :

Create default shop and languages
An error occurred during installation…

Merci à mes commentaires sur YouTube qui me permettent de vous donner ces exemples ! J’en ai déjà eu de ceux-là, ainsi que d’autres variations, ma solution ?

Relancez l’installation. Il m’est arrivé ça plusieurs fois et à chaque fois, le fait de revenir dans l’assistant et relancer le processus d’installation a réglé mon problème.

CONFIGURATION INITIALE DE PRESTASHOP

Une fois l’installation terminée, rendez-vous à l’adresse de votre shop, pour moi http://localhost/tuts/shop pour voir votre boutique.

Prestashop installe des données de démo par défaut, pour vous permettre de bien comprendre le fonctionnement et de vous familiariser avec le système. Je vous montrerai plus loin comment virer tout ça !

Accéder au back-office

Pour le moment, accédez à votre console d’administration qui devrait se trouver à la même adresse que votre shop, en ajoutant /admin à la fin. Dans mon cas : http://localhost/tuts/shop/admin

Un avertissement concernant le dossier install s’affiche. Rendez-vous dans le dossier de votre installation de Prestashop, dans mon cas :

D:\Dev\Web\tuts\shop

Et supprimez le dossier install qui s’y trouve. Il s’agit d’une sécurité, si quelqu’un accède au dossier install il peut potentiellement relancer l’assistant et mettre un beau bordel !

Une fois cela fait, actualisez la page admin et vous remarquerez alors, si vous jetez un œil à l’adresse de la page, que votre adresse s’est transformée de /admin en /admin123xyz ou quelque chose dans ce goût-là.

Prestashop renomme le dossier admin à l’aide d’une valeur aléatoire pour éviter que n’importe qui puisse y accéder pour tenter d’entrer dans votre back-office.

Une fois dans votre back-office, vous pouvez suivre l’assistant qui vous guide dans une partie de la configuration. Pour le moment vous pouvez l’ignorer, mais vous pourrez le lancer quand vous voulez en bas à gauche de cette vue.

Supprimer les données de démo

Vous le ferez peut-être plus tard, après avoir joué un peu avec le CMS pour en apprendre les rudiments, mais il vous faudra à un moment ou à un autre nettoyer les données de démos déjà présentes.

Un module existe spécifiquement pour cette tâche. Pour l’installer rendez-vous dans dans Personnaliser > Modules > Catalogue de modules. Là dans la barre de recherche tapez cleaner et faites Rechercher.

Une fois Prestashop Cleaner trouvé, cliquez sur Installer. Après l’installation, le bouton change pour devenir Configurer. Cliquez dessus.

Dans la configuration du module, passez l’option à Oui dans la partie Catalogue pour valider votre suppression et cliquez sur Supprimer le catalogue.

Faites de même dans l’onglet Commandes et clients.

Les données de démo ont disparu !

Passez en mode debug

Pour faciliter le travail dans Prestashop (configuration, personnalisation, modification des modèles, des CSS, etc.) je vous conseille tant que votre boutique n’est pas en production de la passer en mode debug.

Pour se faire, rendez-vous dans Configurer > Paramètres avancés > Performances.

Voici les réglages que je vous conseille :

• Smarty > Compilation des templates : Passez-le en Force compilation, de cette manière toute modification réalisée dans un modèle de votre thème sera recompilée à chaque fois que vous actualisez une page. Utile pour voir vos modifications en direct.
• Smarty > Cache : Désactivez le cache, pour éviter que vos feuilles de styles ou scripts ne se mettent pas à jour lors de modifications.
• Mode debug > Mode debug : Oui ! Activez ce mode debug. Prestashop sera plus lent, mais en cas d’erreur quelconque au niveau du serveur, vous aurez un détail du problème au lieu d’une bête erreur 500.

En plus de relever les erreurs, le mode debug activera une barre de contrôle en bas de votre back-office, vous informant de tous les erreurs et avertissements, ainsi que de bien d’autres informations utiles (performances, traductions manquantes, etc.).

Attention : Avant de passer votre boutique en production sur un hébergement, effectuez vos tests en désactivant le mode debug, pour vous assurer que tout fonctionnera bien en live.