25
25
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
26
26
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
28
<div class="outofdate">Cette traduction peut �tre p�rim�e. Verifiez la version
29
Anglaise pour les changements r�cents.</div>
32
<p>Ce document couvre la compilation et l'installation d'Apache sur les
33
syst�mes Unix et clones d'Unix. Pour la compilation et l'installation sous
34
Windows, voir <a href="platform/windows.html">Utiliser Apache sous Windows
35
</a>. Pour les autres plates-formes, voir la documentation des <a href="platform/">plates-formes</a>.</p>
37
<p>L'environnement de configuration et d'installation d'Apache 2.0 a �t�
38
compl�tement revu par rapport � celui d'Apache 1.3. Apache 1.3 utilisait un
39
ensemble de scripts pour permettre une installation facile. Apache 2.0
40
utilise � pr�sent <code>libtool</code> et <code>autoconf</code> afin de
41
cr�er un environnement le plus proche possible d'autres projets
44
<p>Si vous faite une mise � niveau d'une version mineure � la suivante (par
45
exemple, de 2.0.50 � 2.0.51), veuillez s'il vous pla�t passer directement �
46
la section <a href="#upgrading">Mise � niveau</a>.</p>
30
<p>Ce document couvre l'installation et la compilation du serveur
32
sur les syst�mes Unix et similaires seulement. Pour la compilation et
33
l'installation sous Windows, voir <a href="platform/windows.html">Utiliser Apache HTTPd avec Microsoft
34
Windows</a>. Pour les autres plateformes, se r�f�rer � la documentation par
35
<a href="platform/">plateforme</a>.</p>
37
<p>Apache HTTPd utilise <code>libtool</code> et <code>autoconf</code>
38
afin de cr�er un environnement de construction similaire � la plupart
39
des projets Open Source .</p>
41
<p>Si vous effectuez une mise � jour depuis une version mineure vers
42
la suivante (par exemple, 2.2.50 � 2.2.51), veuillez passer � la section
43
<a href="#upgrading">mise � jour</a>.</p>
49
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Survol Rapide pour les
51
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Pr�-requis</a></li>
52
<li><img alt="" src="./images/down.gif" /> <a href="#download">T�l�charger</a></li>
53
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Extraire</a></li>
54
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Configurer l'arborescence source</a></li>
55
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Compiler</a></li>
56
<li><img alt="" src="./images/down.gif" /> <a href="#install">Installer</a></li>
57
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Personnaliser la Configuration</a></li>
58
<li><img alt="" src="./images/down.gif" /> <a href="#test">Tester</a></li>
59
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Mise � niveau</a></li>
60
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="programs/configure.html">Configurer l'arborescence source</a></li><li><a href="invoking.html">D�marrage d'Apache</a></li><li><a href="stopping.html">Arr�t et Red�marrage</a></li></ul></div>
46
<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>
47
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Pr�requis</a></li>
48
<li><img alt="" src="./images/down.gif" /> <a href="#download">T�l�chargement</a></li>
49
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Extraction</a></li>
50
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuration de l'arborescence des sources</a></li>
51
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Construction</a></li>
52
<li><img alt="" src="./images/down.gif" /> <a href="#install">Installation</a></li>
53
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Personnalisation</a></li>
54
<li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li>
55
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Mise � jour</a></li>
56
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="programs/configure.html">Configuration de l'arborescence
57
des sources</a></li><li><a href="invoking.html">D�marrer le serveur HTTP Apache</a></li><li><a href="stopping.html">Arr�t et red�marrage</a></li></ul></div>
61
58
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
62
59
<div class="section">
63
<h2><a name="overview" id="overview">Survol Rapide pour les
60
<h2><a name="overview" id="overview">Aper�u pour les plus press�s</a></h2>
69
<td><a href="#download">T�l�charger</a></td>
65
<td><a href="#download">T�l�chargement</a></td>
71
67
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
76
<td><a href="#extract">Extraire</a></td>
72
<td><a href="#extract">Extraction</a></td>
78
<td><code>$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
79
$ tar xvf httpd-2_1_<em>NN</em>.tar</code> </td>
74
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
75
$ tar xvf httpd-<em>NN</em>.tar<br />
76
$ cd httpd-<em>NN</em></code></td>
83
<td><a href="#configure">Configurer</a></td>
80
<td><a href="#configure">Configuration</a></td>
85
82
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
90
<td><a href="#compile">Compiler</a></td>
87
<td><a href="#compile">Compilation</a></td>
92
89
<td><code>$ make</code> </td>
96
<td><a href="#install">Installer</a></td>
93
<td><a href="#install">Installation</a></td>
98
95
<td><code>$ make install</code> </td>
102
<td><a href="#customize">Personnaliser</a></td>
99
<td><a href="#customize">Personnalisation</a></td>
104
101
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
108
<td><a href="#test">Tester</a></td>
105
<td><a href="#test">Test</a></td>
110
<td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
107
<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
115
<p><em>NN</em> doit �tre remplac� par le num�ro de version mineure actuel, et
116
<em>PREFIX</em> par le chemin o� le serveur doit �tre install�. Si
117
<em>PREFIX</em> n'est pas sp�cifi�, l'installation se fait dans
112
<p><em>NN</em> doit �tre remplac� par le num�ro de version courant,
113
et <em>PREFIX</em> par le
114
chemin du r�pertoire d'installation. Si
115
<em>PREFIX</em> n'est pas sp�cifi�, le chemin du r�pertoire
116
d'installation prendra sa valeur par d�faut, � savoir
118
117
<code>/usr/local/apache2</code>.</p>
120
<p>Chacune des sections du processus de compilation et d'installation est
121
d�crite ci-apr�s, en commen�ant par les pr�-requis � la compilation et �
122
l'installation d'Apache HTTPD.</p>
119
<p>Chaque �tape du processus de compilation et d'installation est
120
d�crite plus en d�tails ci-dessous, � commencer par les pr�requis
121
pour compiler et installer le serveur HTTP Apache.</p>
123
122
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
124
123
<div class="section">
125
<h2><a name="requirements" id="requirements">Pr�-requis</a></h2>
124
<h2><a name="requirements" id="requirements">Pr�requis</a></h2>
127
<p>Les pr�-requis suivants sont n�cessaire pour l'installation d'Apache:</p>
126
<p>Les pr�requis pour la construction d'Apache HTTPd sont les suivants:</p>
130
<dt>Espace Disque</dt>
131
<dd>Au moins 50 Mo d'espace disque temporaire sont n�cessaires. Apr�s
132
installation, Apache occupe environ 10 Mo sur le disque. L'espace disque
133
occup� par une installation compl�te d�pend beaucoup de la configuration
134
du serveur, ainsi que de la pr�sence �ventuelle de modules tiers.</dd>
136
<dt>Compilateur C ANSI et Build</dt>
137
<dd>Un compilateur C ANSI doit �tre utilis�. Le <a href="http://www.gnu.org/software/gcc/gcc.html">compilateur C GNU
138
(GCC)</a> de la <a href="http://www.gnu.org/">Free Software Foundation
139
(FSF)</a> est recommand� (la version 2.7.2 convient). En cas
140
d'absence de GCC, v�rifiez que le compilateur fourni avec l'architecture
141
utilis�e est conforme aux normes ANSI. De plus, les outils de constructions
142
de base, tel <code>make</code>, doivent �tre pr�sents dans votre
143
<code>PATH</code>.</dd>
145
<dt>S'assurer que la machine est et reste � l'heure</dt>
146
<dd>Certains �l�ments du protocole HTTP sont exprim�s en tant qu'heure de
147
la journ�e. Aussi est-il important de s'assurer que le syst�me o� Apache
148
doit tourner dispose de m�canismes de synchronisation temporelle. En
149
g�n�ral, les programmes <code>ntpdate</code> ou <code>xntpd</code> sont
150
utilis�s; ces programmes impl�mentent le Network Time Protocol (NTP).
151
Voir le groupe Usenet <a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a> et la <a href="http://www.eecis.udel.edu/~ntp/">page NTP</a> pour plus de d�tails
152
sur les logiciels NTP et les serveurs de temps publics.</dd>
129
<dt>Espace disque</dt>
130
<dd>Assurez-vous d'avoir au moins 50 MB d'espace disque disponible
131
temporaire. Apr�s l'installation Apache occupe
132
approximativement 10 MB d'espace disque. L'espace disque r�ellement
133
n�cessaire va varier consid�rablement en fonction de vos options
134
de configuration et de la pr�sence �ventuelle de modules tiers.</dd>
136
<dt>Compilateur ANSI-C et syst�me de construction</dt>
137
<dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
138
(GCC)</a> de la <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
139
est recommand�. Si vous ne poss�dez pas GCC,
140
assurez-vous au moins que votre compilateur soit compatible ANSI.
141
En outre, votre <code>PATH</code> doit contenir
142
les outils de construction de base tels que <code>make</code>.</dd>
144
<dt>Connaissance de l'heure exacte</dt>
145
<dd>Les �l�ments du protocole HTTP font r�f�rence � l'heure du jour.
146
Par cons�quent, il est n�cessaire d'�quiper votre syst�me d'un
147
dispositif de synchronisation du temps. Les programmes
148
<code>ntpdate</code> ou <code>xntpd</code>, bas�s sur le protocole NTP,
149
sont couramment utilis�s � cet effet.
150
Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a>
151
pour plus de d�tails � propos du logiciel NTP et des serveurs
152
de temps publics.</dd>
154
154
<dt><a href="http://www.perl.org/">Perl 5</a>
156
<dd>Certains des scripts fournis avec Apache, tel <a href="programs/apxs.html">apxs</a> ou <a href="programs/dbmmanage.html">dbmmanage</a> (qui sont �crits en
157
Perl) n�cessitent l'interpr�teur Perl 5 (version 5.003 ou sup�rieure).
158
Au cas o� le script <code>configure</code> ne trouve pas d'interpr�teur
159
Perl, la compilation sera quand m�me r�alis�e sans souci. Seuls ces
160
scripts ne seront pas utilisables. Si plusieurs interpr�teurs Perl sont
161
install�s (par exemple, Perl 4 fourni avec l'OS, et Perl 5 install� par
162
l'administrateur), il est conseill� de passer l'option
163
<code>--with-perl</code> afin de garantir que le bon interpr�teur est
164
utilis� par <code>./configure</code>.</dd>
156
<dd>L'interpr�teur Perl 5 (les versions 5.003 ou sup�rieures conviennent)
157
est n�cessaire pour l'ex�cution de certains scripts comme
158
<code class="program"><a href="./programs/apxs.html">apxs</a></code> ou <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code>
159
(qui sont �crits en Perl). Si vous disposez de plusieurs interpr�teurs
160
Perl (par exemple, une installation globale Perl 4, et
161
votre installation personnelle de Perl 5), il vous faut utiliser l'option
162
<code>--with-perl</code> (voir ci-dessous) afin de vous assurer que le
163
bon interpr�teur sera utilis� par <code class="program"><a href="./programs/configure.html">configure</a></code>.
164
Si le script <code class="program"><a href="./programs/configure.html">configure</a></code> ne trouve pas d'interpr�teur
165
Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin.
166
Bien entendu, vous pourrez tout de m�me construire et utiliser
169
<dt><a href="http://apr.apache.org">apr/apr-util >= 1.2</a></dt>
170
<dd><code>apr</code> et <code>apr-util</code> sont inclus
171
dans les sources d'Apache HTTPd, et peuvent �tre utilis�s sans probl�me
172
dans la plupart des cas. Cependant, si
173
<code>apr</code> ou <code>apr-util</code>, versions 1.0 ou 1.1,
174
sont install�s sur votre syst�me, vous devez soit mettre � jour vos
175
installations <code>apr</code>/<code>apr-util</code> vers la version
176
1.2, soit faire en sorte que httpd utilise des constructions s�par�es.
177
Pour utiliser les sources incluses
178
<code>apr</code>/<code>apr-util</code> de cette mani�re, vous devez
179
les installer manuellement :
181
<div class="example"><p><code>
182
# Construction et installation apr 1.2<br />
184
./configure --prefix=/usr/local/apr-httpd/<br />
188
# Construction et installation apr-util 1.2<br />
190
./configure --prefix=/usr/local/apr-util-httpd/
191
--with-apr=/usr/local/apr-httpd/<br />
195
# Configuration httpd<br />
197
./configure --with-apr=/usr/local/apr-httpd/
198
--with-apr-util=/usr/local/apr-util-httpd/
166
204
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
167
205
<div class="section">
168
<h2><a name="download" id="download">T�l�charger</a></h2>
170
<p>Apache est t�l�chargeable depuis le <a href="http://httpd.apache.org/download.cgi">site de t�l�chargement
171
d'Apache</a> qui fournit la liste de plusieurs miroirs. L� sont disponibles
172
les derni�res versions. La plupart des
173
utilisateurs d'Apache sur des syst�mes de type Unix devraient
174
probablement t�l�charger et compiler une version � partir du code source.
175
Le processus de construction (d�crit ci-dessous) est facile et
176
vous permet d'adapter votre serveur pour convenir � vos besoins.
177
En outre, les versions binaires ne sont souvent pas � jour avec
178
les derni�res versions du code source. Si vous t�l�chargez une
179
version binaire, suivez les instructions dans le dossier
180
<code>INSTALL.bindist</code> � l'int�rieur de la distribution.</p>
182
<p>Apr�s le t�l�chargement, il est important de v�rifier que les sources
183
t�l�charg�es sont bien compl�tes et non modifi�es, et ce surtout si un
184
miroir a �t� utilis� pour le t�l�chargement. Ceci peut �tre fait en
185
testant l'archive tar t�l�charg�e avec la signature PGP. Cette proc�dure
186
s'effectue en 2 �tapes. D'abord, il faut r�cup�rer le fichier <a href="http://www.apache.org/dist/httpd/KEYS"><code>KEYS</code></a> du site
187
de distribution d'Apache. (Pour v�rifier que ce fichier <code>KEYS</code>
188
n'a pas �t� modifi�, une bonne id�e peut �tre d'utiliser un fichier d'une
189
distribution pr�c�dente d'Apache ou d'importer les cl�s d'un serveur de
190
cl�s public.) Les cl�s peuvent �tre import�es dans le keyring de
191
l'utilisateur au moyen d'une des commandes (selon la version de PGP):</p>
193
<div class="example"><p><code>$ pgp < KEYS</code></p></div>
197
<div class="example"><p><code>$ gpg --import KEYS</code></p></div>
199
<p>La prochaine �tape est de tester l'archive tar au moyen de la signature
200
PGP, qui devrait toujours �tre disponible sur le <a href="http://httpd.apache.org/download.cgi">site principal d'Apache</a>.
201
Un lien vers cette signature est plac� derri�re le lien de t�l�chargement
202
correspondant ou peut �tre trouv� dans le r�pertoire correspondant sur <a href="http://www.apache.org/dist/httpd/">le site de distribution
203
d'Apache</a>. Le nom de ce fichier est le m�me que celui de l'archive
204
source, avec en plus l'extension <code>.asc</code>. La distribution
205
t�l�charg�e peut alors �tre v�rifi�e au moyen de la commande (� nouveau,
206
selon la version de PGP):</p>
208
<div class="example"><p><code>$ pgp httpd-2_1_<em>NN</em>.tar.gz.asc</code></p></div>
212
<div class="example"><p><code>$ gpg --verify httpd-2_1_<em>NN</em>.tar.gz.asc</code></p></div>
214
<p>Un message comme celui-ci devrait s'afficher</p>
216
<div class="example"><p><code>Good signature from user "Martin Kraemer
217
<martin@apache.org>".</code></p></div>
219
<p>Selon les relations de confiances contenues dans le keyring de
220
l'utilisateur, un message peut s'afficher, sp�cifiant que la relation entre
221
la cl� et le signataire ne peut �tre v�rifi�e. Ceci n'est pas un probl�me si
222
vous ne mettez pas en doute l'authenticit� du fichier <code>KEYS</code>.</p>
206
<h2><a name="download" id="download">T�l�chargement</a></h2>
208
<p>Le serveur HTTP Apache peut �tre t�l�charg� � partir du
209
<a href="http://httpd.apache.org/download.cgi">site de t�l�chargement
210
du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs.
211
Il sera plus commode � la plupart des utilisateurs d'Apache HTTPd sur les
212
syst�mes UNIX ou similaires de t�l�charger et de compiler
213
la version sources. Le processus de construction (d�crit ci-dessous) est
214
simple, et vous permet de personnaliser votre serveur selon vos besoins.
215
En outre, les versions binaires sont souvent plus anciennes que les
216
derni�res versions sources Si vous t�l�chargez une version binaire,
217
suivez les instructions d�crites dans le fichier
218
<code>INSTALL.bindist</code> inclus dans la distribution.</p>
220
<p>Apr�s le t�l�chargement, il est important de v�rifier que vous
221
disposez d'une version compl�te et non modifi�e du serveur HTTP Apache.
222
Vous pouvez le faire en testant l'archive t�l�charg�e � l'aide de
223
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
223
226
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
224
227
<div class="section">
225
<h2><a name="extract" id="extract">Extraire</a></h2>
228
<h2><a name="extract" id="extract">Extraction</a></h2>
227
<p>Extraire les sources � partir de l'archive tar est une simple affaire de
228
d�compression et d'extraction tar:</p>
230
<p>L'extraction des sources depuis l'archive Apache HTTPd consiste
231
simplement � d�compresser et � d�sarchiver cette derni�re :</p>
230
233
<div class="example"><p><code>
231
$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
232
$ tar xvf httpd-2_1_<em>NN</em>.tar
234
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
235
$ tar xvf httpd-<em>NN</em>.tar
233
236
</code></p></div>
235
<p>Un nouveau r�pertoire est cr�� dans le r�pertoire courant, il contient le
236
code source de la distribution. Il faut aller dans ce r�pertoire au moyen
237
de la commande <code>cd</code> avant de commencer la compilation du
238
<p>Ceci cr�era, dans le r�pertoire courant, un nouveau r�pertoire
239
contenant le code source de la distribution. Vous devrez vous positionner
240
dans ce r�pertoire avant de proc�der � la compilation du serveur.</p>
239
241
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
240
242
<div class="section">
241
<h2><a name="configure" id="configure">Configurer l'arborescence source</a></h2>
243
<p>L'�tape suivante est la configuration de l'arborescence source d'Apache,
244
pour votre plate-forme et selon les n�cessit�s du site. Cette configuration est
245
r�alis�e au moyen du script <code>configure</code> fourni dans le
246
r�pertoire racine de la distribution. (Les d�veloppeurs qui t�l�chargent
247
Apache via CVS devront utiliser les outils <code>autoconf</code> et
248
<code>libtool</code> avant de passer � la suite. Ceci n'est pas n�cessaire
249
pour les versions officielles.)</p>
251
<p>Pour configurer l'arborescence source en utilisant les options par
252
d�faut, tapez <code>./configure</code>. Pour modifier les valeurs des
253
options par d�faut, <code>configure</code> accepte un grand nombre de
254
variables et d'options de ligne de commande. </p>
256
<p>La plus importante de ces options est le chemin du r�pertoire o�
257
Apache sera install�,
258
car Apache doit �tre configur� pour que cet emplacement fonctionne
259
correctement. Plusieurs autres options sont disponibles pour
260
le contr�le fin de l'emplacement des fichiers r�sultants avec <a href="programs/configure.html#installationdirectories">options de
261
configuration</a>.</p>
263
<p>En outre, � ce moment, vous pouvez indiquer quels <a href="programs/configure.html#optionalfeatures">fonctionnalit�s</a>
264
vous voulez inclure dans Apache en ajoutant et/ou en retranchant
265
des <a href="mod/">modules</a>. Apache vient avec un ensemble
266
de modules de <a href="mod/module-dict.html#Status">Base</a>
267
inclus par d�faut. D'autres modules peuvent �tre ajout�s en utilisant
268
l'option <code>--enable-<var>module</var></code>, o�
269
<var>module</var> est le nom du module avec la cha�ne
270
<code>mod_</code> coup�e et avec les caract�res de soulignement
271
convertis en tirets. Vous pouvez �galement choisir de compiler
272
des modules en tant qu'<a href="dso.html">objets partag�s (DSOs)</a>,
273
qui peuvent �tre charg�s ou d�charg� � l'ex�cution -- en employant
274
l'option <code>--enable-<var>module</var>=shared</code>.
275
De m�me, vous pouvez retrancher les modules de Base avec l'option
276
<code>--disable-<var>module</var></code>. Prenez garde lorsque
277
vous employez ces options, puisque <code>configure</code> ne peut
278
vous informer si le module cible n'existe pas; <code>configure</code>
279
ignorera simplement l'option.</p>
281
<p>Il est parfois n�cessaire de fournir des
282
informations suppl�mentaires au script
283
<code>configure</code> sur l'emplacement de vos
284
compilateur, biblioth�ques ou dossiers d'en-t�te. Ceci se fait en
285
passant les variables d'environnement ou des options incluses sur la ligne
286
de commande � <code>configure</code>. Pour plus d'information
287
sur ce sujet, consultez la page de documentation
288
<a href="programs/configure.html">configurer</a>.</p>
290
<p>L'exemple suivant compile Apache pour �tre install�
291
dans <code>/sw/pkg/apache</code> avec un
292
compilateur et des options de compilation particuli�res, ainsi que les deux
293
modules <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> et <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code>, qui
294
pourront �tre charg�s plus tard au moyen des m�canismes DSO:</p>
243
<h2><a name="configure" id="configure">Configuration de l'arborescence des sources</a></h2>
245
<p>L'�tape suivante consiste � configurer l'arborescence des sources
246
d'Apache HTTPd en fonction de votre plateforme et de vos besoins personnels.
247
Le script <code class="program"><a href="./programs/configure.html">configure</a></code>, situ� � la racine du
248
r�pertoire de la distribution, a �t� con�u � cet effet.
249
(Les d�veloppeurs qui t�l�chargent
250
une version non officielle de l'arborescence des sources d'Apache HTTPd
252
<code>autoconf</code> et <code>libtool</code> et
253
ex�cuter <code>buildconf</code> avant de passer � l'�tape suivante,
254
ce qui n'est pas n�cessaire pour les versions officielles.)</p>
256
<p>Pour configurer l'arborescence des sources avec les valeurs par d�faut
257
pour toutes les options, entrez simplement <code>./configure</code>.
258
Pour modifier les valeurs des options, <code class="program"><a href="./programs/configure.html">configure</a></code>
259
comprend toute une vari�t� de variables et
260
d'options de ligne de commande.</p>
262
<p>L'option la plus importante <code>--prefix</code> est le chemin
263
du r�pertoire d'installation du serveur HTTP Apache, car Apache doit �tre configur�
264
en fonction de ce chemin pour pouvoir fonctionner correctement.
265
Il est possible de d�finir plus finement le chemin d'installation des fichiers
266
� l'aide d'<a href="programs/configure.html#installationdirectories">
267
options suppl�mentaires de configure</a>.</p>
269
<p>� ce niveau, vous pouvez aussi sp�cifier de quelles <a href="programs/configure.html#optionalfeatures">fonctionnalit�s</a> vous
270
voulez disposer dans Apache HTTPd en activant ou d�sactivant des <a href="mod/">modules</a>. Apache est fourni avec un jeu de modules de
271
<a href="mod/module-dict.html#Status">Base</a> inclus par d�faut.
272
Les autres modules sont activ�s � l'aide de l'option
273
<code>--enable-<var>module</var></code>, o�
274
<var>module</var> est le nom du module sans la cha�ne
275
<code>mod_</code> et o� tout caract�re de soulignement est converti
276
en tiret. Vous pouvez aussi choisir de compiler les modules comme
277
<a href="dso.html">objets partag�s (DSOs)</a> -- qui peuvent �tre charg�s
278
ou d�charg�s � l'ex�cution -- � l'aide de l'option
279
<code>--enable-<var>module</var>=shared</code>. D'une mani�re similaire,
280
vous pouvez d�sactiver des modules de base � l'aide de l'option
281
<code>--disable-<var>module</var></code> option. Faites tr�s attention
282
en utilisant ces options, car <code class="program"><a href="./programs/configure.html">configure</a></code> n'est pas en
283
mesure de vous avertir si le module que vous avez sp�cifi� n'existe pas;
284
il ignorera tout simplement l'option.</p>
286
<p>En outre, vous devrez peut-�tre fournir au script
287
<code class="program"><a href="./programs/configure.html">configure</a></code> des informations suppl�mentaires sur
288
le chemin de votre compilateur, de vos librairies, ou de vos fichiers
289
d'en-t�tes. A cet effet, vous pouvez passer des options de ligne de
290
commande ou des variables d'environnement au script
291
<code class="program"><a href="./programs/configure.html">configure</a></code>. Pour plus d'informations, voir la
292
page de manuel de <code class="program"><a href="./programs/configure.html">configure</a></code>.</p>
294
<p>Pour vous faire une id�e des possibilit�s qui s'offrent � vous, voici
295
un exemple typique de compilation d'Apache avec le r�pertoire
296
d'installation <code>/sw/pkg/apache</code>, un compilateur et des drapeaux
297
particuliers et les deux modules additionnels <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
298
et <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> qui pourront �tre charg�s plus tard
299
� l'aide du m�canisme DSO:</p>
296
301
<div class="example"><p><code>
297
302
$ CC="pgcc" CFLAGS="-O2" \<br />
300
305
--enable-speling=shared
301
306
</code></p></div>
303
<p>Une fois lanc�, <code>configure</code> peut prendre quelques minutes
304
pour tester les possibilit�s du syst�me et produire les fichiers
305
<code>Makefile</code> qui seront utilis�s pour construire le serveur.</p>
308
<p>Quand <code class="program"><a href="./programs/configure.html">configure</a></code> est lanc�, il peut prendre
309
plusieurs minutes pour tester la disponibilit� des fonctionnalit�s
310
au sein de votre syst�me, et construire les Makefiles qui seront utilis�s
311
par la suite pour compiler le serveur.</p>
307
<p>Les d�tails de toutes les options <code>configure</code> sont
308
disponibles sur la page de documentation <a href="programs/configure.html">configurer</a>.</p>
313
<p>Vous trouverez une description d�taill�e des options de
314
<code class="program"><a href="./programs/configure.html">configure</a></code> dans sa page de manuel.</p>
309
315
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
310
316
<div class="section">
311
<h2><a name="compile" id="compile">Compiler</a></h2>
317
<h2><a name="compile" id="compile">Construction</a></h2>
313
<p>Les diff�rents composants d'Apache sont � pr�sent pr�ts �
314
�tre compil�s, en tapant simplement la commande:</p>
319
<p>Vous pouvez maintenant construire les diff�rents �l�ments qui
320
composent le paquet Apache HTTPd en lan�ant tout simplement la commande :</p>
316
322
<div class="example"><p><code>$ make</code></p></div>
318
<p>Un peu de patience est requise, une configuration standard met environ 3
319
minutes � compiler sur un Pentium III sous Linux 2.2. Ce temps peut
320
varier largement suivant le mat�riel utilis� et les modules
324
<p>Vous devez �tre patient, car il faut plusieurs minutes pour compiler
325
une configuration de base, et cette dur�e peut varier consid�rablement
326
en fonction de votre mat�riel et du nombre de modules que vous avez activ�s.</p>
322
327
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
323
328
<div class="section">
324
<h2><a name="install" id="install">Installer</a></h2>
329
<h2><a name="install" id="install">Installation</a></h2>
326
<p>Il est temps d'installer le 'package' dans le r�pertoire d'installation
327
<em>PREFIX</em> configur� auparavant (voir l'option <code>--prefix</code>
328
ci-dessus) en tapant:</p>
331
<p>Il est temps maintenant d'installer le paquet dans le r�pertoire
332
d'installation d�fini par <em>PREFIX</em> (voir plus haut l'option
333
<code>--prefix</code>) en lan�ant:</p>
330
335
<div class="example"><p><code>$ make install</code></p></div>
332
<p>En cas de mise � jour, l'installation n'�crasera ni les fichiers de
333
configuration du serveur, ni ses documents.</p>
337
<p>Si vous effectuez une mise � jour, l'installation n'�crasera pas
338
vos fichiers de configuration ou autres documents.</p>
334
339
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
335
340
<div class="section">
336
<h2><a name="customize" id="customize">Personnaliser la Configuration</a></h2>
341
<h2><a name="customize" id="customize">Personnalisation</a></h2>
338
<p>Il reste � pr�sent � configurer le serveur HTTP Apache, en �ditant les
339
<a href="configuring.html">fichiers de configuration</a> plac�s dans
340
<code><em>PREFIX</em>/conf/</code>.</p>
343
<p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en
344
�ditant les <a href="configuring.html">fichiers de configuration</a>
345
situ�s dans <code><em>PREFIX</em>/conf/</code>.</p>
342
347
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
344
<p>A consulter : le manuel d'Apache dans
345
<a href="./">docs/manual/</a> ou bien <a href="http://httpd.apache.org/docs/2.2/">http://httpd.apache.org/docs/2.2/</a> pour la derni�re
346
version de ce manuel, ainsi qu'une r�f�rence compl�te de
348
<a href="mod/directives.html">directives de configuration</a>.</p>
349
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
350
<div class="section">
351
<h2><a name="test" id="test">Tester</a></h2>
353
<p>Une fois configur�, le serveur HTTP Apache peut �tre
354
<a href="invoking.html">d�marr�</a> en tapant:</p>
356
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl start</code></p></div>
358
<p>Vous devriez alors pouvoir tester l'URL <code>http://localhost/</code>.
359
La page affich�e se trouve dans le r�pertoire
360
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>, habituellement configur�
361
en tant que <code><em>PREFIX</em>/htdocs/</code>.
362
Le serveur peut �tre <a href="stopping.html">arr�t�</a> en tapant:</p>
364
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl stop</code></p></div>
365
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
366
<div class="section">
367
<h2><a name="upgrading" id="upgrading">Mise � niveau</a></h2>
369
<p>La premi�re �tape pour une mise � niveau est de lire
370
l'annonce de la nouvelle version et le fichier <code>CHANGES</code>
371
dans la distribution afin de trouver tous les changements qui
372
peuvent affecter votre site. Si la mise � jour est effectu�e
373
entre deux versions principales (par exemple, de 1.3 � 2.0 ou
374
de 2.0 � 2.2), attendez-vous � des diff�rences majeures
375
au moment de la compilation et de l'ex�cution, exigeant probablement
376
des ajustements manuels. Tous les modules devront �galement
377
�tre mis � niveau pour tenir compte des changements de l'API.</p>
379
<p>La mise � niveau d'une version mineure � une plus r�cente
380
(par exemple, de 2.0.55 � 2.0.57) est plus facile. Le processus
381
<code>make install</code> n'�crasera aucun de vos documents,
382
fichiers journaux, ou fichiers de configuration existants.
383
En outre, les d�veloppeurs font tous les efforts possibles
384
pour �viter les changements incompatibles des options
385
<code>configure</code>, de la configuration d'ex�cution,
386
ou de l'API entre les versions mineures. Dans la plupart
387
des cas vous devriez pouvoir employer une ligne de commande
388
<code>configure</code> et un fichier de configuration
389
identiques. De plus, tous vos modules devraient continuer � fonctionner.
390
(Ceci ne vaut que pour les versions post�rieures � 2.0.41;
391
les versions ant�rieures ont des changements incompatibles.)</p>
393
<p>Si vous avez gard� l'arborescence source de votre derni�re
394
installation, la mise � niveau est encore plus facile.
395
Le dossier <code>config.nice</code> dans la racine de l'ancienne
396
arborescence contient la ligne de commande <code>configure</code>
397
exacte que vous avez utilis�e pour configurer l'arborescence des
398
sources. Pour faire la mise � niveau d'une version � la suivante,
399
vous devez copier le dossier <code>config.nice</code> dans
400
l'arborescence des sources de la nouvelle version, l'�diter
401
pour faire les changements d�sir�s, puis ex�cuter:</p>
349
<p>Consultez le manuel du serveur HTTP Apache situ� dans
350
<a href="./">docs/manual/</a> ou
351
<a href="http://httpd.apache.org/docs/2.2/">http://httpd.apache.org/docs/2.2/</a> pour la version la plus
352
r�cente de ce manuel et la liste compl�te des <a href="mod/directives.html">directives de configuration</a> disponibles.</p>
353
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
354
<div class="section">
355
<h2><a name="test" id="test">Test</a></h2>
357
<p>Vous pouvez maintenant <a href="invoking.html">d�marrer</a> votre
358
Serveur HTTP Apache en lan�ant:</p>
360
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
362
<p>Vous devriez alors pouvoir requ�rir votre premier document
363
� l'aide de l'URL <code>http://localhost/</code>. La page web que vous
364
voyez est situ�e dans le r�pertoire d�fini par la directive
365
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
366
qui est g�n�ralement <code><em>PREFIX</em>/htdocs/</code>.
367
Pour <a href="stopping.html">arr�ter</a> le serveur, lancez:</p>
369
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</code></p></div>
370
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
371
<div class="section">
372
<h2><a name="upgrading" id="upgrading">Mise � jour</a></h2>
374
<p>La premi�re �tape d'une mise � jour consiste � lire l'annonce de la
375
sortie de la nouvelle version et le fichier <code>CHANGES</code>
376
dans la distribution des sources afin de d�celer toutes les modifications
377
qui pourraient affecter votre site. Lors d'un changement majeur de version
378
(par exemple de 1.3 � 2.0 ou de 2.0 � 2.2),
379
il y aura certainement des diff�rences importantes quant � la
380
configuration de la compilation et de l'ex�cution qui n�cessiteront des
381
ajustements manuels. Tous les
382
modules devront aussi �tre mis � jour pour qu'ils s'adaptent aux
383
changements de l'API des modules.</p>
385
<p>La mise � jour d'une version mineure � la suivante (par exemple, de
386
2.2.55 � 2.2.57) est plus ais�e. Le processus <code>make install</code>
387
n'�crasera aucun de vos documents existants, fichiers de log,
388
ou fichiers de configuration. De plus, les d�veloppeurs font tout
389
leur possible pour �viter les changements entra�nant une
390
incompatibilit� dans les options de
391
<code class="program"><a href="./programs/configure.html">configure</a></code>, la configuration de l'ex�cution, ou l'API
392
des modules d'une version mineure � l'autre. Dans la plupart des cas,
393
vous pourrez utiliser une ligne de commande
394
<code class="program"><a href="./programs/configure.html">configure</a></code> identique, le m�me fichier de configuration,
395
et tous vos modules continueront de fonctionner.</p>
397
<p>Pour effectuer une mise � jour entre deux versions mineures,
398
commencez par trouver le fichier
399
<code>config.nice</code> dans le r�pertoire de <code>construction</code>
400
de votre serveur install� ou � la racine de l'arborescence des sources
401
de votre ancienne installation. Il contient la reproduction exacte de la
402
ligne de commande <code class="program"><a href="./programs/configure.html">configure</a></code> que vous avez utilis�e pour
403
configurer l'arborescence des sources. Ensuite, pour mettre � jour
404
l'ancienne version vers la nouvelle,
405
il vous suffit de copier le fichier <code>config.nice</code> dans
406
l'arborescence des sources de la nouvelle version, de l'�diter pour
407
effectuer toute modification souhait�e, et de lancer:</p>
403
409
<div class="example"><p><code>
404
410
$ ./config.nice<br />
406
412
$ make install<br />
407
$ <em>PREFIX</em>/bin/apachectl stop<br />
408
$ <em>PREFIX</em>/bin/apachectl start<br />
413
$ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
414
$ <em>PREFIX</em>/bin/apachectl -k start<br />
409
415
</code></p></div>
411
<div class="warning">Vous devriez toujours essayer une
412
nouvelle version dans un environnement de test avant de la
413
mettre dans un environnement de production. Par exemple, vous pouvez
414
installer et ex�cuter la nouvelle version c�te � c�te avec l'ancienne
415
en employant un <code>--prefix</code> et un port diff�rents
416
(ce qui est possible en ajustant la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>)
417
dans le but de tester toutes les incompatibilit�s possibles avant de
418
faire la mise � niveau finale.</div>
417
<div class="warning">Vous devez toujours effectuer un test de la nouvelle
418
version dans votre environnement avant de la mettre en production.
419
Par exemple, vous pouvez installer et ex�cuter la nouvelle version
420
en parall�le avec l'ancienne en utilisant une option
421
<code>--prefix</code> et un port diff�rents (en ajustant la directive
422
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>) afin de d�celer toute
423
incompatibilit� avant d'effectuer la mise � jour d�finitive.</div>
420
426
<div class="bottomlang">
421
427
<p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
422
428
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
added
removed
docs/manual/install.html.fr
