bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
a0150d3262def12738daa9eb9d47bd34fe918b9algentis<!-- English Revision : 1602761 -->
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<!-- French translation : Lucien GENTIS -->
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<!-- Reviewed by : Vincent Deffontaines -->
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor Licensed to the Apache Software Foundation (ASF) under one or more
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor contributor license agreements. See the NOTICE file distributed with
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor this work for additional information regarding copyright ownership.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor The ASF licenses this file to You under the Apache License, Version 2.0
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor (the "License"); you may not use this file except in compliance with
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor the License. You may obtain a copy of the License at
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor Unless required by applicable law or agreed to in writing, software
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor distributed under the License is distributed on an "AS IS" BASIS,
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor See the License for the specific language governing permissions and
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor limitations under the License.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Si vous ne connaissez rien au serveur HTTP Apache, ou même au
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorfonctionnement d'un site web, vous vous demandez probablement par où
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorcommencer et quelles questions poser. Ce document vous permettra de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorparcourir les bases du sujet.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorLes adresses des pages web sur la Toile se présentent sous forme d'URLs
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor- Uniform Resource Locators - qui comportent un protocole (par
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor exemple <code>http</code>), un nom de serveur (par exemple
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor <code>/docs/current/getting-started.html</code>), et le cas échéant
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor une chaîne de requête (query string) (par exemple <code>?arg=value</code>)
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor permettant de transmettre des informations supplémentaires au serveur.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Un client (par exemple un navigateur web) se connecte à un serveur
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor(par exemple votre serveur HTTP Apache) avec un protocole spécifique, et
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzoreffectue une <strong>requête</strong> pour une ressource en spécifiant
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorson chemin.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Un chemin peut représenter plusieurs types de ressources sur le
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorserveur. Ce peut être un fichier (comme
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<code>getting-started.html</code>), un gestionnaire (comme <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="mod/mod_status.html">server-status</a>), ou toute sorte de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorprogramme (comme <code>index.php</code>). Nous décrirons tout ceci plus
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzoren détails ci-dessous dans la section <a href="#content">Contenu d'un
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorLe serveur envoie alors une <strong>réponse</strong> comportant un code
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzord'état, et éventuellement un corps de réponse. Le code d'état indique si
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorla requête a été traitée avec succès, ou dans la négative quel type
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzord'erreur a été rencontré. Le client est alors sensé savoir quoi faire de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorla réponse. Vous pouvez vous familiariser avec les différents codes
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzord'état en consultant le <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">Wiki du
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Les détails de la transaction, ainsi que les erreurs rencontrées,
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorsont enregistrés dans des fichiers journaux. Tout ceci est décrit en
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordétails ci-dessous dans la section <a href="#logs">Débogage et fichiers
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Pour se connecter à un serveur, le client doit tout d'abord résoudre
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorle nom du serveur en adresse IP, cette dernière permettant de localiser
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorle serveur sur Internet. Ainsi, pour que votre serveur web soit
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzoraccessible, son nom doit être enregistré dans le DNS.</p>
0679f53d7ea85c2cbb4970366f592782d9e26f5flgentis<p>Si vous ne savez pas comment effectuer cet enregistrement, vous
0679f53d7ea85c2cbb4970366f592782d9e26f5flgentisdevrez contacter votre administrateur réseau ou votre fournisseur
0679f53d7ea85c2cbb4970366f592782d9e26f5flgentisd'accès à Internet afin qu'il effectue cette opération pour vous.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Plusieurs noms d'hôte peuvent pointer vers la même adresse IP, et
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorplusieurs adresses IP peuvent être attachées au même serveur physique.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorVous pouvez ainsi héberger plusieurs serveurs web sur le même serveur
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorphysique grâce au mécanisme des <a href="vhosts/">serveurs virtuels</a>.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Pour tester un serveur non encore accessible sur Internet, vous
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorpouvez renseigner son nom d'hôte dans votre fichier hosts afin
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzord'effectuer une résolution de nom locale. Par exemple, pour tester le
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorserveur web <code>www.example.com</code> depuis le serveur physique qui
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorl'héberge, vous pouvez ajouter la ligne suivante au fichier hosts de ce
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordernier : </p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>En général, le fichier hosts se trouve dans le répertoire
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<code>/etc</code> sur les systèmes de style Unix, ou
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<code>C:\Windows\system32\drivers\etc</code> sous Windows.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Vous trouverez plus de détails à propos du fichier hosts à <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>,
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzoret à propos du DNS à <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<title>Fichiers de configuration et directives</title>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>La configuration du serveur HTTP Apache s'effectue via de simples
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorfichiers textes. Ces fichiers peuvent se trouver dans de nombreux
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorendroits différents en fonction du mode d'installation du serveur. Vous
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzortrouverez les positions courantes de ces fichiers dans le <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="http://wiki.apache.org/httpd/DistrosDefaultLayout">wiki httpd</a>.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorSi vous installez httpd depuis le code source, le répertoire par défaut
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordes fichiers de configuration est <code>/usr/local/apache2/conf</code>.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorLe nom du fichier de configuration par défaut est en général
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<code>httpd.conf</code>, mais peut aussi varier en fonction des
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordistributions tierces du serveur.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>L'ensemble de la configuration est en général divisé en plusieurs
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorfichiers afin d'en faciliter la gestion. Ces fichiers sont inclus dans
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorle fichier de configuration principal via la directive <directive
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzormodule="core">Include</directive>. Les noms ou positions de ces fichiers
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorne sont pas figés et peuvent varier considérablement d'une distribution
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorà l'autre. N'hésitez pas à les arranger et subdiviser selon
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<strong>vos</strong> goûts et besoins, quitte à en modifier
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorl'organisation par défaut.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="mod/quickreference.html">directives de configuration</a> que l'on
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorinsère dans les fichiers de configuration. Une directive se compose d'un
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzormot-clé suivi d'un ou plusieurs arguments qui définissent sa valeur.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>La réponse à la question "<em>Où dois-je placer cette directive
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor?</em>" dépend en général du niveau auquel cette directive doit être
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorprise en compte. S'il s'agit du niveau global, elle doit être placée
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordans le fichier de configuration principal, et en dehors de toute
1db884f97626adc6cdca05468e9aad3868879f56lgentissection <directive type="section" module="core">Directory</directive>, <directive
1db884f97626adc6cdca05468e9aad3868879f56lgentistype="section" module="core">Location</directive>, <directive
1db884f97626adc6cdca05468e9aad3868879f56lgentistype="section" module="core">VirtualHost</directive>, ou de toute autre section. Si
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorpar exemple elle ne doit s'appliquer qu'à un répertoire particulier,
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorelle doit être placée dans la section <directive
1db884f97626adc6cdca05468e9aad3868879f56lgentistype="section" module="core">Directory</directive> qui fait référence à ce répertoire.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorVoir la documentation sur les <a href="sections.html">Sections de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>En complément des fichiers de configuration principaux, certaines
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordirectives peuvent être insérées dans des fichiers
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<code>.htaccess</code> que l'on place directement dans le répertoire
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorconcerné. Les fichiers <code>.htaccess</code> sont essentiellement
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordestinés aux personnes qui n'ont pas accès aux fichiers de configuration
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordu serveur. Vous trouverez plus de détails à propos des fichiers
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="howto/htaccess.html"><code>.htaccess</code>howto</a>.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Si le contenu du site web peut se présenter sous de nombreuses
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorformes, il peut en général être scindé en deux formes principales : les
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorcontenus statiques et les contenus dynamiques.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Les contenus statiques sont par exemple les fichiers HTML, les
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorimages, les fichiers CSS et tout autre fichier résidant dans le système
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorde fichiers. La directive <directive
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzormodule="core">DocumentRoot</directive> permet de définir la position
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordans l'arborescence du site où vous devez placer ces fichiers. Cette
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordirective peut être définie au niveau global, ou au niveau de chaque
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorserveur virtuel. Vous pouvez consulter vos fichiers de configuration
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorpour vérifier la manière dont cette directive est définie pour votre
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorserveur.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>En général, et si aucun nom de fichier n'est spécifié dans la
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorrequête, c'est une page de nom <code>index.html</code> qui sera
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorrenvoyée. Par exemple, si la directive <code>DocumentRoot</code> est
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordéfinie à <code>/var/www/html</code>, et si une requête est effectuée
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorpour l'adresse <code>http://www.example.com/work/</code>, c'est le
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorfichier <code>/var/www/html/work/index.html</code> qui sera envoyé au
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorclient par le serveur.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Un contenu dynamique est un contenu qui est généré au moment du
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzortraitement de la requête, et qui peut différer d'une requête à l'autre.
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorCes contenus dynamiques peuvent être générés de nombreuses manières par
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorl'intermédiaire de <a href="handler.html">gestionnaires de contenu</a>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorou "handlers". Il est aussi possible de créer des <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="howto/cgi.html">programmes CGI</a> pour générer le contenu de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorvotre site.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Enfin, on peut utiliser des modules tiers comme mod_php pour écrire
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordu code permettant d'effectuer de nombreuses choses. De nombreuses
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorapplications tierces écrites à partir de divers langages ou outils sont
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordisponibles en téléchargement et peuvent être installées sur votre
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorserveur HTTP Apache. Le support de ces applications dépasse le sujet de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorce document, et nous vous invitons à consulter le site de leur éditeur
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorpour accéder à leur documentation.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<title>Fichiers journaux et résolution des problèmes</title>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>En tant qu'administrateur d'un serveur HTTP Apache, vos sources
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzord'informations principales sont les fichiers journaux, et en particulier
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorle journal des erreurs. Toute tentative de résolution d'un problème sans
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorconsulter le journal des erreurs revient à conduire les yeux fermés.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>La position dans le système de fichiers du journal des erreurs est
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorspécifiée par la directive <directive module="core">ErrorLog</directive>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorqui peut être définie au niveau global, ou au niveau de chaque serveur
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorvirtuel. Chaque entrée du journal des erreurs vous informe sur la nature
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzordes problèmes et le moment de leur survenue. En outre, elle vous indique
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorsouvent comment résoudre le problème. Chaque message d'erreur contient
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorun code d'erreur que vous pouvez utiliser pour effectuer une recherche
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzoren ligne afin d'obtenir une description plus détaillée de la manière de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorrésoudre le problème. Vous pouvez aussi configurer votre journal des
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorerreurs de manière à ce qu'il enregistre un identifiant d'erreur que
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorvous pourrez ensuite utiliser pour effectuer une corrélation avec le
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorjournal des accès afin de déterminer quelle requête est à l'origine de
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorl'erreur.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Vous trouverez plus de détails à ce sujet dans la <a
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorhref="logs.html">Documentation sur la journalisation</a>.</p>
a0150d3262def12738daa9eb9d47bd34fe918b9algentis<title>Et maintenant, quelle est la suite des opérations ?</title>
a0150d3262def12738daa9eb9d47bd34fe918b9algentis<p>La question des prérequis étant réglée, il est temps de passer aux
a0150d3262def12738daa9eb9d47bd34fe918b9algentischoses sérieuses.</p>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<p>Ce document ne couvre que les notions de base. Nous espérons qu'il
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzorvous permettra de mettre le pied à l'étrier, mais il y a encore de
a0150d3262def12738daa9eb9d47bd34fe918b9algentisnombreuses choses que vous devez savoir.</p>
a0150d3262def12738daa9eb9d47bd34fe918b9algentis<li><a href="http://httpd.apache.org/download.cgi">Téléchargement</a></li>
a0150d3262def12738daa9eb9d47bd34fe918b9algentis<li><a href="configuring.html">Configuration</a></li>
a0150d3262def12738daa9eb9d47bd34fe918b9algentis<li><a href="invoking.html">Démarrage du serveur</a></li>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor<li><a href="http://wiki.apache.org/httpd/FAQ">Foire aux questions</a></li>
bfdab5d58a717a6d1fa9c1170a2a3b8355213367gryzor</manualpage>