<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Compilation et installation - Serveur Apache HTTP</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP Version 2.2</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<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.2</a></div><div id="page-content"><div id="preamble"><h1>Compilation et installation</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<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>
</div>
<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>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Prérequis</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">Téléchargement</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Extraction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuration de l'arborescence des sources</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Construction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Installation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Personnalisation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Mise à jour</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="programs/configure.html">Configuration de l'arborescence
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>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="overview" id="overview">Aperçu pour les plus pressés</a></h2>
<table>
<tr>
<td><a href="#download">Téléchargement</a></td>
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
</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>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Prérequis</a></h2>
<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
<code class="program"><a href="./programs/apxs.html">apxs</a></code> ou <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code>
(qui sont écrits en Perl). Si vous disposez de plusieurs interpréteurs
Perl (par exemple, une installation globale Perl 4, et
votre installation personnelle de Perl 5), il vous faut utiliser l'option
<code>--with-perl</code> (voir ci-dessous) afin de vous assurer que le
bon interpréteur sera utilisé par <code class="program"><a href="./programs/configure.html">configure</a></code>.
Si le script <code class="program"><a href="./programs/configure.html">configure</a></code> 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.2</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 ou 1.1,
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.2, 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 :
<div class="note"><h3>Note</h3>
L'option --with-included-apr est disponible à partir
de la version 2.2.3
</div>
<div class="example"><p><code>
# Forcer l'utilisation des sources de apr/apr-util intégrées<br />
./configure --with-included-apr<br />
</code></p></div>
Pour construire Apache HTTPd suite à une installation manuelle de
<code>apr</code>/<code>apr-util</code> :
<div class="example"><p><code>
# Construction et installation apr 1.2<br />
cd srclib/apr<br />
./configure --prefix=/usr/local/apr-httpd/<br />
make<br />
make install<br />
<br />
# Construction et installation apr-util 1.2<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/
</code></p></div>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">Téléchargement</a></h2>
<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>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">Extraction</a></h2>
<p>L'extraction des sources depuis l'archive Apache HTTPd consiste
simplement à décompresser et à désarchiver cette dernière :</p>
<div class="example"><p><code>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</code></p></div>
<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>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Configuration de l'arborescence des sources</a></h2>
<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 <code class="program"><a href="./programs/configure.html">configure</a></code>, 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, <code class="program"><a href="./programs/configure.html">configure</a></code>
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 <code class="program"><a href="./programs/configure.html">configure</a></code> 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
<code class="program"><a href="./programs/configure.html">configure</a></code> 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
<code class="program"><a href="./programs/configure.html">configure</a></code>. Pour plus d'informations, voir la
page de manuel de <code class="program"><a href="./programs/configure.html">configure</a></code>.</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 <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 pourront être chargés plus tard
à l'aide du mécanisme DSO:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-rewrite=shared \<br />
--enable-speling=shared
</code></p></div>
<p>Quand <code class="program"><a href="./programs/configure.html">configure</a></code> 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
<code class="program"><a href="./programs/configure.html">configure</a></code> dans sa page de manuel.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">Construction</a></h2>
<p>Vous pouvez maintenant construire les différents éléments qui
composent le paquet Apache HTTPd en lançant tout simplement la commande :</p>
<div class="example"><p><code>$ make</code></p></div>
<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>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Installation</a></h2>
<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>
<div class="example"><p><code>$ make install</code></p></div>
<p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
vos fichiers de configuration ou autres documents.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">Personnalisation</a></h2>
<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>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p>Consultez le manuel du serveur HTTP Apache situé dans
<a href="./">docs/manual/</a> ou
<a href="http://httpd.apache.org/docs/2.2/">http://httpd.apache.org/docs/2.2/</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>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">Test</a></h2>
<p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
Serveur HTTP Apache en lançant:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
<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
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="upgrading" id="upgrading">Mise à jour</a></h2>
<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
<code class="program"><a href="./programs/configure.html">configure</a></code>, 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
<code class="program"><a href="./programs/configure.html">configure</a></code> 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 <code class="program"><a href="./programs/configure.html">configure</a></code> 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>
<div class="example"><p><code>
$ ./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 />
</code></p></div>
<div class="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
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>) afin de déceler toute
incompatibilité avant d'effectuer la mise à jour définitive.</div>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<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>
</body></html>