Club Drupal

h1. Quelques techniques Drush

{{important(drush n'est pas installé sur le compte assos mais seulement sur le sas)}}

h2. C'est quoi ?

Drush signifie _drupal shell_. C'est un utilitaire disponible sur nos installations afin d'administrer nos sites en ligne de commande.

Pour avoir la liste des commandes les plus simples, taper drush dans un terminal, ou consulter cette http://drupal.org/node/477684.

Pour effectuer une action, il faut au préalable se placer dans le dossier du site concerné, puis taper la commande drush.

h2. Quelques exemples simples

* activer le module ou le thème nommé projet : <code>drush en projet</code>

* désactiver le module ou le thème nommé projet <code>drush dis projet </code>

* lister les modules et les thèmes, leurs statuts (activé, désactivé, pas installé), et leurs versions <code>drush pml </code>

* désinstaller le module ou le thème nommé projet <code>drush pm-uninstall projet </code>

**Rappel :** désinstaller un projet = le désactiver + supprimer les tables de ce projet dans la base de données

* récupérer la valeur actuelle de la variable nommée ma_variable <code>drush vget ma_variable </code>

* modifier la valeur de _ma_variable_ en _nvelle_valeur_ <code>drush vset ma_variable nvelle_valeur </code>

NB : une variable est un champ de la table monsite_variables (dans la base de données).

On peut citer par exemple _theme_default_ le thème par défaut du site ou _admin_theme_ le thème de l'administration.

* vider tous les caches <code>drush cc all</code> 

h2. Quelques commandes plus compliquées

h3. Gérer les utilisateurs

h4. Savoir qui administre un site

**À partir de drupal 7**

Cette commande permet de chercher dans la base de données les utilisateurs qui ont le _rid_ numéro 3 (qui correspond au rôle d'administrateur (toujours) dans D7 à moins d'aller exprès dans la bdd le changer !)

<pre>

<code>

drush sqlq  "SELECT name, mail FROM nomdusite_users WHERE uid IN (SELECT uid FROM nomdusite_users_roles WHERE rid=3);"

</code>

</pre>

h4. Obtenir des informations sur un utilisateur

Retourne, pour un login donné, l'uid, l'adresse mail, les rôles et le statut.

<pre>

<code>drush uinf mon_utilisateur</code>

</pre>

h4. Changer le mot de passe d'un utilisateur

Uniquement si problème de passation au niveau de l'administration d'un site, et sur demande explicite de celui-ci.

<pre>

<code>

drush upwd mon_utilisateur --password="mon_nvo_mot-de-passe"

</code>

</pre>

h4. Changer les rôles d'un utilisateur

Idem, uniquement sur demande explicite de celui-ci !

* <code> drush urol "administrator" mon_utilisateur  </code> : donne le rôle "administrator" à l'utilisateur mon_utilisateur<br>

* <code> drush urrol "administrator" mon_utilisateur  </code> : retire le rôle "administrator" à l'utilisateur mon_utilisateur

h3. Revenir sur une mise à jour qui a échoué

Pour revenir sur une mise à jour, il faut rétablir la base de données telle qu'elle était avant la mise à jour.

Cela suppose évidemment d'avoir fait une sauvegarde de la base de donnée avant :p

Dans le cas d'une grosse base de données comme la notre, phpmyadmin n'est pas une solution viable, il faut donc utiliser directement le sql en ligne de commande ou drush, bien entendu ^^

<pre>

<code>

drush sqlq < ~/sauvegardes/12345.sql

</code>

</pre>

C'est l'équivalent sql de :

<pre>

<code>

 mysql -h localhost -u root -p mabase < ~/sauvegardes/12345.sql 

</code>

</pre>

Explications : je me connecte au serveur _localhost_ avec le nom d'utilisateur _root_ et je veux écraser la base de donnée _mabase_ en y injectant le code sql généré par ma sauvegarde dans le fichier ~/sauvegardes/12345.sql

NB : Pour écraser une base, assurez-vous d'avoir des "CREATE TABLE IF NOT EXISTS" dans le fichier de sauvegardes et non seulement "CREATE TABLE". Dans ce dernier cas, il faut supprimer les tables de la bdd avant d'injecter les fichiers sql.

h2. Les alias drush

h3. Les alias de sites

Les alias de sites permettent de lancer une commande drush sans être dans le dossier du site, en précisant le nom du site via un alias de la manière suivante :

<pre>

<code>

drush @monsite status

</code>

</pre>

Pour connaitre la liste de tous les alias et leur syntaxe exacte, lancer <code>drush sa</code> dans le dossier des sites.

NB : l'alias <code>drush @sites</code> permet de lancer la commande drush sur chacun des sites, et effectue une action similaire à [[Scripts_et_taches_planifiees#drushall_and_co|notre script <code>drushall</code>]] sans pour autant le remplacer…

h3. Les alias de scripts

Il est également possible de créer des commandes drush personnalisées en utilisant les alias. On peut alors regrouper plusieurs actions souvent effectuées à la suite, voire même des scripts entiers, dans une commande drush.

Voir ceci [[Scripts_et_taches_planifiees#Liste-des-alias-drush-à-disposition|la liste des alias drush créés par et pour le club drupal]].

h2. Agir sur tous les sites d'un coup

Pour administrer tous les sites du multi-site en une seule fois, nous avons créé le script [[Scripts_et_taches_planifiees#drushall-and-co|drushall]]. L'alias <code>drush @sites</code> peut également être utilisés dans certains cas.