Projet

Général

Profil

Competences techniques apache et drupal » Historique » Version 23

Julien Enselme, 02/06/2013 19:26
Pouvoir reproduire en local un site en particulier

1 1 Florent Torregrosa
{{toc}}
2
3 7 Julien Enselme
h1. Compétences techniques apache et drupal
4 1 Florent Torregrosa
5 7 Julien Enselme
h2. Différences majeures entre les distributions
6 1 Florent Torregrosa
7 8 Julien Enselme
Bien que parfois très semblables, les distributions GNU/Linux diffèrent dans leur fonctionnement. Afin de bien comprendre la suite de ce document et d’éviter quelques incompréhensions, nous proposons une liste des différences majeures et des points principaux à adapter. La liste de distribution donnée dans chaque type n’est aucunement exhaustive, tout comme la liste des points de différences.
8
9
h3. Le nom du service apache
10
11
* Pour les distribution basées sur Debian (Ubuntu, Linux Mint,…) : le service s’appelle apache2
12
* Pour les distributions typées RedHat (Fedora, CentOS,…) : le service s’appelle httpd
13
14
h3. Interaction avec les services
15
16
Historiquement les distributions utilisaient le service init pour démarrer et la commande <code>service</code> pour interragir avec les services de la façon suivante : <code>service apache2 restart</code>. Cela est toujours le cas sur Debian.
17
18
De plus en plus de distributions (Fedora, Mageia, OpenSUSE,…) utilisent de nos jours systemd qui gèrent aussi les services via la commande <code>systemctl</code> de la façon suivante : <code>systemctl restart httpd</code>. La commande <code>service</code> est dans la plupart des cas toujours opérationnelle pour des raisons de compatibilités.
19
20
h3. Activation des modules Apache
21
22
L’activation explicite des modules dépend de votre distributions.
23
24
h3. Emplacements des fichiers de configuration
25
26
Suivant votre distribution l’emplacement des fichiers de configuration peut varier. Il y a une constante toute fois : ils sont souvent dans /etc/NOM_DU_SERVICE.
27 1 Florent Torregrosa
28 7 Julien Enselme
h2. Installer et configurer Apache, phpmyadmin
29
30 9 Julien Enselme
* savoir installer un serveur apache et phpmyadmin (dépend de votre système)
31
* augmenter sa mémoire dédiée
32
* avoir drush d'installer (peut-être présent dans les dépôts de votre distributions) et savoir où il est installé : which drush
33
* augmenter la taille maximale des fichiers pouvant être importés dans phpmyadmin (dans le(s) php.ini, la méthode suivante est basée sur les systèmes basés sur debian. À adapter pour votre système.). Il faut trouver et modifier les lignes suivantes dans /etc/php5/apache2/php.ini et /etc/php5/cli/php.ini
34 7 Julien Enselme
35 9 Julien Enselme
 * <code class="php">memory_limit = 512M;</code>
36
 * <code class="php">post_max_size = 32M;</code>
37
 * <code class="php">upload_max_filesize = 32M;</code>
38 12 Julien Enselme
 * redémarrer apache
