Club Drupal

{{important(Vous devez être à l'aise avec les notions expliquées [[Competences_techniques_apache_et_drupal|ici]] avant de lire ce document)}}

{{note(Les commandes seront données pour Fedora. Adaptez à votre distribution.)}}

{{>toc}}

h1. Modifier le host

Les sites sont hébergés sur le sous-domaine assos.local. Ajoutez donc la ligne @127.0.0.1 assos.local@ à /etc/hosts.

h1. Préparer Apache

Dans toute la suite _DIR_ASSOS_ sera à remplacer par le chemin vers le dossiers contenant l'installation Drupal.

h2. Activer les userdirs

Par défaut, Apache ne peux pas aller dans les dossiers utilisateurs. Il faut les activer. Cela se passe dans le fichier de configuration principal de Apache. Ouvrez @/etc/http/conf.d/userdir.conf@ et remplacez @UserDir disabled@ par @UserDir enabled@.

h2. Créer le bon vhost

h3. Apache 2.2

<pre>
<code class="xml">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerAlias fedora

<Directory DIR_ASSOS>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

</VirtualHost>
</code>
</pre>

h3. Apache 2.4

La configuration d'Apache 2.4 est légèrement différente de celle de la version 2.2.

<pre>
<code class="xml">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName assos.local
ServerAlias assos.local

DocumentRoot DIR_ASSOS

<Directory DIR_ASSOS>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Require all granted
</Directory>

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

</VirtualHost>
</code>
</pre>

{{tip(Pensez à relancer Apache après ces modifications)}}

h1. Préparer mysql

Par défaut, mysql n'autorise pas les requêtes trop importantes ce qui peut conduire à l'erreur _MySQL server has gone away_ côté Drupal. Ajouter ou modifier @max_allowed_packet=16M@ à votre /etc/my.cnf

h1. Settings.php

Mettre Mettez les bonnes valeurs dans settings.local.php.



h1. sites.php

Remplacer assos.centrale-marseille.fr par assos.local sur la ligne du site choisi.

h1. Permissions

Vérifier que le serveur Apache a les bonnes permissions, ie qu'il peut accéder au dossier sans problème. Faîtes des @chmod 711@ sur les dossiers qu'il doit traverser, @chmod -R 755 DOSSIER_DU_SITE@, @chmod -R 777 FILES@.

Si vous utilisez SELinux, pensez à le désactiver avec @sudo setenforce 0@ ou à modifier le contexte du dossier drupal avec @sudo chcon -t httpd_sys_content_t public_html@.

{{important(Les permissions des dossiers et fichiers sont trop permissives mais évitent les erreurs. À améliorer.)}}

h1. Le script

Il existe un script qui synchronise et fait ces opérations pour vous : source:other-scripts/d7-sync.sh. Il ne supporte pas encore correctement le sites.php. Lorsqu'on se connecte au site, la page est blanche.

h1. Sources externes

* http://fedoraphprails.blogspot.fr/2009/08/how-to-set-up-apache-user-home.html
* http://httpd.apache.org/docs/2.4/upgrading.html