Uso de Drush

De FdIwiki SC
Saltar a: navegación, buscar

Ésta es una guía para el uso de Drush, una interfaz de shell para manejar Drupal desde la línea de comandos de vuestro servidor web. Es enormemente útil, puesto que permite manejar ciertos aspectos de vuestro Drupal con pocos comandos (instalar módulos, desinstalarlos, borrar la cache...). El uso de ésta herramienta hará mucho más eficiente el desarrollo de vuestro Drupal.

En http://wikis.fdi.ucm.es/SC/Drush podéis encontrar una guía ya hecha por alguno de nuestros compañeros para instalar Drush. En ésta guía se asume que ya tenéis Drush instalado. Si no es así, sólo tenéis que navegar a la url anterior y seguir los pasos.

tamaño

Primeros pasos

Lo primero de todo será navegar a vuestro directorio de Drupal.

cd /var/www/"el nombre de vuestra carpeta de Drupal"

Esto es muy importante, puesto que todos los comandos que se mostrarán a continuación deben ser ejecutados desde vuestro directorio de Drupal.

Uno de los comandos más básicos es el de "status".

drush status

Éste comando os permitirá ver el estado de vuestro Drupal. Es muy importante puesto que, si tras usar el comando no veis la información de vuestro Drupal, significa que no estáis en el directorio correcto.

Instalando módulos

Cómo antes se ha dicho, uno de los usos de Drush es instalar módulos.

Si, por ejemplo, queremos instalar el módulo Commerce, solamente tendremos que ejectutar el comando:

drush pm-download commerce

(Donde "commerce" es donde tenéis que poner el nombre del módulo).

Este comando se encargará de instalarlo y colocarlo en el directorio correspondiente, tal y como hace Drupal si instalas un módulo desde la web.

Si deseamos desinstalarlo, ejecutamos:

drush pm-uninstall commerce


Ya hemos instalado nuestro módulo. Sin embargo, hay que introducir otro comando si quieres activarlo:

drush en commerce

Si un módulo tiene una dependencia (depende de otro para ser activado, como puede ocurrir en muchos casos), Drush te avisará con un mensaje en la terminal, diciéndote cual es el módulo que debes activar para poder activar el módulo que deseas (dándote la opción de activarlo en ese momento).

En el caso de que quieras desactivar este módulo, sólo tendrías que ejecutar:

drush dis commerce

En caso de que desees poder ver qué módulos están instalados en tu Drupal y el estado en el que se encuentran, solamente debes ejecutar:

drush pml --no-core

Éste comando mostrará la información de tódos tus módulos instalados.


Nota: estos comandos también sirven para instalar temas (activarlos, borralos, etc...)

Actualizaciones

Ya sabes cómo instalar módulos, desinstalarlos... pero para mantener tu Drupal funcionando correctamente también es importante saber cómo actualizarlos.

Lo primero que debes hacer a la hora de actualizar módulos es ver si hay disponible alguna actualización:

drush up -n | grep available

Ahora que sabes qué módulos tienen actualizaciones, puede decidir cuales actualizar.

Siguiendo con el ejemplo de commerce, en el caso de que tuviese alguna actualización disponible, ejecutaríamos:

drush up commerce

Si simplemente quieres instalar todas las actualizaciones de una pasada, puedes usar el comando:

drush up

De todas formas, sólo es recomendable usar este comando si tienes pocas actualizaciones (aunque tampoco debería pasar nada grave).

Creación de usuarios

También es posible crear usuarios a través de Drush:

drush user-create username --mail="el mail del usuario" --password="la contraseña del usuario"

Si queremos cambiar la contraseña del usuario, ejecutamos:

drush user-password username --password="nueva contraseña"

Nota: donde "username", es el nombre del usuario en cuestión.

Otras opciones

También es posible crear comandos personalizados en Drush. Os animo a investigarlo, probarlo, y actualizar ésta página para beneficio de todos :)