1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>Compilation et installation - Serveur Apache HTTP</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Compilation et installation</h1>
21 <p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
22 <a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
23 <a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
24 <a href="./fr/install.html" title="Français"> fr </a> |
25 <a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
26 <a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
30 <p>Ce document couvre l'installation et la compilation d'Apache
31 sur les systèmes Unix et similaires seulement. Pour la compilation et
32 l'installation sous Windows, voir <a href="platform/windows.html">Utiliser Apache avec Microsoft
33 Windows</a>. Pour les autres plateformes, se référer à la documentation par
34 <a href="platform/">plateforme</a>.</p>
36 <p>Apache httpd utilise <code>libtool</code> et <code>autoconf</code>
37 afin de créer un environnement de construction similaire à la plupart
38 des projets Open Source .</p>
40 <p>Si vous effectuez une mise à jour depuis une version mineure vers
41 la suivante (par exemple, 2.2.50 à 2.2.51), veuillez passer à la section
42 <a href="#upgrading">mise à jour</a>.</p>
45 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Aperçu pour les plus pressés</a></li>
46 <li><img alt="" src="./images/down.gif" /> <a href="#requirements">Prérequis</a></li>
47 <li><img alt="" src="./images/down.gif" /> <a href="#download">Téléchargement</a></li>
48 <li><img alt="" src="./images/down.gif" /> <a href="#extract">Extraction</a></li>
49 <li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuration de l'arborescence des sources</a></li>
50 <li><img alt="" src="./images/down.gif" /> <a href="#compile">Construction</a></li>
51 <li><img alt="" src="./images/down.gif" /> <a href="#install">Installation</a></li>
52 <li><img alt="" src="./images/down.gif" /> <a href="#customize">Personnalisation</a></li>
53 <li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li>
54 <li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Mise à jour</a></li>
55 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="programs/configure.html">Configuration de l'arborescence
56 des sources</a></li><li><a href="invoking.html">Démarrer Apache</a></li><li><a href="stopping.html">Arrêt et redémarrage</a></li></ul></div>
57 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
59 <h2><a name="overview" id="overview">Aperçu pour les plus pressés</a></h2>
64 <td><a href="#download">Téléchargement</a></td>
66 <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
71 <td><a href="#extract">Extraction</a></td>
73 <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
74 $ tar xvf httpd-<em>NN</em>.tar<br />
75 $ cd httpd-<em>NN</em></code></td>
79 <td><a href="#configure">Configuration</a></td>
81 <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
86 <td><a href="#compile">Compilation</a></td>
88 <td><code>$ make</code> </td>
92 <td><a href="#install">Installation</a></td>
94 <td><code>$ make install</code> </td>
98 <td><a href="#customize">Personnalisation</a></td>
100 <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
104 <td><a href="#test">Test</a></td>
106 <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
111 <p><em>NN</em> doit être remplacé par le numéro de version courant,
112 et <em>PREFIX</em> par le
113 chemin du répertoire d'installation. Si
114 <em>PREFIX</em> n'est pas spécifié, le chemin du répertoire
115 d'installation prendra sa valeur par défaut, à savoir
116 <code>/usr/local/apache2</code>.</p>
118 <p>Chaque étape du processus de compilation et d'installation est
119 décrite plus en détails ci-dessous, à commencer par les prérequis
120 pour compiler et installer Apache httpd.</p>
121 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
122 <div class="section">
123 <h2><a name="requirements" id="requirements">Prérequis</a></h2>
125 <p>Les prérequis pour la construction d'Apache sont les suivants:</p>
128 <dt>Espace disque</dt>
129 <dd>Assurez-vous d'avoir au moins 50 MB d'espace disque disponible
130 temporaire. Après l'installation Apache occupe
131 approximativement 10 MB d'espace disque. L'espace disque réellement
132 nécessaire va varier considérablement en fonction de vos options
133 de configuration et de la présence éventuelle de modules tiers.</dd>
135 <dt>Compilateur ANSI-C et système de construction</dt>
136 <dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
137 (GCC)</a> de la <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
138 est recommandé. Si vous ne possédez pas GCC,
139 assurez-vous au moins que votre compilateur soit compatible ANSI.
140 En outre, votre <code>PATH</code> doit contenir
141 les outils de construction de base tels que <code>make</code>.</dd>
143 <dt>Connaissance de l'heure exacte</dt>
144 <dd>Les éléments du protocole HTTP font référence à l'heure du jour.
145 Par conséquent, il est nécessaire d'équiper votre système d'un
146 dispositif de synchronisation du temps. Les programmes
147 <code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP,
148 sont couramment utilisés à cet effet.
149 Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a>
150 pour plus de détails à propos du logiciel NTP et des serveurs
151 de temps publics.</dd>
153 <dt><a href="http://www.perl.org/">Perl 5</a>
155 <dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent)
156 est nécessaire pour l'exécution de certains scripts comme
157 <code class="program"><a href="./programs/apxs.html">apxs</a></code> ou <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code>
158 (qui sont écrits en Perl). Si vous disposez de plusieurs interpréteurs
159 Perl (par exemple, une installation globale Perl 4, et
160 votre installation personnelle de Perl 5), il vous faut utiliser l'option
161 <code>--with-perl</code> (voir ci-dessous) afin de vous assurer que le
162 bon interpréteur sera utilisé par <code class="program"><a href="./programs/configure.html">configure</a></code>.
163 Si le script <code class="program"><a href="./programs/configure.html">configure</a></code> ne trouve pas d'interpréteur
164 Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin.
165 Bien entendu, vous pourrez tout de même construire et utiliser
169 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
170 <div class="section">
171 <h2><a name="download" id="download">Téléchargement</a></h2>
173 <p>Le serveur HTTP Apache peut être téléchargé à partir du
174 <a href="http://httpd.apache.org/download.cgi">site de téléchargement
175 du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs.
176 Il sera plus commode à la plupart des utilisateurs d'Apache sur les
177 systèmes UNIX ou similaires de télécharger et de compiler
178 la version sources. Le processus de construction (décrit ci-dessous) est
179 simple, et vous permet de personnaliser votre serveur selon vos besoins.
180 En outre, les versions binaires sont souvent plus anciennes que les
181 dernières versions sources Si vous téléchargez une version binaire,
182 suivez les instructions décrites dans le fichier
183 <code>INSTALL.bindist</code> inclus dans la distribution.</p>
185 <p>Après le téléchargement, il est important de vérifier que vous
186 disposez d'une version complète et non modifiée du serveur HTTP Apache.
187 Vous pouvez le faire en testant l'archive téléchargée à l'aide de
188 la signature PGP. Vous trouverez les détails de cette opération sur la <a href="http://httpd.apache.org/download.cgi#verify">page de téléchargement</a> ainsi qu'un exemple précis décrivant <a href="http://httpd.apache.org/dev/verification.html">l'utilisation de
191 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
192 <div class="section">
193 <h2><a name="extract" id="extract">Extraction</a></h2>
195 <p>L'extraction des sources depuis l'archive Apache HTTPD consiste
196 simplement à décompresser et à désarchiver cette dernière :</p>
198 <div class="example"><p><code>
199 $ gzip -d httpd-<em>NN</em>.tar.gz<br />
200 $ tar xvf httpd-<em>NN</em>.tar
203 <p>Ceci créera, dans le répertoire courant, un nouveau répertoire
204 contenant le code source de la distribution. Vous devrez vous positionner
205 dans ce répertoire avant de procéder à la compilation du serveur.</p>
206 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
207 <div class="section">
208 <h2><a name="configure" id="configure">Configuration de l'arborescence des sources</a></h2>
210 <p>L'étape suivante consiste à configurer l'arborescence des sources
211 d'Apache en fonction de votre plateforme et de vos besoins personnels.
212 Le script <code class="program"><a href="./programs/configure.html">configure</a></code>, situé à la racine du
213 répertoire de la distribution, a été conçu à cet effet.
214 (Les développeurs qui téléchargent
215 une version non officielle de l'arborescence des sources d'Apache
217 <code>autoconf</code> et <code>libtool</code> et
218 exécuter <code>buildconf</code> avant de passer à l'étape suivante,
219 ce qui n'est pas nécessaire pour les versions officielles.)</p>
221 <p>Pour configurer l'arborescence des sources avec les valeurs par défaut
222 pour toutes les options, entrez simplement <code>./configure</code>.
223 Pour modifier les valeurs des options, <code class="program"><a href="./programs/configure.html">configure</a></code>
224 comprend toute une variété de variables et
225 d'options de ligne de commande.</p>
227 <p>L'option la plus importante <code>--prefix</code> est le chemin
228 du répertoire d'installation d'Apache, car Apache doit être configuré
229 en fonction de ce chemin pour pouvoir fonctionner correctement.
230 Il est possible de définir plus finement le chemin d'installation des fichiers
231 à l'aide d'<a href="programs/configure.html#installationdirectories">
232 options supplémentaires de configure</a>.</p>
234 <p>À ce niveau, vous pouvez aussi spécifier de quelles <a href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous
235 voulez disposer dans Apache en activant ou désactivant des <a href="mod/">modules</a>. Apache est fourni avec un jeu de modules de
236 <a href="mod/module-dict.html#Status">Base</a> inclus par défaut.
237 Les autres modules sont activés à l'aide de l'option
238 <code>--enable-<var>module</var></code>, où
239 <var>module</var> est le nom du module sans la chaîne
240 <code>mod_</code> et où tout caractère de soulignement est converti
241 en tiret. Vous pouvez aussi choisir de compiler les modules comme
242 <a href="dso.html">objets partagés (DSOs)</a> -- qui peuvent être chargés
243 ou déchargés à l'exécution -- à l'aide de l'option
244 <code>--enable-<var>module</var>=shared</code>. D'une manière similaire,
245 vous pouvez désactiver des modules de base à l'aide de l'option
246 <code>--disable-<var>module</var></code> option. Faites très attention
247 en utilisant ces options, car <code class="program"><a href="./programs/configure.html">configure</a></code> n'est pas en
248 mesure de vous avertir si le module que vous avez spécifié n'existe pas;
249 il ignorera tout simplement l'option.</p>
251 <p>En outre, vous devrez peut-être fournir au script
252 <code class="program"><a href="./programs/configure.html">configure</a></code> des informations supplémentaires sur
253 le chemin de votre compilateur, de vos librairies, ou de vos fichiers
254 d'en-têtes. A cet effet, vous pouvez passer des options de ligne de
255 commande ou des variables d'environnement au script
256 <code class="program"><a href="./programs/configure.html">configure</a></code>. Pour plus d'informations, voir la
257 page de manuel de <code class="program"><a href="./programs/configure.html">configure</a></code>. Ou lancez le script
258 <code class="program"><a href="./programs/configure.html">configure</a></code> avec l'option <code>--help</code>.
261 <p>Pour vous faire une idée des possibilités qui s'offrent à vous, voici
262 un exemple typique de compilation d'Apache avec le répertoire
263 d'installation <code>/sw/pkg/apache</code>, un compilateur et des drapeaux
264 particuliers et les deux modules additionnels <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
265 et <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> qui pourront être chargés plus tard
266 à l'aide du mécanisme DSO:</p>
268 <div class="example"><p><code>
269 $ CC="pgcc" CFLAGS="-O2" \<br />
270 ./configure --prefix=/sw/pkg/apache \<br />
271 --enable-rewrite=shared \<br />
272 --enable-speling=shared
275 <p>Quand <code class="program"><a href="./programs/configure.html">configure</a></code> est lancé, il peut prendre
276 plusieurs minutes pour tester la disponibilité des fonctionnalités
277 au sein de votre système, et construire les Makefiles qui seront utilisés
278 par la suite pour compiler le serveur.</p>
280 <p>Vous trouverez une description détaillée des options de
281 <code class="program"><a href="./programs/configure.html">configure</a></code> dans sa page de manuel.</p>
282 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
283 <div class="section">
284 <h2><a name="compile" id="compile">Construction</a></h2>
286 <p>Vous pouvez maintenant construire les différents éléments qui
287 composent le paquet Apache en lançant tout simplement la commande :</p>
289 <div class="example"><p><code>$ make</code></p></div>
291 <p>Vous devez être patient, car il faut plusieurs minutes pour compiler
292 une configuration de base, et cette durée peut varier considérablement
293 en fonction de votre matériel et du nombre de modules que vous avez activés.</p>
294 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
295 <div class="section">
296 <h2><a name="install" id="install">Installation</a></h2>
298 <p>Il est temps maintenant d'installer le paquet dans le répertoire
299 d'installation défini par <em>PREFIX</em> (voir plus haut l'option
300 <code>--prefix</code>) en lançant:</p>
302 <div class="example"><p><code>$ make install</code></p></div>
304 <p>Cette étape nécessite habituellement les privilàges
305 de root, car <em>PREFIX</em> est en général un
306 répertoire possàdant des droits en écriture
309 <p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
310 vos fichiers de configuration ou autres documents.</p>
311 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
312 <div class="section">
313 <h2><a name="customize" id="customize">Personnalisation</a></h2>
315 <p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en
316 éditant les <a href="configuring.html">fichiers de configuration</a>
317 situés dans <code><em>PREFIX</em>/conf/</code>.</p>
319 <div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
321 <p>Consultez le manuel d'Apache situé dans
322 <code><em>PREFIX</em>/docs/manual/</code> ou
323 <a href="http://httpd.apache.org/docs/trunk/">http://httpd.apache.org/docs/trunk/</a> pour la version la plus
324 récente de ce manuel et la liste complète des <a href="mod/directives.html">directives de configuration</a> disponibles.</p>
325 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
326 <div class="section">
327 <h2><a name="test" id="test">Test</a></h2>
329 <p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
330 serveur HTTP Apache en lançant:</p>
332 <div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
334 <p>Vous devriez alors pouvoir requérir votre premier document
335 à l'aide de l'URL <code>http://localhost/</code>. La page web que vous
336 voyez est située dans le répertoire défini par la directive
337 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
338 qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
339 Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>
341 <div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</code></p></div>
342 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
343 <div class="section">
344 <h2><a name="upgrading" id="upgrading">Mise à jour</a></h2>
346 <p>La première étape d'une mise à jour consiste à lire l'annonce de la
347 sortie de la nouvelle version et le fichier <code>CHANGES</code>
348 dans la distribution des sources afin de déceler toutes les modifications
349 qui pourraient affecter votre site. Lors d'un changement majeur de version
350 (par exemple de 1.3 à 2.0 ou de 2.0 à 2.2),
351 il y aura certainement des différences importantes quant à la
352 configuration de la compilation et de l'exécution qui nécessiteront des
353 ajustements manuels. Tous les
354 modules devront aussi être mis à jour pour qu'ils s'adaptent aux
355 changements de l'API des modules.</p>
357 <p>La mise à jour d'une version mineure à la suivante (par exemple, de
358 2.2.55 à 2.2.57) est plus aisée. Le processus <code>make install</code>
359 n'écrasera aucun de vos documents existants, fichiers de log,
360 ou fichiers de configuration. De plus, les développeurs font tout
361 leur possible pour éviter les changements entraînant une
362 incompatibilité dans les options de
363 <code class="program"><a href="./programs/configure.html">configure</a></code>, la configuration de l'exécution, ou l'API
364 des modules d'une version mineure à l'autre. Dans la plupart des cas,
365 vous pourrez utiliser une ligne de commande
366 <code class="program"><a href="./programs/configure.html">configure</a></code> identique, le même fichier de configuration,
367 et tous vos modules continueront de fonctionner.</p>
369 <p>Pour effectuer une mise à jour entre deux versions mineures,
370 commencez par trouver le fichier
371 <code>config.nice</code> dans le répertoire de <code>construction</code>
372 de votre serveur installé ou à la racine de l'arborescence des sources
373 de votre ancienne installation. Il contient la reproduction exacte de la
374 ligne de commande <code class="program"><a href="./programs/configure.html">configure</a></code> que vous avez utilisée pour
375 configurer l'arborescence des sources. Ensuite, pour mettre à jour
376 l'ancienne version vers la nouvelle,
377 il vous suffit de copier le fichier <code>config.nice</code> dans
378 l'arborescence des sources de la nouvelle version, de l'éditer pour
379 effectuer toute modification souhaitée, et de lancer:</p>
381 <div class="example"><p><code>
382 $ ./config.nice<br />
385 $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
386 $ <em>PREFIX</em>/bin/apachectl -k start<br />
389 <div class="warning">Vous devez toujours effectuer un test de la nouvelle
390 version dans votre environnement avant de la mettre en production.
391 Par exemple, vous pouvez installer et exécuter la nouvelle version
392 en parallèle avec l'ancienne en utilisant une option
393 <code>--prefix</code> et un port différents (en ajustant la directive
394 <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>) afin de déceler toute
395 incompatibilité avant d'effectuer la mise à jour définitive.</div>
397 <p>Vous pouvez ajouter des arguments supplémentaires à
398 <code>config.nice</code> ; ils seront alors ajoutés aux options de
399 votre script <code class="program"><a href="./programs/configure.html">configure</a></code> original :</p>
401 <div class="example"><p><code>
402 $ ./config.nice --prefix=/home/test/apache --with-port=90
406 <div class="bottomlang">
407 <p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
408 <a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
409 <a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
410 <a href="./fr/install.html" title="Français"> fr </a> |
411 <a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
412 <a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
413 </div><div id="footer">
414 <p class="apache">Copyright 2008 The Apache Software Foundation.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
415 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>