Entorn de desenvolupament de Guifi.net basat en Drupal 7

Aquest document explica com preparar un entorn de desenvolupament de la web de Guifi.net basat en Drupal, per poder col·laborar en el seu desenvolupament.

La web de Guifi.net, actualment, està construïda sobre la versió 7 de Drupal. El desenvolupament se centra entorn del mòdul de Drupal "drupal-guifi", que gestiona tot el funcionament de la web de Guifi.net, però també serveix per desenvolupar altres mòduls (com "budgets") i temes ("theme_guifinet2011").

Resum del procés

La preparació de l'entorn de desenvolupament consta dels següents punts essencials:

• Instal·lació i configuració del servidor web i de la base de dades
• Descàrrega, instal·lació i configuració de Drupal 7 i dels mòduls necessaris
• Clonatge del codi font dels mòduls de Guifi des del repositori

Requisits del servidor

En aquest document es contempla que l'entorn de desenvolupament s'executa en un servidor amb una instal·lació neta d'un d'aquests sistemes operatius:

• Debian 8.2 Jessie amb retroversions (backports)
• Ubuntu 14.04.3 LTS Trusty Tahr amb retroversions (backports)
• Arch Linux

tot i que també se'n poden utilitzar d'altres. En qualsevol cas, s'assumeix que el sistema operatiu ja es troba instal·lat i té els paquets actualitzats. Afegir i activar els repositoris de retroversions (backports) de Debian i Ubuntu ens ajudarà, respectivament, a mantenir les instal·lacions més actualitzades.

Instal·lació i configuració del servidor web

Per a l'entorn de desenvolupament farem servir el servidor web Apache i, com que Drupal 7 està escrit en PHP, també instal·larem el mòdul de PHP5. La instal·lació afegirà automàticament alguns paquets més, com a dependències dels anteriors.

Instal·lació del servidor web

Instal·lem els paquets necessaris (amb l'usuari root, o bé amb un usuari que tingui els permisos adequats, afegint "sudo" davant de les ordres):

• Debian:

# apt-get install apache2 libapache2-mod-php5

• Ubuntu

# apt-get install apache2 libapache2-mod-php5

• Archlinux:

# todo

Configuració del servidor web

Un cop acabada la instal·lació, cal configurar el servidor web. Primer, ens assegurem de que el mòdul de PHP5 està activat:

• Debian

# a2enmod php5

• Ubuntu

# a2ensmod php5

• Archlinux:

# todo

El servidor web Apache2 pot gestionar diversos hosts virtuals (i.e. llocs web) alhora, configurant-los en diferents fitxers de la carpeta "/etc/apache2/sites-available/" i després activant-los amb l'ordre "a2ensite nom_del_lloc_web". Per defecte en ve un d'activat, que es configura al fitxer "000-default.conf" i que utilitzarem per mostrar la web de desenvolupament.

Editem el fitxer "/etc/apache2/sites-enabled/000-default.conf" amb l'editor de text "nano" (en podeu fer servir qualsevol altre, si ho preferiu) i canviem la línia

DocumentRoot /var/www/html

per

DocumentRoot /var/www

<Directory /var/www/guifi>
    AllowOverride All
</Directory>

Sortim de l'editor de text i recarreguem el servidor web Apache2:

• Debian

# service restart apache2

• Ubuntu

# service restart apache2

• Archlinux:

# todo

Instal·lació i configuració de la base de dades

En aquest entorn de desenvolupament utilitzarem la base de dades MySQL per emmagatzemar-hi les dades de Drupal i de Guifi. Durant la instal·lació se'ns demanarà posar una contrasenya per a l'usuari "root" de la base de dades: és important no oblidar-la; la farem servir més endavant. Procedim:

• Debian:

# apt-get install mysql-server

• Ubuntu

# apt-get install apache2 libapache2-mod-php5

• Archlinux:

# todo

[Opcional] Instal·lació d'una interfície web per a la base de dades

Per al desenvolupament de la web de Guifi, és molt útil disposar d'una interfície web com phpMyAdmin per inspeccionar el contingut de la base de dades. L'instal·lem:

• Debian

# apt-get install phpmyadmin

• Ubuntu

# apt-get install phpmyadmin

• Archlinux:

# todo

Durant la instal·lació, se'ns demana quin servidor tenim instal·lat al sistema. Marcarem (amb la tecla Espai) el servidor "apache2", que acabem d'instal·lar. També se'ns preguntarà si volem "configurar la base de dades de phpmyadmin amb dbconfig-common". Respondrem que sí, i aleshores se'ns demanarà per la contrasenya de l'usuari "root" de la base de dades que hem introduït anteriorment.

A continuació, abans d'acabar amb la instal·lació del paquet, se'ns demanarà una contrasenya per a l'usuari "phpmyadmin" a la base de dades; tal com se suggereix, la podem deixar en blanc i seguir: no la farem servir.

Instal·lació de Drupal 7

Un cop configurat el servidor amb els paquets necessaris, procedim a descarregar, instal·lar i configurar Drupal 7.

= Descàrrega de Drupal 7

Ens dirigim al lloc web de Drupal i naveguem fins a l'apartat de descàrregues. Cliquem altres versions (other releases) i cerquem la [=103 darrera versió de Drupal 7], que en aquest cas és la versió 7.41. Copiem l'enllaç de baixada en format "tar.gz" i el descarreguem al directori "/var/www":

# cd /var/www
# wget https://ftp.drupal.org/files/projects/drupal-7.41.tar.gz

El descomprimim i reanomenem la carpeta:

# tar -xf drupal-7.41.tar.gz
# mv drupal-7.41 guifi