docs/manual/install.xml.fr - httpd - Git at Google

 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- English Revision: 1772232 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->

 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
 -->

 <manualpage metafile="install.xml.meta">

   <title>Compilation et installation</title>

 <summary>

     <p>Ce document couvre l'installation et la compilation du serveur
     HTTP Apache
     sur les systèmes Unix et similaires seulement. Pour la compilation et
     l'installation sous Windows, voir <a
     href="platform/windows.html">Utiliser Apache HTTPd avec Microsoft
     Windows</a>. Pour les autres plateformes, se référer à la documentation par
      <a href="platform/">plateforme</a>.</p>

     <p>Apache HTTPd utilise <code>libtool</code> et <code>autoconf</code>
     afin de créer un environnement de construction similaire à la plupart
     des projets Open Source .</p>

     <p>Si vous effectuez une mise à jour depuis une version mineure vers
     la suivante (par exemple, 2.2.50 à 2.2.51), veuillez passer à la section
     <a href="#upgrading">mise à jour</a>.</p>

 </summary>

 <seealso><a href="programs/configure.html">Configuration de l'arborescence
 	des sources</a></seealso>
 <seealso><a href="invoking.html">Démarrer le serveur HTTP Apache</a></seealso>
 <seealso><a href="stopping.html">Arrêt et redémarrage</a></seealso>

 <section id="overview"><title>Aperçu pour les plus pressés</title>

     <table>
       <columnspec><column width=".13"/><column width=".80"/></columnspec>
       <tr>
         <td><a href="#download">Téléchargement</a></td>

         <td>Download the latest release from <a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a>
         </td>
       </tr>

       <tr>
         <td><a href="#extract">Extraction</a></td>

         <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
          $ tar xvf httpd-<em>NN</em>.tar<br />
          $ cd httpd-<em>NN</em></code></td>
       </tr>

       <tr>
         <td><a href="#configure">Configuration</a></td>

         <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
         </td>
       </tr>

       <tr>
         <td><a href="#compile">Compilation</a></td>

         <td><code>$ make</code> </td>
       </tr>

       <tr>
         <td><a href="#install">Installation</a></td>

         <td><code>$ make install</code> </td>
       </tr>

       <tr>
         <td><a href="#customize">Personnalisation</a></td>

         <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
       </tr>

       <tr>
         <td><a href="#test">Test</a></td>

         <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
         </td>
       </tr>
     </table>

     <p><em>NN</em> doit être remplacé par le numéro de version courant,
     et <em>PREFIX</em> par le
     chemin du répertoire d'installation. Si
     <em>PREFIX</em> n'est pas spécifié, le chemin du répertoire
     d'installation prendra sa valeur par défaut, à savoir
     <code>/usr/local/apache2</code>.</p>

     <p>Chaque étape du processus de compilation et d'installation est
     décrite plus en détails ci-dessous, à commencer par les prérequis
     pour compiler et installer le serveur HTTP Apache.</p>
 </section>

 <section id="requirements"><title>Prérequis</title>

     <p>Les prérequis pour la construction d'Apache HTTPd sont les suivants:</p>

     <dl>
       <dt>Espace disque</dt>
       <dd>Assurez-vous d'avoir au moins 50 MB d'espace disque disponible
       temporaire. Après l'installation Apache occupe
       approximativement 10 MB d'espace disque. L'espace disque réellement
       nécessaire va varier considérablement en fonction de vos options
       de configuration et de la présence éventuelle de modules tiers.</dd>

       <dt>Compilateur ANSI-C et système de construction</dt>
       <dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a
       href="http://www.gnu.org/software/gcc/gcc.html">GNU C
        (GCC)</a> de la <a
       href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
       est recommandé. Si vous ne possédez pas GCC,
       assurez-vous au moins que votre compilateur soit compatible ANSI.
       En outre, votre <code>PATH</code> doit contenir
       les outils de construction de base tels que <code>make</code>.</dd>

       <dt>Connaissance de l'heure exacte</dt>
       <dd>Les éléments du protocole HTTP font référence à l'heure du jour.
       Par conséquent, il est nécessaire d'équiper votre système d'un
       dispositif de synchronisation du temps. Les programmes
       <code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP,
       sont couramment utilisés à cet effet.
       Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a>
       pour plus de détails à propos du logiciel NTP et des serveurs
       de temps publics.</dd>

       <dt><a href="http://www.perl.org/">Perl 5</a>
       [OPTIONNEL]</dt>
       <dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent)
       est nécessaire pour l'exécution de certains scripts comme
       <program>apxs</program> ou <program>dbmmanage</program>
       (qui sont écrits en Perl).
       Si le script <program>configure</program> ne trouve pas d'interpréteur
       Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin.
       Bien entendu, vous pourrez tout de même construire et utiliser
       Apache httpd.</dd>

       <dt><a href="http://apr.apache.org">apr/apr-util >= 1.4</a></dt>
       <dd><code>apr</code> et <code>apr-util</code> sont inclus
       dans les sources d'Apache HTTPd, et peuvent être utilisés sans problème
       dans la plupart des cas. Cependant, si
       <code>apr</code> ou <code>apr-util</code>, versions 1.0, 1.1 ou 1.2,
       sont installés sur votre système, vous devez soit mettre à jour vos
       installations <code>apr</code>/<code>apr-util</code> vers la version
       1.4, forcer l'utilisation des bibliothèques intégrées,
       soit faire en sorte que httpd utilise des constructions séparées.
       Pour utiliser les sources de
       <code>apr</code>/<code>apr-util</code> incluses, utilisez l'option
       <code>--with-included-apr</code> du script configure :

       <note><title>Note</title>
         L'option --with-included-apr est disponible à partir
 	de la version 2.2.3
       </note>
       <example>
         # Forcer l'utilisation des sources de apr/apr-util intégrées<br />
         ./configure --with-included-apr<br />
       </example>

       Pour construire Apache HTTPd suite  à une installation manuelle de
       <code>apr</code>/<code>apr-util</code> :

       <example>
         # Construction et installation apr 1.4<br />
         cd srclib/apr<br/>
         ./configure --prefix=/usr/local/apr-httpd/<br/>
         make<br/>
         make install<br />
         <br />
         # Construction et installation apr-util 1.4<br />
         cd ../apr-util<br />
         ./configure --prefix=/usr/local/apr-util-httpd/
           --with-apr=/usr/local/apr-httpd/<br />
         make<br/>
         make install<br />
         <br />
         # Configuration httpd<br />
         cd ../../<br />
         ./configure --with-apr=/usr/local/apr-httpd/
           --with-apr-util=/usr/local/apr-util-httpd/
       </example>
       </dd>


     </dl>
 </section>

 <section id="download"><title>Téléchargement</title>

     <p>Le serveur HTTP Apache peut être téléchargé à partir du
     <a href="http://httpd.apache.org/download.cgi">site de téléchargement
     du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs.
     Il sera plus commode à la plupart des utilisateurs d'Apache HTTPd sur les
     systèmes UNIX ou similaires de télécharger et de compiler
     la version sources.  Le processus de construction (décrit ci-dessous) est
     simple, et vous permet de personnaliser votre serveur selon vos besoins.
     En outre, les versions binaires sont souvent plus anciennes que les
     dernières versions sources  Si vous téléchargez une version binaire,
     suivez les instructions décrites dans le fichier
     <code>INSTALL.bindist</code> inclus dans la distribution.</p>

     <p>Après le téléchargement, il est important de vérifier que vous
     disposez d'une version complète et non modifiée du serveur HTTP Apache.
     Vous pouvez le faire en testant l'archive téléchargée à l'aide de
     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
     PGP</a>.</p>

 </section>

 <section id="extract"><title>Extraction</title>

     <p>L'extraction des sources depuis l'archive Apache HTTPd consiste
     simplement à décompresser et à désarchiver cette dernière :</p>

 <example>
 $ gzip -d httpd-<em>NN</em>.tar.gz<br />
 $ tar xvf httpd-<em>NN</em>.tar
 </example>

     <p>Ceci créera, dans le répertoire courant, un nouveau répertoire
     contenant le code source de la distribution. Vous devrez vous positionner
     dans ce répertoire avant de procéder à la compilation du serveur.</p>
 </section>

 <section id="configure"><title>Configuration de l'arborescence des sources</title>

     <p>L'étape suivante consiste à configurer l'arborescence des sources
     d'Apache HTTPd en fonction de votre plateforme et de vos besoins personnels.
     Le script  <program>configure</program>, situé à la racine du
     répertoire de la distribution, a été conçu à cet effet.
     (Les développeurs qui téléchargent
     une version non officielle de l'arborescence des sources d'Apache HTTPd
     devront disposer de
     <code>autoconf</code> et <code>libtool</code> et
     exécuter <code>buildconf</code> avant de passer à l'étape suivante,
     ce qui n'est pas nécessaire pour les versions officielles.)</p>

     <p>Pour configurer l'arborescence des sources avec les valeurs par défaut
     pour toutes les options, entrez simplement <code>./configure</code>.
     Pour modifier les valeurs des options, <program>configure</program>
     comprend toute une variété de variables et
     d'options de ligne de commande.</p>

     <p>L'option la plus importante <code>--prefix</code> est le chemin
     du répertoire d'installation du serveur HTTP Apache, car Apache doit être configuré
     en fonction de ce chemin pour pouvoir fonctionner correctement.
     Il est possible de définir plus finement le chemin d'installation des fichiers
     à l'aide d'<a href="programs/configure.html#installationdirectories">
     options supplémentaires de configure</a>.</p>

     <p>À ce niveau, vous pouvez aussi spécifier de quelles <a
     href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous
     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
     <a href="mod/module-dict.html#Status">Base</a> inclus par défaut.
     Les autres modules sont activés à l'aide de l'option
     <code>--enable-<var>module</var></code>, où
     <var>module</var> est le nom du module sans la chaîne
     <code>mod_</code> et où tout caractère de soulignement est converti
     en tiret.  Vous pouvez aussi choisir de compiler les modules comme
     <a href="dso.html">objets partagés (DSOs)</a> -- qui peuvent être chargés
     ou déchargés à l'exécution -- à l'aide de l'option
     <code>--enable-<var>module</var>=shared</code>.  D'une manière similaire,
     vous pouvez désactiver des modules de base à l'aide de l'option
     <code>--disable-<var>module</var></code> option.  Faites très attention
     en utilisant ces options, car <program>configure</program> n'est pas en
     mesure de vous avertir si le module que vous avez spécifié n'existe pas;
     il ignorera tout simplement l'option.</p>

     <p>En outre, vous devrez peut-être fournir au script
     <program>configure</program> des informations supplémentaires sur
     le chemin de votre compilateur, de vos librairies, ou de vos fichiers
     d'en-têtes.  A cet effet, vous pouvez passer des options de ligne de
     commande ou des variables d'environnement au script
     <program>configure</program>. Pour plus d'informations, voir la
     page de manuel de <program>configure</program>.</p>

     <p>Pour vous faire une idée des possibilités qui s'offrent à vous, voici
     un exemple typique de compilation d'Apache avec le répertoire
     d'installation <code>/sw/pkg/apache</code>, un compilateur et des drapeaux
     particuliers et les deux modules additionnels <module>mod_rewrite</module>
     et <module>mod_speling</module> qui pourront être chargés plus tard
     à l'aide du mécanisme DSO:</p>

 <example>
       $ CC="pgcc" CFLAGS="-O2" \<br />
        ./configure --prefix=/sw/pkg/apache \<br />
        --enable-rewrite=shared \<br />
        --enable-speling=shared
 </example>

     <p>Quand <program>configure</program> est lancé, il peut prendre
     plusieurs minutes pour tester la disponibilité des fonctionnalités
     au sein de votre système, et construire les Makefiles qui seront utilisés
     par la suite pour compiler le serveur.</p>

     <p>Vous trouverez une description détaillée des options de
     <program>configure</program> dans sa page de manuel.</p>
 </section>

 <section id="compile"><title>Construction</title>

     <p>Vous pouvez maintenant construire les différents éléments qui
     composent le paquet Apache HTTPd en lançant tout simplement la commande :</p>

 <example>$ make</example>

     <p>Vous devez être patient, car il faut plusieurs minutes pour compiler
     une configuration de base, et cette durée peut varier considérablement
     en fonction de votre matériel et du nombre de modules que vous avez activés.</p>
 </section>

 <section id="install"><title>Installation</title>

     <p>Il est temps maintenant d'installer le paquet dans le répertoire
     d'installation défini par <em>PREFIX</em> (voir plus haut l'option
     <code>--prefix</code>) en lançant:</p>

 <example>$ make install</example>

     <p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
     vos fichiers de configuration ou autres documents.</p>
 </section>

 <section id="customize"><title>Personnalisation</title>

     <p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en
     éditant les <a href="configuring.html">fichiers de configuration</a>
     situés dans <code><em>PREFIX</em>/conf/</code>.</p>

 <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>

     <p>Consultez le manuel du serveur HTTP Apache situé dans
     <code><em>PREFIX</em>/docs/manual/</code> ou
     <a href="http://httpd.apache.org/docs/&httpd.docs;/"
     >http://httpd.apache.org/docs/&httpd.docs;/</a> pour la version la plus
     récente de ce manuel et la liste complète des <a
     href="mod/directives.html">directives de configuration</a> disponibles.</p>
 </section>

 <section id="test"><title>Test</title>

     <p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
     Serveur HTTP Apache en lançant:</p>

 <example>$ <em>PREFIX</em>/bin/apachectl -k start</example>

     <p>Vous devriez alors pouvoir requérir votre premier document
     à l'aide de l'URL <code>http://localhost/</code>. La page web que vous
     voyez est située dans le répertoire défini par la directive
     <directive module="core">DocumentRoot</directive>,
     qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
     Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>

 <example>$ <em>PREFIX</em>/bin/apachectl -k stop</example>
 </section>
 <section id="upgrading"><title>Mise à jour</title>

     <p>La première étape d'une mise à jour consiste à lire l'annonce de la
     sortie de la nouvelle version et le fichier <code>CHANGES</code>
     dans la distribution des sources afin de déceler toutes les modifications
     qui pourraient affecter votre site. Lors d'un changement majeur de version
     (par exemple de 1.3 à 2.0 ou de 2.0 à 2.2),
     il y aura certainement des différences importantes quant à la
     configuration de la compilation et de l'exécution qui nécessiteront des
     ajustements manuels.  Tous les
     modules devront aussi être mis à jour pour qu'ils s'adaptent aux
     changements de l'API des modules.</p>

     <p>La mise à jour d'une version mineure à la suivante (par exemple, de
     2.2.55 à 2.2.57) est plus aisée.  Le processus <code>make install</code>
     n'écrasera aucun de vos documents existants, fichiers de log,
     ou fichiers de configuration.  De plus, les développeurs font tout
     leur possible pour éviter les changements entraînant une
     incompatibilité dans les options de
     <program>configure</program>, la configuration de l'exécution, ou l'API
     des modules d'une version mineure à l'autre.  Dans la plupart des cas,
     vous pourrez utiliser une ligne de commande
     <program>configure</program> identique, le même fichier de configuration,
     et tous vos modules continueront de fonctionner.</p>

     <p>Pour effectuer une mise à jour entre deux versions mineures,
     commencez par trouver le fichier
     <code>config.nice</code> dans le répertoire de <code>construction</code>
     de votre serveur installé ou à la racine de l'arborescence des sources
     de votre ancienne installation.  Il contient la reproduction exacte de la
     ligne de commande <program>configure</program> que vous avez utilisée pour
     configurer l'arborescence des sources.  Ensuite, pour mettre à jour
     l'ancienne version vers la nouvelle,
     il vous suffit de copier le fichier <code>config.nice</code> dans
     l'arborescence des sources de la nouvelle version, de l'éditer pour
     effectuer toute modification souhaitée, et de lancer:</p>

     <example>
     $ ./config.nice<br />
     $ make<br />
     $ make install<br />
     $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
     $ <em>PREFIX</em>/bin/apachectl -k start<br />
     </example>

     <note type="warning">Vous devez toujours effectuer un test de la nouvelle
     version dans votre environnement avant de la mettre en production.
     Par exemple, vous pouvez installer et exécuter la nouvelle version
     en parallèle avec l'ancienne en utilisant une option
     <code>--prefix</code> et un port différents (en ajustant la directive
     <directive module="mpm_common">Listen</directive>) afin de déceler toute
     incompatibilité avant d'effectuer la mise à jour définitive.</note>

     </section>
 </manualpage>
	<?xml version="1.0" encoding="UTF-8" ?>
	<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
	<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
	<!-- English Revision: 1772232 -->
	<!-- French translation : Lucien GENTIS -->
	<!-- Reviewed by : Vincent Deffontaines -->

	<!--
	Licensed to the Apache Software Foundation (ASF) under one or more
	contributor license agreements. See the NOTICE file distributed with
	this work for additional information regarding copyright ownership.
	The ASF licenses this file to You under the Apache License, Version 2.0
	(the "License"); you may not use this file except in compliance with
	the License. You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
	-->

	<manualpage metafile="install.xml.meta">

	<title>Compilation et installation</title>

	<summary>

	<p>Ce document couvre l'installation et la compilation du serveur
	HTTP Apache
	sur les systèmes Unix et similaires seulement. Pour la compilation et
	l'installation sous Windows, voir <a
	href="platform/windows.html">Utiliser Apache HTTPd avec Microsoft
	Windows</a>. Pour les autres plateformes, se référer à la documentation par
	<a href="platform/">plateforme</a>.</p>

	<p>Apache HTTPd utilise <code>libtool</code> et <code>autoconf</code>
	afin de créer un environnement de construction similaire à la plupart
	des projets Open Source .</p>

	<p>Si vous effectuez une mise à jour depuis une version mineure vers
	la suivante (par exemple, 2.2.50 à 2.2.51), veuillez passer à la section
	<a href="#upgrading">mise à jour</a>.</p>

	</summary>

	<seealso><a href="programs/configure.html">Configuration de l'arborescence
	des sources</a></seealso>
	<seealso><a href="invoking.html">Démarrer le serveur HTTP Apache</a></seealso>
	<seealso><a href="stopping.html">Arrêt et redémarrage</a></seealso>

	<section id="overview"><title>Aperçu pour les plus pressés</title>

	<table>
	<columnspec><column width=".13"/><column width=".80"/></columnspec>
	<tr>
	<td><a href="#download">Téléchargement</a></td>

	<td>Download the latest release from <a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a>
	</td>
	</tr>

	<tr>
	<td><a href="#extract">Extraction</a></td>

	<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
	$ tar xvf httpd-<em>NN</em>.tar<br />
	$ cd httpd-<em>NN</em></code></td>
	</tr>

	<tr>
	<td><a href="#configure">Configuration</a></td>

	<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
	</td>
	</tr>

	<tr>
	<td><a href="#compile">Compilation</a></td>

	<td><code>$ make</code> </td>
	</tr>

	<tr>
	<td><a href="#install">Installation</a></td>

	<td><code>$ make install</code> </td>
	</tr>

	<tr>
	<td><a href="#customize">Personnalisation</a></td>

	<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
	</tr>

	<tr>
	<td><a href="#test">Test</a></td>

	<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
	</td>
	</tr>
	</table>

	<p><em>NN</em> doit être remplacé par le numéro de version courant,
	et <em>PREFIX</em> par le
	chemin du répertoire d'installation. Si
	<em>PREFIX</em> n'est pas spécifié, le chemin du répertoire
	d'installation prendra sa valeur par défaut, à savoir
	<code>/usr/local/apache2</code>.</p>

	<p>Chaque étape du processus de compilation et d'installation est
	décrite plus en détails ci-dessous, à commencer par les prérequis
	pour compiler et installer le serveur HTTP Apache.</p>
	</section>

	<section id="requirements"><title>Prérequis</title>

	<p>Les prérequis pour la construction d'Apache HTTPd sont les suivants:</p>

	<dl>
	<dt>Espace disque</dt>
	<dd>Assurez-vous d'avoir au moins 50 MB d'espace disque disponible
	temporaire. Après l'installation Apache occupe
	approximativement 10 MB d'espace disque. L'espace disque réellement
	nécessaire va varier considérablement en fonction de vos options
	de configuration et de la présence éventuelle de modules tiers.</dd>

	<dt>Compilateur ANSI-C et système de construction</dt>
	<dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a
	href="http://www.gnu.org/software/gcc/gcc.html">GNU C
	(GCC)</a> de la <a
	href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
	est recommandé. Si vous ne possédez pas GCC,
	assurez-vous au moins que votre compilateur soit compatible ANSI.
	En outre, votre <code>PATH</code> doit contenir
	les outils de construction de base tels que <code>make</code>.</dd>

	<dt>Connaissance de l'heure exacte</dt>
	<dd>Les éléments du protocole HTTP font référence à l'heure du jour.
	Par conséquent, il est nécessaire d'équiper votre système d'un
	dispositif de synchronisation du temps. Les programmes
	<code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP,
	sont couramment utilisés à cet effet.
	Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a>
	pour plus de détails à propos du logiciel NTP et des serveurs
	de temps publics.</dd>

	<dt><a href="http://www.perl.org/">Perl 5</a>
	[OPTIONNEL]</dt>
	<dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent)
	est nécessaire pour l'exécution de certains scripts comme
	<program>apxs</program> ou <program>dbmmanage</program>
	(qui sont écrits en Perl).
	Si le script <program>configure</program> ne trouve pas d'interpréteur
	Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin.
	Bien entendu, vous pourrez tout de même construire et utiliser
	Apache httpd.</dd>

	<dt><a href="http://apr.apache.org">apr/apr-util >= 1.4</a></dt>
	<dd><code>apr</code> et <code>apr-util</code> sont inclus
	dans les sources d'Apache HTTPd, et peuvent être utilisés sans problème
	dans la plupart des cas. Cependant, si
	<code>apr</code> ou <code>apr-util</code>, versions 1.0, 1.1 ou 1.2,
	sont installés sur votre système, vous devez soit mettre à jour vos
	installations <code>apr</code>/<code>apr-util</code> vers la version
	1.4, forcer l'utilisation des bibliothèques intégrées,
	soit faire en sorte que httpd utilise des constructions séparées.
	Pour utiliser les sources de
	<code>apr</code>/<code>apr-util</code> incluses, utilisez l'option
	<code>--with-included-apr</code> du script configure :

	<note><title>Note</title>
	L'option --with-included-apr est disponible à partir
	de la version 2.2.3
	</note>
	<example>
	# Forcer l'utilisation des sources de apr/apr-util intégrées<br />
	./configure --with-included-apr<br />
	</example>

	Pour construire Apache HTTPd suite à une installation manuelle de
	<code>apr</code>/<code>apr-util</code> :

	<example>
	# Construction et installation apr 1.4<br />
	cd srclib/apr<br/>
	./configure --prefix=/usr/local/apr-httpd/<br/>
	make<br/>
	make install<br />
	<br />
	# Construction et installation apr-util 1.4<br />
	cd ../apr-util<br />
	./configure --prefix=/usr/local/apr-util-httpd/
	--with-apr=/usr/local/apr-httpd/<br />
	make<br/>
	make install<br />
	<br />
	# Configuration httpd<br />
	cd ../../<br />
	./configure --with-apr=/usr/local/apr-httpd/
	--with-apr-util=/usr/local/apr-util-httpd/
	</example>
	</dd>


	</dl>
	</section>

	<section id="download"><title>Téléchargement</title>

	<p>Le serveur HTTP Apache peut être téléchargé à partir du
	<a href="http://httpd.apache.org/download.cgi">site de téléchargement
	du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs.
	Il sera plus commode à la plupart des utilisateurs d'Apache HTTPd sur les
	systèmes UNIX ou similaires de télécharger et de compiler
	la version sources. Le processus de construction (décrit ci-dessous) est
	simple, et vous permet de personnaliser votre serveur selon vos besoins.
	En outre, les versions binaires sont souvent plus anciennes que les
	dernières versions sources Si vous téléchargez une version binaire,
	suivez les instructions décrites dans le fichier
	<code>INSTALL.bindist</code> inclus dans la distribution.</p>

	<p>Après le téléchargement, il est important de vérifier que vous
	disposez d'une version complète et non modifiée du serveur HTTP Apache.
	Vous pouvez le faire en testant l'archive téléchargée à l'aide de
	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
	PGP</a>.</p>

	</section>

	<section id="extract"><title>Extraction</title>

	<p>L'extraction des sources depuis l'archive Apache HTTPd consiste
	simplement à décompresser et à désarchiver cette dernière :</p>

	<example>
	$ gzip -d httpd-<em>NN</em>.tar.gz<br />
	$ tar xvf httpd-<em>NN</em>.tar
	</example>

	<p>Ceci créera, dans le répertoire courant, un nouveau répertoire
	contenant le code source de la distribution. Vous devrez vous positionner
	dans ce répertoire avant de procéder à la compilation du serveur.</p>
	</section>

	<section id="configure"><title>Configuration de l'arborescence des sources</title>

	<p>L'étape suivante consiste à configurer l'arborescence des sources
	d'Apache HTTPd en fonction de votre plateforme et de vos besoins personnels.
	Le script <program>configure</program>, situé à la racine du
	répertoire de la distribution, a été conçu à cet effet.
	(Les développeurs qui téléchargent
	une version non officielle de l'arborescence des sources d'Apache HTTPd
	devront disposer de
	<code>autoconf</code> et <code>libtool</code> et
	exécuter <code>buildconf</code> avant de passer à l'étape suivante,
	ce qui n'est pas nécessaire pour les versions officielles.)</p>

	<p>Pour configurer l'arborescence des sources avec les valeurs par défaut
	pour toutes les options, entrez simplement <code>./configure</code>.
	Pour modifier les valeurs des options, <program>configure</program>
	comprend toute une variété de variables et
	d'options de ligne de commande.</p>

	<p>L'option la plus importante <code>--prefix</code> est le chemin
	du répertoire d'installation du serveur HTTP Apache, car Apache doit être configuré
	en fonction de ce chemin pour pouvoir fonctionner correctement.
	Il est possible de définir plus finement le chemin d'installation des fichiers
	à l'aide d'<a href="programs/configure.html#installationdirectories">
	options supplémentaires de configure</a>.</p>

	<p>À ce niveau, vous pouvez aussi spécifier de quelles <a
	href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous
	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
	<a href="mod/module-dict.html#Status">Base</a> inclus par défaut.
	Les autres modules sont activés à l'aide de l'option
	<code>--enable-<var>module</var></code>, où
	<var>module</var> est le nom du module sans la chaîne
	<code>mod_</code> et où tout caractère de soulignement est converti
	en tiret. Vous pouvez aussi choisir de compiler les modules comme
	<a href="dso.html">objets partagés (DSOs)</a> -- qui peuvent être chargés
	ou déchargés à l'exécution -- à l'aide de l'option
	<code>--enable-<var>module</var>=shared</code>. D'une manière similaire,
	vous pouvez désactiver des modules de base à l'aide de l'option
	<code>--disable-<var>module</var></code> option. Faites très attention
	en utilisant ces options, car <program>configure</program> n'est pas en
	mesure de vous avertir si le module que vous avez spécifié n'existe pas;
	il ignorera tout simplement l'option.</p>

	<p>En outre, vous devrez peut-être fournir au script
	<program>configure</program> des informations supplémentaires sur
	le chemin de votre compilateur, de vos librairies, ou de vos fichiers
	d'en-têtes. A cet effet, vous pouvez passer des options de ligne de
	commande ou des variables d'environnement au script
	<program>configure</program>. Pour plus d'informations, voir la
	page de manuel de <program>configure</program>.</p>

	<p>Pour vous faire une idée des possibilités qui s'offrent à vous, voici
	un exemple typique de compilation d'Apache avec le répertoire
	d'installation <code>/sw/pkg/apache</code>, un compilateur et des drapeaux
	particuliers et les deux modules additionnels <module>mod_rewrite</module>
	et <module>mod_speling</module> qui pourront être chargés plus tard
	à l'aide du mécanisme DSO:</p>

	<example>
	$ CC="pgcc" CFLAGS="-O2" \<br />
	./configure --prefix=/sw/pkg/apache \<br />
	--enable-rewrite=shared \<br />
	--enable-speling=shared
	</example>

	<p>Quand <program>configure</program> est lancé, il peut prendre
	plusieurs minutes pour tester la disponibilité des fonctionnalités
	au sein de votre système, et construire les Makefiles qui seront utilisés
	par la suite pour compiler le serveur.</p>

	<p>Vous trouverez une description détaillée des options de
	<program>configure</program> dans sa page de manuel.</p>
	</section>

	<section id="compile"><title>Construction</title>

	<p>Vous pouvez maintenant construire les différents éléments qui
	composent le paquet Apache HTTPd en lançant tout simplement la commande :</p>

	<example>$ make</example>

	<p>Vous devez être patient, car il faut plusieurs minutes pour compiler
	une configuration de base, et cette durée peut varier considérablement
	en fonction de votre matériel et du nombre de modules que vous avez activés.</p>
	</section>

	<section id="install"><title>Installation</title>

	<p>Il est temps maintenant d'installer le paquet dans le répertoire
	d'installation défini par <em>PREFIX</em> (voir plus haut l'option
	<code>--prefix</code>) en lançant:</p>

	<example>$ make install</example>

	<p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
	vos fichiers de configuration ou autres documents.</p>
	</section>

	<section id="customize"><title>Personnalisation</title>

	<p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en
	éditant les <a href="configuring.html">fichiers de configuration</a>
	situés dans <code><em>PREFIX</em>/conf/</code>.</p>

	<example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>

	<p>Consultez le manuel du serveur HTTP Apache situé dans
	<code><em>PREFIX</em>/docs/manual/</code> ou
	<a href="http://httpd.apache.org/docs/&httpd.docs;/"
	>http://httpd.apache.org/docs/&httpd.docs;/</a> pour la version la plus
	récente de ce manuel et la liste complète des <a
	href="mod/directives.html">directives de configuration</a> disponibles.</p>
	</section>

	<section id="test"><title>Test</title>

	<p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
	Serveur HTTP Apache en lançant:</p>

	<example>$ <em>PREFIX</em>/bin/apachectl -k start</example>

	<p>Vous devriez alors pouvoir requérir votre premier document
	à l'aide de l'URL <code>http://localhost/</code>. La page web que vous
	voyez est située dans le répertoire défini par la directive
	<directive module="core">DocumentRoot</directive>,
	qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
	Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>

	<example>$ <em>PREFIX</em>/bin/apachectl -k stop</example>
	</section>
	<section id="upgrading"><title>Mise à jour</title>

	<p>La première étape d'une mise à jour consiste à lire l'annonce de la
	sortie de la nouvelle version et le fichier <code>CHANGES</code>
	dans la distribution des sources afin de déceler toutes les modifications
	qui pourraient affecter votre site. Lors d'un changement majeur de version
	(par exemple de 1.3 à 2.0 ou de 2.0 à 2.2),
	il y aura certainement des différences importantes quant à la
	configuration de la compilation et de l'exécution qui nécessiteront des
	ajustements manuels. Tous les
	modules devront aussi être mis à jour pour qu'ils s'adaptent aux
	changements de l'API des modules.</p>

	<p>La mise à jour d'une version mineure à la suivante (par exemple, de
	2.2.55 à 2.2.57) est plus aisée. Le processus <code>make install</code>
	n'écrasera aucun de vos documents existants, fichiers de log,
	ou fichiers de configuration. De plus, les développeurs font tout
	leur possible pour éviter les changements entraînant une
	incompatibilité dans les options de
	<program>configure</program>, la configuration de l'exécution, ou l'API
	des modules d'une version mineure à l'autre. Dans la plupart des cas,
	vous pourrez utiliser une ligne de commande
	<program>configure</program> identique, le même fichier de configuration,
	et tous vos modules continueront de fonctionner.</p>

	<p>Pour effectuer une mise à jour entre deux versions mineures,
	commencez par trouver le fichier
	<code>config.nice</code> dans le répertoire de <code>construction</code>
	de votre serveur installé ou à la racine de l'arborescence des sources
	de votre ancienne installation. Il contient la reproduction exacte de la
	ligne de commande <program>configure</program> que vous avez utilisée pour
	configurer l'arborescence des sources. Ensuite, pour mettre à jour
	l'ancienne version vers la nouvelle,
	il vous suffit de copier le fichier <code>config.nice</code> dans
	l'arborescence des sources de la nouvelle version, de l'éditer pour
	effectuer toute modification souhaitée, et de lancer:</p>

	<example>
	$ ./config.nice<br />
	$ make<br />
	$ make install<br />
	$ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
	$ <em>PREFIX</em>/bin/apachectl -k start<br />
	</example>

	<note type="warning">Vous devez toujours effectuer un test de la nouvelle
	version dans votre environnement avant de la mettre en production.
	Par exemple, vous pouvez installer et exécuter la nouvelle version
	en parallèle avec l'ancienne en utilisant une option
	<code>--prefix</code> et un port différents (en ajustant la directive
	<directive module="mpm_common">Listen</directive>) afin de déceler toute
	incompatibilité avant d'effectuer la mise à jour définitive.</note>

	</section>
	</manualpage>