39
* savoir recharger la configuration d’apache et le redémarrer : <code class="bash">service apache2 reload</code> et <code class="bash">service apache2 restart</code>
40 7 Julien Enselme
41 1 Florent Torregrosa
h2. Savoir ajouter/activer des modules pour le serveur apache (notamment le module pour les url-simplifiées)
42
43
* sudo a2enmod mod_rewrite
44 7 Julien Enselme
* sudo a2ensite NOM_DU_SITE
45 1 Florent Torregrosa
46 7 Julien Enselme
h2. Savoir installer drush et les bibliothèques php
47 1 Florent Torregrosa
48 20 Julien Enselme
* Si drush est fourni dans les dépôts de votre distribution, l’installer depuis ceux-ci. Si votre distribution fourni également drupal, il peut être intéressant de l’installer également pour avoir la liste des dépendances. L’installation de drupal via drush est la méthode recommandée.
49
* Savoir où est installé drush : @drush config@
50
* Dépendances supplémentaires utiles : @sudo apt-get install curl libcurl3 libcurl3-dev php5-curl@
51
52
Pour plus d’information sur Drush, consulter la [[Drush|page dédiée]].
53 1 Florent Torregrosa
54 3 Florent Torregrosa
h2. Pouvoir utiliser un nom de domaine en local
55 1 Florent Torregrosa
56 21 Julien Enselme
Quand je vais sur assos.centrale-marseille.fr, c’est mon site local que je veux voir et non pas celui de centrale. Il suffit de modifier le fichier hosts, situé dans /etc en ajoutant la ligne
57 7 Julien Enselme
<pre>127.0.0.1  assos.centrale-marseille.fr</pre>
58 11 Julien Enselme
59 21 Julien Enselme
Constater qu’en allant sur assos.centrale-marseille.fr on tombe sur la page par defaut de notre apache (la page sur laquelle on tombe dépend de la configuration d’apache). On peut vérifier avec le module Firefox _show ip_ qui donne l’IP du site sur lequel on est. Si l’IP affichée est 127.0.0.1, c’est bon.
60 7 Julien Enselme
61 22 Julien Enselme
h2. Pouvoir créer des vhost
62 1 Florent Torregrosa
63
Exemple : créer le domaine titi.local
64
65 22 Julien Enselme
h3. Pour les distributions basées sur Debian
66 7 Julien Enselme
67 22 Julien Enselme
* Dans /etc/apache2/sites-available/ créer un fichier titi. Le contenu de titi est :
68 7 Julien Enselme
69
<pre>
70
<VirtualHost *:80>
71
       ServerAdmin webmaster@localhost
72
       ServerName titi.local
73
       ServerAlias titi.local
74
75
       DocumentRoot /chemin/dossier_site
76
77
       <Directory /chemin/dossier_site/>
78
               Options Indexes FollowSymLinks MultiViews
79
               AllowOverride All
80
               Order allow,deny
81
               allow from all
82
       </Directory>
83
84
       ErrorLog ${APACHE_LOG_DIR}/titi.error.log
85
86 1 Florent Torregrosa
       # Possible values include: debug, info, notice, warn, error, crit,
87
       # alert, emerg.
88
       LogLevel warn
89
90 7 Julien Enselme
       CustomLog ${APACHE_LOG_DIR}/titi.access.log combined
91 1 Florent Torregrosa
</VirtualHost>
92
</pre>
93 7 Julien Enselme
94 22 Julien Enselme
* Créer le fichier test.html dans /chemin/dossier_site  et mettre dedans <pre><h1>TITI</h1></pre>
95
* Activer le site : @sudo a2ensite titi@
96
* *ou*
97
* Ajouter un lien symbolique dans /etc/apache2/sites-enabled qui pointe sur le fichiet titi qui est dans /etc/apache2/sites-available/ pour activer le site (méthode manulle)
98 1 Florent Torregrosa
99
 * <code>cd /etc/apache2/sites-enabled/</code>
100
 * <code>ln -s ../sites-available/titi .</code>
101 22 Julien Enselme
102
* Ajouter l’entrée titi.local dans le fichier /etc/hosts
103 1 Florent Torregrosa
<pre>
104
127.0.0.1        titi.local
105
</pre>
106
107
* Redémarrer apache : <code>sudo service apache2 restart</code>
108 22 Julien Enselme
* Consulter  titi.local/test.html
109
110
h3. Pour Mageia 3
111
112
TODO
113
114
h3. Pour Fedora et les distributions basées sur RHEL (CentOS, Scientific Linux…)
115
116
* Dans /etc/httpd/cond.d/ créer un fichier titi. Le contenu de titi est :
117
118
<pre>
119
<VirtualHost *:80>
120
       ServerAdmin webmaster@localhost
