Skip to Content

module Drupal : Drush : part 1 : comment l'installer et l'utiliser

Drush n'est pas un module Drupal, mais plutôt un outil système (shell UNIX) qui vous permettra d'administrer un site Drupal directement en ligne de commande via SSH et votre console préférée. C'est donc un outil pour les développeurs avertis ayant un minimum de connaissances dans les commandes Linux.

C'est surtout une arme formidable pour qui passe son temps à installer des sites Drupal, à tester des modules, à faire des backups, etc... Drush permet de gagner un temps considérable pour le développeur qui passe ses journées à administrer du Drupal.

Drush is a command line shell and Unix scripting interface for Drupal, a veritable Swiss Army knife designed to make life easier for those of us who spend some of our working hours hacking away at the command prompt.

Je vais tenter de vous donner quelques billes sur l'installation de Drush, qui n'est pas si simple à faire et qui dépend grandement de la technologie serveur de votre hébergement.
Je vous conseille vivement d'explorer la documentation et les différentes ressources en bas de page avant de commencer vos expérimentations.

Les étapes qui suivent montre l'installation de Drush sur mon serveur dédié chez OVH. Il tourne sous une "release 2" OVH qui est basée sur la distribution Gentoo.
Je me connecte en root (je sais, c'est pas bien, dirons les Linuxiens) avec Putty (Windows).

Installation :

La première chose à faire est de récupérer le "module" Drush et le déposer sur votre serveur : http://drupal.org/project/drush. En théorie, il est possible de le déposer où l'on veut, pour peut que l'on dise à Drush où se trouve les exécutables php (s'il les trouve pas lui-même).
Tout dépend de votre distribution .. voici une portion de mon arborescence servveur :

drush-01

En ce qui me conserne, je l'ai d'abord uploadé en ftp dans /home/gazwal (répertoire du user "gazwal").
Je l'ai finalement placé ensuite dans /usr/local en faisant :

mv /home/gazwal/drush /usr/local/

drush-02

Il faut ensuite modifier les permissions du répertoire "drush" et créer un alias afin de faciliter l'utilisation de la commande "drush" :

For Linux/Unix/Mac:
1. Untar the tarball into a folder outside of your web site (/path/to/drush)
2. Make the 'drush' command executable:
$ chmod u+x /path/to/drush/drush
3. (Optional, but recommended:) To ease the use of drush,
- create a link to drush in a directory that is in your $PATH, e.g.:
$ ln -s /path/to/drush/drush /usr/bin/drush
OR
- create an alias to drush:
$ alias drush='/path/to/drush/drush'
(this goes into .profile or .bash_aliases in your home folder)

=> voir le readme.txt de drush : .../modules/drush/README.txt

Vous pouvez tenter désormais de lancer la commande drush

4. Start using drush by running "drush" from your Drupal root directory.
(or, if you did not follow step 3, by running "/path/to/drush/drush"
or navigating to /path/to/drush and running "./drush" )
If you have troubles, try using the -l and -r parameters when invoking drush.

Si tou va bien :-) la commande drush affiche la liste des commandes disponibles :

drush-04-commande

Cela n'a pas fonctionné du premier coup pour moi car drush détectait QUE la version PHP4 disponible sur mon serveur. Il a donc fallu lui indiquer le chemin vers PHP5.

Pour ce faire, j'ai rajouté l'alias suivant dans le fichier .bash_profile du répertoire /root :

        alias drush='/usr/local/bin/php5 /usr/local/drush/drush.php'
      

drush-05

(tout ceci est très spécifique à la release 2 OVH ...)

Faire joujou avec Drush :

Bref, une fois ces petits soucis réglés, let's go playing with DRUSH.

Pour faire joujou, il suffit de se placer dans le répertoire racine d'un de vos sites Drupal et d'utiliser les commandes de bases (dans un premier temps) : http://drupal.org/node/477684

Par exemple, dans le screen ci-dessous, je me place dans le répertoire /sites/all/themes et je télécharge en 2 secondes le thème ZEN :

drush-03-zen

Cool, non ? c'était une petite introduction au "module" Drush.

Ressources Web :

Vidéos (En) :

Drush 2.0 released - Screencast 1: Installing Drush and getting started : une vidéo de Owen Barton (CivicAction)

Drush screencast tutorial 2: Using the drush dl and info commands : une vidéo de Owen Barton (CivicAction)

4
Average: 4 (2 votes)
Your rating: Aucun