1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
4 <!-- English Revision : 1555604 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="getting-started.xml.meta">
27 <title>Pour démarrer</title>
30 <p>Si vous ne connaissez rien au serveur HTTP Apache, ou même au
31 fonctionnement d'un site web, vous vous demandez probablement par où
32 commencer et quelles questions poser. Ce document vous permettra de
33 parcourir les bases du sujet.</p>
36 <section id="clientserver">
37 <title>Clients, serveurs et URLs</title>
40 Les adresses des pages web sur la Toile se présentent sous forme d'URLs
41 - Uniform Resource Locators - qui comportent un protocole (par
42 exemple <code>http</code>), un nom de serveur (par exemple
43 <code>www.apache.org</code>), un chemin (par exemple
44 <code>/docs/current/getting-started.html</code>), et le cas échéant
45 une chaîne de requête (query string) (par exemple <code>?arg=value</code>)
46 permettant de transmettre des informations supplémentaires au serveur.
49 <p>Un client (par exemple un navigateur web) se connecte à un serveur
50 (par exemple votre serveur HTTP Apache) avec un protocole spécifique, et
51 effectue une <strong>requête</strong> pour une ressource en spécifiant
54 <p>Un chemin peut représenter plusieurs types de ressources sur le
55 serveur. Ce peut être un fichier (comme
56 <code>getting-started.html</code>), un gestionnaire (comme <a
57 href="mod/mod_status.html">server-status</a>), ou toute sorte de
58 programme (comme <code>index.php</code>). Nous décrirons tout ceci plus
59 en détails ci-dessous dans la section <a href="#content">Contenu d'un
63 Le serveur envoie alors une <strong>réponse</strong> comportant un code
64 d'état, et éventuellement un corps de réponse. Le code d'état indique si
65 la requête a été traitée avec succès, ou dans la négative quel type
66 d'erreur a été rencontré. Le client est alors sensé savoir quoi faire de
67 la réponse. Vous pouvez vous familiariser avec les différents codes
68 d'état en consultant le <a
69 href="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">Wiki du
70 serveur HTTP Apache</a>.</p>
72 <p>Les détails de la transaction, ainsi que les erreurs rencontrées,
73 sont enregistrés dans des fichiers journaux. Tout ceci est décrit en
74 détails ci-dessous dans la section <a href="#logs">Débogage et fichiers
80 <title>Noms d'hôte et DNS</title>
82 <p>Pour se connecter à un serveur, le client doit tout d'abord résoudre
83 le nom du serveur en adresse IP, cette dernière permettant de localiser
84 le serveur sur Internet. Ainsi, pour que votre serveur web soit
85 accessible, son nom doit être enregistré dans le DNS.</p>
87 <p>Plusieurs noms d'hôte peuvent pointer vers la même adresse IP, et
88 plusieurs adresses IP peuvent être attachées au même serveur physique.
89 Vous pouvez ainsi héberger plusieurs serveurs web sur le même serveur
90 physique grâce au mécanisme des <a href="vhosts/">serveurs virtuels</a>.</p>
92 <p>Si vous ne savez pas comment utiliser cette fonctionnalité, vous
93 devez contacter votre administrateur réseau ou votre fournisseur d'accès
94 à Internet qui le feront pour vous.</p>
96 <p>Pour tester un serveur non encore accessible sur Internet, vous
97 pouvez renseigner son nom d'hôte dans votre fichier hosts afin
98 d'effectuer une résolution de nom locale. Par exemple, pour tester le
99 serveur web <code>www.example.com</code> depuis le serveur physique qui
100 l'héberge, vous pouvez ajouter la ligne suivante au fichier hosts de ce
104 127.0.0.1 www.example.com
107 <p>En général, le fichier hosts se trouve dans le répertoire
108 <code>/etc</code> sur les systèmes de style Unix, ou
109 <code>C:\Windows\system32\drivers\etc</code> sous Windows.</p>
111 <p>Vous trouverez plus de détails à propos du fichier hosts à <a
112 href="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>,
113 et à propos du DNS à <a
114 href="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
117 <section id="configuration">
118 <title>Fichiers de configuration et directives</title>
120 <p>La configuration du serveur HTTP Apache s'effectue via de simples
121 fichiers textes. Ces fichiers peuvent se trouver dans de nombreux
122 endroits différents en fonction du mode d'installation du serveur. Vous
123 trouverez les positions courantes de ces fichiers dans le <a
124 href="http://wiki.apache.org/httpd/DistrosDefaultLayout">wiki httpd</a>.
125 Si vous installez httpd depuis le code source, le répertoire par défaut
126 des fichiers de configuration est <code>/usr/local/apache2/conf</code>.
127 Le nom du fichier de configuration par défaut est en général
128 <code>httpd.conf</code>, mais peut aussi varier en fonction des
129 distributions tierces du serveur.</p>
131 <p>L'ensemble de la configuration est en général divisé en plusieurs
132 fichiers afin d'en faciliter la gestion. Ces fichiers sont inclus dans
133 le fichier de configuration principal via la directive <directive
134 module="core">Include</directive>. Les noms ou positions de ces fichiers
135 ne sont pas figés et peuvent varier considérablement d'une distribution
136 à l'autre. N'hésitez pas à les arranger et subdiviser selon
137 <strong>vos</strong> goûts et besoins, quitte à en modifier
138 l'organisation par défaut.</p>
140 <p>La configuration du serveur s'effectue via des <a
141 href="mod/quickreference.html">directives de configuration</a> que l'on
142 insère dans les fichiers de configuration. Une directive se compose d'un
143 mot-clé suivi d'un ou plusieurs arguments qui définissent sa valeur.</p>
145 <p>La réponse à la question "<em>Où dois-je placer cette directive
146 ?</em>" dépend en général du niveau auquel cette directive doit être
147 prise en compte. S'il s'agit du niveau global, elle doit être placée
148 dans le fichier de configuration principal, et en dehors de toute
149 section <directive type="section">Directory</directive>, <directive
150 type="section">Location</directive>, <directive
151 type="section">VirtualHost</directive>, ou de toute autre section. Si
152 par exemple elle ne doit s'appliquer qu'à un répertoire particulier,
153 elle doit être placée dans la section <directive
154 type="section">Directory</directive> qui fait référence à ce répertoire.
155 Voir la documentation sur les <a href="sections.html">Sections de
156 configuration</a> pour plus de détails.</p>
158 <p>En complément des fichiers de configuration principaux, certaines
159 directives peuvent être insérées dans des fichiers
160 <code>.htaccess</code> que l'on place directement dans le répertoire
161 concerné. Les fichiers <code>.htaccess</code> sont essentiellement
162 destinés aux personnes qui n'ont pas accès aux fichiers de configuration
163 du serveur. Vous trouverez plus de détails à propos des fichiers
164 <code>.htaccess</code> dans ce <a
165 href="howto/htaccess.html"><code>.htaccess</code>howto</a>.</p>
169 <section id="content">
170 <title>Contenu du site web</title>
172 <p>Si le contenu du site web peut se présenter sous de nombreuses
173 formes, il peut en général être scindé en deux formes principales : les
174 contenus statiques et les contenus dynamiques.</p>
176 <p>Les contenus statiques sont par exemple les fichiers HTML, les
177 images, les fichiers CSS et tout autre fichier résidant dans le système
178 de fichiers. La directive <directive
179 module="core">DocumentRoot</directive> permet de définir la position
180 dans l'arborescence du site où vous devez placer ces fichiers. Cette
181 directive peut être définie au niveau global, ou au niveau de chaque
182 serveur virtuel. Vous pouvez consulter vos fichiers de configuration
183 pour vérifier la manière dont cette directive est définie pour votre
186 <p>En général, et si aucun nom de fichier n'est spécifié dans la
187 requête, c'est une page de nom <code>index.html</code> qui sera
188 renvoyée. Par exemple, si la directive <code>DocumentRoot</code> est
189 définie à <code>/var/www/html</code>, et si une requête est effectuée
190 pour l'adresse <code>http://www.example.com/work/</code>, c'est le
191 fichier <code>/var/www/html/work/index.html</code> qui sera envoyé au
192 client par le serveur.</p>
194 <p>Un contenu dynamique est un contenu qui est généré au moment du
195 traitement de la requête, et qui peut différer d'une requête à l'autre.
196 Ces contenus dynamiques peuvent être générés de nombreuses manières par
197 l'intermédiaire de <a href="handler.html">gestionnaires de contenu</a>
198 ou "handlers". Il est aussi possible de créer des <a
199 href="howto/cgi.html">programmes CGI</a> pour générer le contenu de
202 <p>Enfin, on peut utiliser des modules tiers comme mod_php pour écrire
203 du code permettant d'effectuer de nombreuses choses. De nombreuses
204 applications tierces écrites à partir de divers langages ou outils sont
205 disponibles en téléchargement et peuvent être installées sur votre
206 serveur HTTP Apache. Le support de ces applications dépasse le sujet de
207 ce document, et nous vous invitons à consulter le site de leur éditeur
208 pour accéder à leur documentation.</p>
212 <title>Fichiers journaux et résolution des problèmes</title>
213 <p>En tant qu'administrateur d'un serveur HTTP Apache, vos sources
214 d'informations principales sont les fichiers journaux, et en particulier
215 le journal des erreurs. Toute tentative de résolution d'un problème sans
216 consulter le journal des erreurs revient à conduire les yeux fermés.</p>
218 <p>La position dans le système de fichiers du journal des erreurs est
219 spécifiée par la directive <directive module="core">ErrorLog</directive>
220 qui peut être définie au niveau global, ou au niveau de chaque serveur
221 virtuel. Chaque entrée du journal des erreurs vous informe sur la nature
222 des problèmes et le moment de leur survenue. En outre, elle vous indique
223 souvent comment résoudre le problème. Chaque message d'erreur contient
224 un code d'erreur que vous pouvez utiliser pour effectuer une recherche
225 en ligne afin d'obtenir une description plus détaillée de la manière de
226 résoudre le problème. Vous pouvez aussi configurer votre journal des
227 erreurs de manière à ce qu'il enregistre un identifiant d'erreur que
228 vous pourrez ensuite utiliser pour effectuer une corrélation avec le
229 journal des accès afin de déterminer quelle requête est à l'origine de
232 <p>Vous trouverez plus de détails à ce sujet dans la <a
233 href="logs.html">Documentation sur la journalisation</a>.</p>
237 <title>Que dois-je savoir d'autre ?</title>
238 <p>Ce document ne couvre que les notions de base. Nous espérons qu'il
239 vous permettra de mettre le pied à l'étrier, mais il y a encore de
240 nombreuses choses que vous devez savoir. Voici une liste non exhaustive
241 des documents que nous vous recommandons de consulter :</p>
244 <li><a href="howto/auth.html">Authentification et autorisation
245 (protection des ressources par mot de passe)</a></li>
246 <li><a href="howto/access.html">Contrôle d'accès</a></li>
247 <li><a href="ssl/ssl_howto.html">Mise en oeuvre de SSL</a></li>
248 <li><a href="http://wiki.apache.org/httpd/FAQ">Foire aux questions</a></li>