121
       ServerName titi.local
122
       ServerAlias titi.local
123
124
       DocumentRoot /chemin/dossier_site
125
126
       <Directory /chemin/dossier_site/>
127
               Options Indexes FollowSymLinks MultiViews
128
               AllowOverride All
129
               Order allow,deny
130
               allow from all
131
       </Directory>
132
133
       # Possible values include: debug, info, notice, warn, error, crit,
134
       # alert, emerg.
135
       LogLevel warn
136
137
</VirtualHost>
138
</pre>
139
140
* Créer le fichier test.html dans /chemin/dossier_site  et mettre dedans <pre><h1>TITI</h1></pre>
141
* Ajouter l’entrée titi.local dans le fichier /etc/hosts
142
<pre>
143
127.0.0.1        titi.local
144
</pre>
145
146
* Redémarrer apache :
147
148
 * Fedora >= 15 (basées sur systemd) : @systemctl restart httpd@
149
 * Fedora < 15, CentOS… <code>service httpd restart</code>
150 7 Julien Enselme
* Consulter  titi.local/test.html
151
152 1 Florent Torregrosa
h2. Pouvoir reproduire en local un site en particulier
153
154 23 Julien Enselme
Pouvoir télécharger en local juste le minimum de fichiers. Le minimum c’est :
155 1 Florent Torregrosa
156 23 Julien Enselme
* tout le htmltest sauf le dossier sites
157
* dans sites/ il faut ne prendre que le dossier default et le dossier du site qui nous concerne.
158
* pouvoir se démerder (script ou suite de ligne de commande ou …) pour pouvoir faire ça efficacement (une suite de commande scp ou rsync n’est pas une mauvaise idée). Jenselme avait commencé un script qui fonctionne presque pour la réplication des sites en local et possède des capacités de réplication sur le réseau. Idée donnée par dgeo à jenselme : utiliser drush avec entre autre @drush rsync@. À creuser.
159 1 Florent Torregrosa
160 23 Julien Enselme
 * sur sa machine : se faire un dossier d6 et un dossier d7
161
 * _Exemple pour le site des annales, à apapter_ :
162 14 Julien Enselme
<pre>
163
 <code>cd d6</code>
