5.1. Téléchargement et installation de Drupal Commerce.

Avant tout, pour installer Drupal Commerce, nous aurons besoin de Composer :

https://getcomposer.org/download/

Composer est un gestionnaire de dépendances pour PHP. Il permet d’installer les bibliothèques PHP nécessaires, c’est-à-dire de télécharger et d’ajouter des bibliothèques à l’autochargement de votre projet, dans notre cas, un site Drupal 8. Drupal 8 intègre déjà de nombreuses bibliothèques tierces, notamment issues du framework Symfony.

Composer s’installe généralement sans problème, mais n’oubliez pas d’activer Open Server ou un autre serveur web local avant l’installation. Pendant l’installation de Composer, cliquez simplement sur « Suivant » et il s’installera automatiquement.

Une fois installé, tapez dans la console :

composer --version

Vous devriez voir apparaître la version installée de Composer.

$ composer --version
Composer version 1.4.1 2017-03-10 09:29:45

Vous pouvez utiliser la console Windows (CMD) :

Ou bien la console intégrée à Open Server :

Un tutoriel séparé sur l’utilisation de la console sera publié. En attendant, une vidéo devrait suffire pour installer Drupal Commerce.

Après avoir installé Composer, il faut installer Drush. Drush est un outil en ligne de commande pour gérer Drupal. Il est très pratique pour télécharger et activer des modules. L’idéal est de télécharger les modules avec Composer et de les activer via Drush.

Pour installer Drush, exécutez la commande suivante :

composer global require drush/drush:8.*

Remplacez 8.* par 9.* ou toute autre version actuelle de Drush. Pour vérifier que Drush est bien installé, exécutez :

drush version

Par exemple, ma version actuelle est la 9.* :

$ drush version
 Drush version : 9.0-dev-g9ec6aa42

Si vous rencontrez des problèmes avec Drush ou Composer sous Windows, suivez ce guide pour configurer Drush avec Open Server :

12.1. Installation de Drush 8 sur Open Server.

Ensuite, il vous faut Drupal 8 pour commencer l’installation de Drupal Commerce. Si vous avez déjà un site Drupal 8 fonctionnel, vous pouvez passer directement à l’installation de Drupal Commerce.

Je télécharge généralement Drupal manuellement depuis drupal.org et je crée un nouveau site dans Open Server :

Vous pouvez aussi télécharger Drupal avec Composer, mais cela nécessite de modifier le Document Root dans les paramètres du domaine Open Server. Personnellement, je préfère la simplicité, donc j’installe Drupal manuellement depuis drupal.org.

Installez Drupal comme d’habitude. Vous pouvez aussi utiliser Drush pour une installation plus rapide :

drush si --db-url=mysql://root:password@127.0.0.1/drupal --account-name=admin --account-pass=admin --site-mail=admin@example.com --site-name="Drupal 8" --locale=fr --yes

Dans mon cas, sans mot de passe MySQL, la commande ressemble à ceci :

drush si --db-url=mysql://root@127.0.0.1/commerce --account-name=admin --account-pass=admin --site-mail=admin@example.com --site-name="Drupal 8 Commerce" --locale=fr --yes

Les paramètres définissent le nom d’utilisateur, mot de passe et email admin. Si la base de données « commerce » n’existe pas, Drush la créera, ou réinitialisera la base existante avec une installation propre de Drupal.

Installer Drupal via la console prend environ 3 minutes, contre 10 minutes via le navigateur, donc la console fait gagner beaucoup de temps.

Redémarrez Open Server et vérifiez que votre site Drupal 8 fonctionne :

Nous pouvons maintenant passer à l’installation de Drupal Commerce. L’installation se fera via Composer. Dans la console, accédez au répertoire de votre site et exécutez la commande suivante pour ajouter le dépôt Drupal :

composer config repositories.drupal composer https://packages.drupal.org/8

Puis installez Drupal Commerce :

composer require "drupal/commerce 2.x-dev"

Composer téléchargera automatiquement les modules nécessaires :

Et les bibliothèques PHP nécessaires :

Vous pouvez maintenant activer les modules Commerce suivants :

drush en commerce commerce_cart commerce_checkout commerce_order commerce_price commerce_product commerce_store address entity inline_entity_form

Si certains modules ne s’activent pas via Drush, activez-les depuis l’interface d’administration :