Installer Drush avec Composer

Voir la documentation : https://www.vincentliefooghe.net/content/installer-drush-avec-composer

Important :

Quelques remarques.

• Élément de la liste à puces

Modifier utilisateur:groupe de .composer si root:root vers ajlsm:ajlsm

• Ajouter le PATH dans /home/ajlsm/.baschrc

# drush
drush=/home/ajlsm/.composer/vendor/bin
PATH=$drush:$PATH
export PATH

• Lancer la commande source .bashrc

Commandes importantes :

drush cache:rebuild

Vider entièrement le cache de Drupal

drush cc

Sélectionner une partie de l'installation pour vider les caches.

Copie de la documentation de V. Liefooghe

Depuis quelques temps déjà, Drush (DRUpal SHell) est disponible sur GitHub, et non plus sur http://drupal.org.

L'installation peut se faire via git ou via Composer. C'est cette méthode qui est nécessaire pour l'installation avec Drupal 8.

Installation des pré-requis sur la machine

Ces paquets sont utilisés pour récupérer les données via http et git. unzip est utilisé avec drush make pour dézipper certains fichiers.

apt-get install curl git unzip

Installation de Composer

L'installation de Composer est faite en global (pour tous les utilisateurs).

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Installer Drush pour l'utilisateur courant

composer global require drush/drush:dev-master
ls -a .composer/vendor/bin
.  ..  boris  drush  drush.bat	drush.complete.sh  drush.php

Drush est installé dans le répertoire .composer/vendor/bin de l'utilisateur. Il faut ensuite ajouter ces lignes dans le .bashrc :

export PATH=$HOME/.composer/vendor/bin:$PATH

Installer Drush pour tous les utilisateurs

Si plusieurs utilisateurs ont accès à la machine, il est préférable d'avoir une installation globale :

git clone https://github.com/drush-ops/drush.git /usr/local/src/drush
cd /usr/local/src/drush
git checkout 
ln -s /usr/local/src/drush/drush /usr/bin/drush
composer install
drush --version
which drush

Installer drush pour ce projet seulement

Il peut être bon de livrer le projet avec son propre drush

composer require drush/drush

Vous pourrez ensuite utilisez drush avec

./vendor/drush

Lancer Drush lorsqu'il y a plusieurs sites

Quand un projet Drupal comporte plusieurs sites, la commande :

$ drush ws

Renvoie l'erreur suivante :

Command ws was not found. Drush was unable to query the database. As a result, many commands are unavailable. Re-run your command with --debug to see relevant log messages

Solutions :

1. Utiliser des alias pour les sites. Voir ici : https://www.drush.org/11.5.1/site-aliases/
2. Renseignez l'URI du site pour que Drush se connecte à la base de données.

Renseigner l'URI

(https://www.drush.org/11.5.1/usage/#using-the-uri-option-and-root-options)

Par exemple, le Drupal ad53 fait fonctionner plusieurs sites :

• Drupal/web/sites/archives.lamayenne.fr
• Drupal/web/sites/salle-de-lecture-archives.lamayenne.fr
• ...

Pour travailler avec la base de données du site : archives.lamayenne.fr, renseignez l'URI avec le paramètre --uri= du site concerné + la commande que vous souhaitez envoyer.

Par exemple, pour reconstruire les caches :

$ drush --uri=https://archives.lamayenne.fr cr