164
  <code>rsync -lr --exclude sites assos@sas1.centrale-marseille.fr:html/* .</code>
165
  <code>mkdir sites</code>
166
  <code>cd sites</code>
167
  <code>rsync -lr assos@sas1.centrale-marseille.fr:html/sites/default .</code>
168
  <code>rsync -lr assos@sas1.centrale-marseille.fr:html/sites/assos.centrale-marseille.fr.annales .</code> (étape longue)
169
</pre>
170 7 Julien Enselme
171 1 Florent Torregrosa
h2. Pouvoir télécharger la base de donnée d’un seul site en particulier
172 2 Florent Torregrosa
173 15 Julien Enselme
h3. Avec phpmyadmin
174 1 Florent Torregrosa
175 15 Julien Enselme
Dans phpmyadmin :
176
 * exporter
177
 * options personnalisées
178
 * choisir que les tables qui vous intéressent
179
 * laisser les autres options
180
 * enregistrer
181
 * ça enregistre dans votre dossier de téléchargements sur votre machine
182 1 Florent Torregrosa
183 15 Julien Enselme
h3. Avec drush
184 1 Florent Torregrosa
185 15 Julien Enselme
Indispensable car parfois le fichier téléchargé par phpmyadmin est trop gros et dépasse la limite autorisée.
186
187
# sur le sas, pour le site des annales par exemple :
188
<pre>
189
<code>dump_site annales</code>
190
<code>cd Desktop/dump_individuels</code>
191
</pre>
192
*ou si le site est dans une base de données séparée :*
193
<pre>
194
<code>cd DOSSIER DU SITE</code>
195
<code>drush sql-dump > fichier.sql</code>
196
</pre>
197
# sur sa machine :
198
<pre>scp assos@sas1.centrale-marseille.fr:Desktop/dump_individuels/annalesDATE .</pre>
199 1 Florent Torregrosa
200
h2. Monter un site en local
201
202
* monter un seul vhost pour assos.centrale-marseille.fr (il sera valable pour tous les sous sites, il ne sera jamais édité)
203
* télécharger les fichiers et la base de donnée du site en question
204 16 Julien Enselme
* injecter la dbb en local (utiliser le phpmyadmin en local ou mysql -u root -pmotdepasse nomdelabase < fichier.sql)
205 7 Julien Enselme
* modifier le settings.php du site en question pour donner les informations de connection mysql et modifier $base_url
206
* pour aller plus vite, renommer le dossier du site en default
207 1 Florent Torregrosa
208 13 Julien Enselme
h2. Installer le script drush de mise à jour
209 1 Florent Torregrosa
210 13 Julien Enselme
* suivre la procédure d’installation donnée "ici":http://drupal.org/project/drush_sup
211 1 Florent Torregrosa
* critère de validation : la commande suivante marche : drush sup
212
213
h2. Exécuter correctement le script de mise à jour
214
215
* lire la doc de drush sup
216
* exécuter drush sup avec les bons arguments
217 7 Julien Enselme
218
h2. Alias drush
219
220
221
TODO (dans la doc drush ?)
222
installer dom, xml (paquet php)
223 1 Florent Torregrosa
224 3 Florent Torregrosa
h1. Annexe : Nom de domaine
225 1 Florent Torregrosa
226 19 Julien Enselme
Il est tout à fait possible de faire pointer n’importe quel nom de domaine sur sa machine locale. Normalement, toutes les unix reposent sur le même principe. Il suffit d’ajouter l’entrée suivante dans /etc/hosts (par exemple pour assos) : @127.0.0.1  assos.centrale-marseille.fr@. Ne pas oublier de relancer apache.
227 1 Florent Torregrosa
228 3 Florent Torregrosa
h1. Annexe : Vhosts
229 1 Florent Torregrosa
230
h2. Pour les distributions basées sous Debian
231
232 3 Florent Torregrosa
* Dans /etc/apache2/sites-available/ créer un fichier titi dont le contenu est :
233
<pre>
234
<VirtualHost *:80>
235
    ServerAdmin webmaster@localhost
236
    ServerName titi.local
237
    ServerAlias titi.local
238 2 Florent Torregrosa
239 3 Florent Torregrosa
    DocumentRoot /chemin/dossier_site
240 1 Florent Torregrosa
241 3 Florent Torregrosa
    <Directory /chemin/dossier_site/>
242
        Options Indexes FollowSymLinks MultiViews
243
        AllowOverride All
244
        Order allow,deny
245
        allow from all
246
    </Directory>
247
248
    ErrorLog ${APACHE_LOG_DIR}/titi.error.log
249
250
    # Possible values include: debug, info, notice, warn, error, crit,
251
    # alert, emerg.
252
    LogLevel warn
253
254
    CustomLog ${APACHE_LOG_DIR}/titi.access.log combined
255
256
</VirtualHost>
257
</pre>
258
* créer le fichier test.html dans /chemin/dossier_site et mettre dedans @<h1>TITI</h1>@
259
* ajouter un lien symbolique dans /etc/apache2/sites-enabled qui pointe sur le fichier titi qui est dans /etc/apache2/sites-available/ :
260 17 Julien Enselme
 * Manuellement :
261
<pre>
262 3 Florent Torregrosa
cd /etc/apache2/sites-enabled/
263
ln -s ../sites-available/titi .
264
</pre>
265 17 Julien Enselme
* Avec la commande apache :
266
<code>sudo a2ensite titi</pre>
267
268 3 Florent Torregrosa
* ajouter l’entrée titi.local dans le fichier /etc/hosts :
269 1 Florent Torregrosa
<pre>
270
@127.0.0.1        titi.local@
271 3 Florent Torregrosa
</pre>
272 4 Florent Torregrosa
* restart apache
273 3 Florent Torregrosa
<pre>
274 4 Florent Torregrosa
sudo service apache2 restart
275 1 Florent Torregrosa
</pre>
276
* consulter  titi.local/test.html
277
278
h2. Pour Mageia 3
279 4 Florent Torregrosa
280
{{warning(la partie pour mageia permet pour l'instant d'atteindre le site via localhost/nom_du_site, pas encore bien connecté avec le fichier Hosts)}}
281
282
* Dans /etc/httpd/conf/sites.d/ créer un fichier nom_du_fichier.conf dont le contenu est :
283
<pre>
284
# Drupal configuration
285
Alias /nom_du_site /chemin/dossier_site
286
287
<Directory /chemin/dossier_site/>
288
   Require local granted
289
   Options -Indexes +FollowSymlinks +Multiviews
290
   AllowOverride None
291
292
    # Protect files and directories from prying eyes.
293
    <FilesMatch "\.(engine|inc|info|install|make|module|profile|test|po|sh|.*sql|theme|tpl(\.php)?|xtmpl)$|^(\..*|Entries.*|Repository|Root|Tag|Template)$">
294
      Order allow,deny
295
    </FilesMatch>
296
297
    # Don't show directory listings for URLs which map to a directory.
298
    Options -Indexes
299
300
    # Follow symbolic links in this directory.
301
    Options +FollowSymLinks
302
303
    # Make Drupal handle any 404 errors.
304
    ErrorDocument 404 /index.php
305
306
    # Set the default handler.
307
    DirectoryIndex index.php index.html index.htm
308
309
    # Override PHP settings that cannot be changed at runtime. See
310
    # sites/default/default.settings.php and drupal_environment_initialize() in
311
    # includes/bootstrap.inc for settings that can be changed at runtime.
312
313
    # PHP 5, Apache 1 and 2.
314
    <IfModule mod_php5.c>
315
        php_flag magic_quotes_gpc                 off
316
        php_flag magic_quotes_sybase              off
317
        php_flag register_globals                 off
318
        php_flag session.auto_start               off
319
        php_value mbstring.http_input             pass
320
        php_value mbstring.http_output            pass
321
        php_flag mbstring.encoding_translation    off
322
    </IfModule>
323
324
    # Requires mod_expires to be enabled.
325
    <IfModule mod_expires.c>
326
        # Enable expirations.
327
        ExpiresActive On
328
329
        # Cache all files for 2 weeks after access (A).
330
        ExpiresDefault A1209600
331
332
        <FilesMatch \.php$>
333
            # Do not allow PHP scripts to be cached unless they explicitly send
334
            # cache headers themselves. Otherwise all scripts would have to 
335
            # overwrite the headers set by mod_expires if they want another 
336
            # caching behavior. This may fail if an error occurs early in the
337
            # bootstrap process, and it may cause problems if a non-Drupal PHP
338
            # file is installed in a subdirectory.
339
            ExpiresActive Off
340
        </FilesMatch>
341
    </IfModule>
342
343
    # Various rewrite rules.
344
    <IfModule mod_rewrite.c>
345
        RewriteEngine on
346
347
        # Block access to "hidden" directories whose names begin with a period.
348
        # This includes directories used by version control systems such as
349
        # Subversion or Git to store control files. Files whose names begin with
350
        # a period, as well as the control files used by CVS, are protected by 
351
        # the FilesMatch directive above.
352
        #
353
        # NOTE: This only works when mod_rewrite is loaded. Without mod_rewrite,
354
        # it is not possible to block access to entire directories from 
355
        # .htaccess, because <DirectoryMatch> is not allowed here.
356
        #
357
        # If you do not have mod_rewrite installed, you should remove these
358
        # directories from your webroot or otherwise protect them from being
359
        # downloaded.
360
        RewriteRule "(^|/)\." - [F]
361
362
        # If your site can be accessed both with and without the 'www.' prefix,
363
        # you can use one of the following settings to redirect users to your
364
        # preferred URL, either WITH or WITHOUT the 'www.' prefix. Choose ONLY
365
        # one option: 
366
        # To redirect all users to access the site WITH the 'www.' prefix,
367
        # (http://example.com/... will be redirected to http://www.example.com/...)
368
        # uncomment the following:
369
        # RewriteCond %{HTTP_HOST} !^www\. [NC]
370
        # RewriteRule ^ http://www.%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
371
        #
372
        # To redirect all users to access the site WITHOUT the 'www.' prefix,
373
        # (http://www.example.com/... will be redirected to http://example.com/...)
374
        # uncomment the following:
375
        # RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
376
        # RewriteRule ^ http://%1%{REQUEST_URI} [L,R=301]
377
378
        # Modify the RewriteBase if you are using Drupal in a subdirectory or in a
379
        # VirtualDocumentRoot and the rewrite rules are not working properly.
380
        # For example if your site is at http://example.com/drupal uncomment and
381
        # modify the following line:
382
        RewriteBase /nom_du_site
383
        #
384
        # If your site is running in a VirtualDocumentRoot at http://example.com/,
385
        # uncomment the following line:
386
        # RewriteBase /
387
388
        # Pass all requests not referring directly to files in the filesystem to
389
        # index.php. Clean URLs are handled in drupal_environment_initialize().
390
        RewriteCond %{REQUEST_FILENAME} !-f
391
        RewriteCond %{REQUEST_FILENAME} !-d
392
        RewriteCond %{REQUEST_URI} !=/favicon.ico
393
        RewriteRule ^ index.php [L]
394
395
        # Rules to correctly serve gzip compressed CSS and JS files.
396
        # Requires both mod_rewrite and mod_headers to be enabled.
397
        <IfModule mod_headers.c>
398
        # Serve gzip compressed CSS files if they exist and the client accepts gzip.
399
        RewriteCond %{HTTP:Accept-encoding} gzip
400
        RewriteCond %{REQUEST_FILENAME}\.gz -s
401
        RewriteRule ^(.*)\.css $1\.css\.gz [QSA]
402
403
        # Serve gzip compressed JS files if they exist and the client accepts gzip.
404
        RewriteCond %{HTTP:Accept-encoding} gzip
405
        RewriteCond %{REQUEST_FILENAME}\.gz -s
406
        RewriteRule ^(.*)\.js $1\.js\.gz [QSA]
407
408
        # Serve correct content types, and prevent mod_deflate double gzip.
409
        RewriteRule \.css\.gz$ - [T=text/css,E=no-gzip:1]
410
        RewriteRule \.js\.gz$ - [T=text/javascript,E=no-gzip:1]
411
412
        <FilesMatch "(\.js\.gz|\.css\.gz)$">
413
            # Serve correct encoding type.
414
            Header set Content-Encoding gzip
415
            # Force proxies to cache gzipped & non-gzipped css/js files 
416
            # separately.
417
            Header append Vary Accept-Encoding
418
        </FilesMatch>
419
        </IfModule>
420
    </IfModule>
421
422
</Directory>
423
</pre>
424
{{tip(Pour ce fichier de configuration, se baser sur celui fournit par Mageia lors de l'installation d'un Drupal depuis la logithèque de Mageia.)}}
425
426
* créer un dossier (avec un Drupal dedans) appelé dossier_site dans /chemin/
427
* restart apache
428
<pre>
429
sudo service httpd stop
430
sudo service httpd start
431
</pre>
432
433
* consulter  localhost/nom_du_site
434
435 2 Florent Torregrosa
436
h2. Pour Fedora