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·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

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