getting-started.xml.fr revision bfdab5d58a717a6d1fa9c1170a2a3b8355213367
ed1d958582984a7c54a6ca859e15939a414fa733nd<?xml version="1.0" encoding="ISO-8859-1" ?>
ed1d958582984a7c54a6ca859e15939a414fa733nd<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
ed1d958582984a7c54a6ca859e15939a414fa733nd<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
ed1d958582984a7c54a6ca859e15939a414fa733nd<!-- English Revision : 1364306 -->
ed1d958582984a7c54a6ca859e15939a414fa733nd<!-- French translation : Lucien GENTIS -->
ed1d958582984a7c54a6ca859e15939a414fa733nd<!-- Reviewed by : Vincent Deffontaines -->
ed1d958582984a7c54a6ca859e15939a414fa733nd
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<!--
ed1d958582984a7c54a6ca859e15939a414fa733nd Licensed to the Apache Software Foundation (ASF) under one or more
ed1d958582984a7c54a6ca859e15939a414fa733nd contributor license agreements. See the NOTICE file distributed with
ed1d958582984a7c54a6ca859e15939a414fa733nd this work for additional information regarding copyright ownership.
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen The ASF licenses this file to You under the Apache License, Version 2.0
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen (the "License"); you may not use this file except in compliance with
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen the License. You may obtain a copy of the License at
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen
ed1d958582984a7c54a6ca859e15939a414fa733nd http://www.apache.org/licenses/LICENSE-2.0
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd Unless required by applicable law or agreed to in writing, software
ed1d958582984a7c54a6ca859e15939a414fa733nd distributed under the License is distributed on an "AS IS" BASIS,
3f08db06526d6901aa08c110b5bc7dde6bc39905nd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
ed1d958582984a7c54a6ca859e15939a414fa733nd See the License for the specific language governing permissions and
ed1d958582984a7c54a6ca859e15939a414fa733nd limitations under the License.
ed1d958582984a7c54a6ca859e15939a414fa733nd-->
ed1d958582984a7c54a6ca859e15939a414fa733nd
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<manualpage metafile="getting-started.xml.meta">
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd <title>Pour d&eacute;marrer</title>
20ae85899eb856570d26a50293e46239fbcbf093nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<summary>
ed1d958582984a7c54a6ca859e15939a414fa733nd<p>Si vous ne connaissez rien au serveur HTTP Apache, ou m&ecirc;me au
ed1d958582984a7c54a6ca859e15939a414fa733ndfonctionnement d'un site web, vous vous demandez probablement par o&ugrave;
ed1d958582984a7c54a6ca859e15939a414fa733ndcommencer et quelles questions poser. Ce document vous permettra de
ed1d958582984a7c54a6ca859e15939a414fa733ndparcourir les bases du sujet.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd</summary>
ed1d958582984a7c54a6ca859e15939a414fa733nd
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen<section id="clientserver">
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen<title>Clients, serveurs et URLs</title>
ed1d958582984a7c54a6ca859e15939a414fa733nd
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<p>
ed1d958582984a7c54a6ca859e15939a414fa733ndLes adresses des pages web sur la Toile se pr&eacute;sentent sous forme d'URLs
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh- Uniform Resource Locators - qui comportent un protocole (par
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh exemple <code>http</code>), un nom de serveur (par exemple
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh <code>www.apache.org</code>), un chemin (par exemple
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh <code>/docs/current/getting-started.html</code>), et le cas &eacute;ch&eacute;ant
ed1d958582984a7c54a6ca859e15939a414fa733nd une cha&icirc;ne de requ&ecirc;te (query string) (par exemple <code>?arg=value</code>)
ed1d958582984a7c54a6ca859e15939a414fa733nd permettant de transmettre des informations suppl&eacute;mentaires au serveur.
ed1d958582984a7c54a6ca859e15939a414fa733nd</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<p>Un client (par exemple un navigateur web) se connecte &agrave; un serveur
ed1d958582984a7c54a6ca859e15939a414fa733nd(par exemple votre serveur HTTP Apache) avec un protocole sp&eacute;cifique, et
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooheffectue une <strong>requ&ecirc;te</strong> pour une ressource en sp&eacute;cifiant
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohson chemin.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh<p>Un chemin peut repr&eacute;senter plusieurs types de ressources sur le
ed1d958582984a7c54a6ca859e15939a414fa733ndserveur. Ce peut &ecirc;tre un fichier (comme
ed1d958582984a7c54a6ca859e15939a414fa733nd<code>getting-started.html</code>), un gestionnaire (comme <a
05960df825881f33c5bbad4181bfe484d9ac3d69humbedoohhref="mod/mod_status.html">server-status</a>), ou toute sorte de
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohprogramme (comme <code>index.php</code>). Nous d&eacute;crirons tout ceci plus
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohen d&eacute;tails ci-dessous dans la section <a href="#content">Contenu d'un
ed1d958582984a7c54a6ca859e15939a414fa733ndsite web</a>.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<p>
ed1d958582984a7c54a6ca859e15939a414fa733ndLe serveur envoie alors une <strong>r&eacute;ponse</strong> comportant un code
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohd'&eacute;tat, et &eacute;ventuellement un corps de r&eacute;ponse. Le code d'&eacute;tat indique si
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohla requ&ecirc;te a &eacute;t&eacute; trait&eacute;e avec succ&egrave;s, ou dans la n&eacute;gative quel type
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohd'erreur a &eacute;t&eacute; rencontr&eacute;. Le client est alors sens&eacute; savoir quoi faire de
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohla r&eacute;ponse. Vous pouvez vous familiariser avec les diff&eacute;rents codes
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohd'&eacute;tat en consultant le <a
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohhref="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">Wiki du
05960df825881f33c5bbad4181bfe484d9ac3d69humbedoohserveur HTTP Apache</a>.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh<p>Les d&eacute;tails de la transaction, ainsi que les erreurs rencontr&eacute;es,
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohsont enregistr&eacute;s dans des fichiers journaux. Tout ceci est d&eacute;crit en
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohd&eacute;tails ci-dessous dans la section <a href="#logs">D&eacute;bogage et fichiers
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohjournaux</a>.</p>
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh</section>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<section id="dns">
ed1d958582984a7c54a6ca859e15939a414fa733nd<title>Noms d'h&ocirc;te et DNS</title>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<p>Pour se connecter &agrave; un serveur, le client doit tout d'abord r&eacute;soudre
ed1d958582984a7c54a6ca859e15939a414fa733ndle nom du serveur en adresse IP, cette derni&egrave;re permettant de localiser
ed1d958582984a7c54a6ca859e15939a414fa733ndle serveur sur Internet. Ainsi, pour que votre serveur web soit
1bef4f86b61899d34c5480e323e50eb5f775f069humbedoohaccessible, son nom doit &ecirc;tre enregistr&eacute; dans le DNS.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh<p>Plusieurs noms d'h&ocirc;te peuvent pointer vers la m&ecirc;me adresse IP, et
ed1d958582984a7c54a6ca859e15939a414fa733ndplusieurs adresses IP peuvent &ecirc;tre attach&eacute;es au m&ecirc;me serveur physique.
ed1d958582984a7c54a6ca859e15939a414fa733ndVous pouvez ainsi h&eacute;berger plusieurs serveurs web sur le m&ecirc;me serveur
ed1d958582984a7c54a6ca859e15939a414fa733ndphysique gr&acirc;ce au m&eacute;canisme des <a href="vhosts/">serveurs virtuels</a>.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
1bef4f86b61899d34c5480e323e50eb5f775f069humbedooh<p>Si vous ne savez pas comment utiliser cette fonctionnalit&eacute;, vous
ed1d958582984a7c54a6ca859e15939a414fa733nddevez contacter votre administrateur r&eacute;seau ou votre fournisseur d'acc&egrave;s
ed1d958582984a7c54a6ca859e15939a414fa733nd&agrave; Internet qui le feront pour vous.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<p>Pour tester un serveur non encore accessible sur Internet, vous
ed1d958582984a7c54a6ca859e15939a414fa733ndpouvez renseigner son nom d'h&ocirc;te dans votre fichier hosts afin
ed1d958582984a7c54a6ca859e15939a414fa733ndd'effectuer une r&eacute;solution de nom locale. Par exemple, pour tester le
ed1d958582984a7c54a6ca859e15939a414fa733ndserveur web <code>www.example.com</code> depuis le serveur physique qui
20ae85899eb856570d26a50293e46239fbcbf093ndl'h&eacute;berge, vous pouvez ajouter la ligne suivante au fichier hosts de ce
ed1d958582984a7c54a6ca859e15939a414fa733nddernier : </p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<example>
ed1d958582984a7c54a6ca859e15939a414fa733nd127.0.0.1 www.example.com
ed1d958582984a7c54a6ca859e15939a414fa733nd</example>
ed1d958582984a7c54a6ca859e15939a414fa733nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<p>En g&eacute;n&eacute;ral, le fichier hosts se trouve dans le r&eacute;pertoire
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen<code>/etc</code> sur les syst&egrave;mes de style Unix, ou
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen<code>C:\Windows\system32\drivers\etc</code> sous Windows.</p>
ed1d958582984a7c54a6ca859e15939a414fa733nd
5effc8b39fae5cd169d17f342bfc265705840014rbowen<p>Vous trouverez plus de d&eacute;tails &agrave; propos du fichier hosts &agrave; <a
7fec19672a491661b2fe4b29f685bc7f4efa64d4ndhref="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>,
7fec19672a491661b2fe4b29f685bc7f4efa64d4ndet &agrave; propos du DNS &agrave; <a
7fec19672a491661b2fe4b29f685bc7f4efa64d4ndhref="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd</section>
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd
ed1d958582984a7c54a6ca859e15939a414fa733nd<section id="configuration">
<title>Fichiers de configuration et directives</title>
<p>La configuration du serveur HTTP Apache s'effectue via de simples
fichiers textes. Ces fichiers peuvent se trouver dans de nombreux
endroits diff&eacute;rents en fonction du mode d'installation du serveur. Vous
trouverez les positions courantes de ces fichiers dans le <a
href="http://wiki.apache.org/httpd/DistrosDefaultLayout">wiki httpd</a>.
Si vous installez httpd depuis le code source, le r&eacute;pertoire par d&eacute;faut
des fichiers de configuration est <code>/usr/local/apache2/conf</code>.
Le nom du fichier de configuration par d&eacute;faut est en g&eacute;n&eacute;ral
<code>httpd.conf</code>, mais peut aussi varier en fonction des
distributions tierces du serveur.</p>
<p>L'ensemble de la configuration est en g&eacute;n&eacute;ral divis&eacute; en plusieurs
fichiers afin d'en faciliter la gestion. Ces fichiers sont inclus dans
le fichier de configuration principal via la directive <directive
module="core">Include</directive>. Les noms ou positions de ces fichiers
ne sont pas fig&eacute;s et peuvent varier consid&eacute;rablement d'une distribution
&agrave; l'autre. N'h&eacute;sitez pas &agrave; les arranger et subdiviser selon
<strong>vos</strong> go&ucirc;ts et besoins, quitte &agrave; en modifier
l'organisation par d&eacute;faut.</p>
<p>La configuration du serveur s'effectue via des <a
href="mod/quickreference.html">directives de configuration</a> que l'on
ins&egrave;re dans les fichiers de configuration. Une directive se compose d'un
mot-cl&eacute; suivi d'un ou plusieurs arguments qui d&eacute;finissent sa valeur.</p>
<p>La r&eacute;ponse &agrave; la question "<em>O&ugrave; dois-je placer cette directive
?</em>" d&eacute;pend en g&eacute;n&eacute;ral du niveau auquel cette directive doit &ecirc;tre
prise en compte. S'il s'agit du niveau global, elle doit &ecirc;tre plac&eacute;e
dans le fichier de configuration principal, et en dehors de toute
section <directive type="section">Directory</directive>, <directive
type="section">Location</directive>, <directive
type="section">VirtualHost</directive>, ou de toute autre section. Si
par exemple elle ne doit s'appliquer qu'&agrave; un r&eacute;pertoire particulier,
elle doit &ecirc;tre plac&eacute;e dans la section <directive
type="section">Directory</directive> qui fait r&eacute;f&eacute;rence &agrave; ce r&eacute;pertoire.
Voir la documentation sur les <a href="sections.html">Sections de
configuration</a> pour plus de d&eacute;tails.</p>
<p>En compl&eacute;ment des fichiers de configuration principaux, certaines
directives peuvent &ecirc;tre ins&eacute;r&eacute;es dans des fichiers
<code>.htaccess</code> que l'on place directement dans le r&eacute;pertoire
concern&eacute;. Les fichiers <code>.htaccess</code> sont essentiellement
destin&eacute;s aux personnes qui n'ont pas acc&egrave;s aux fichiers de configuration
du serveur. Vous trouverez plus de d&eacute;tails &agrave; propos des fichiers
<code>.htaccess</code> dans ce <a
href="howto/htaccess.html"><code>.htaccess</code>howto</a>.</p>
</section>
<section id="content">
<title>Contenu du site web</title>
<p>Si le contenu du site web peut se pr&eacute;senter sous de nombreuses
formes, il peut en g&eacute;n&eacute;ral &ecirc;tre scind&eacute; en deux formes principales : les
contenus statiques et les contenus dynamiques.</p>
<p>Les contenus statiques sont par exemple les fichiers HTML, les
images, les fichiers CSS et tout autre fichier r&eacute;sidant dans le syst&egrave;me
de fichiers. La directive <directive
module="core">DocumentRoot</directive> permet de d&eacute;finir la position
dans l'arborescence du site o&ugrave; vous devez placer ces fichiers. Cette
directive peut &ecirc;tre d&eacute;finie au niveau global, ou au niveau de chaque
serveur virtuel. Vous pouvez consulter vos fichiers de configuration
pour v&eacute;rifier la mani&egrave;re dont cette directive est d&eacute;finie pour votre
serveur.</p>
<p>En g&eacute;n&eacute;ral, et si aucun nom de fichier n'est sp&eacute;cifi&eacute; dans la
requ&ecirc;te, c'est une page de nom <code>index.html</code> qui sera
renvoy&eacute;e. Par exemple, si la directive <code>DocumentRoot</code> est
d&eacute;finie &agrave; <code>/var/www/html</code>, et si une requ&ecirc;te est effectu&eacute;e
pour l'adresse <code>http://www.example.com/work/</code>, c'est le
fichier <code>/var/www/html/work/index.html</code> qui sera envoy&eacute; au
client par le serveur.</p>
<p>Un contenu dynamique est un contenu qui est g&eacute;n&eacute;r&eacute; au moment du
traitement de la requ&ecirc;te, et qui peut diff&eacute;rer d'une requ&ecirc;te &agrave; l'autre.
Ces contenus dynamiques peuvent &ecirc;tre g&eacute;n&eacute;r&eacute;s de nombreuses mani&egrave;res par
l'interm&eacute;diaire de <a href="handler.html">gestionnaires de contenu</a>
ou "handlers". Il est aussi possible de cr&eacute;er des <a
href="howto/cgi.html">programmes CGI</a> pour g&eacute;n&eacute;rer le contenu de
votre site.</p>
<p>Enfin, on peut utiliser des modules tiers comme mod_php pour &eacute;crire
du code permettant d'effectuer de nombreuses choses. De nombreuses
applications tierces &eacute;crites &agrave; partir de divers langages ou outils sont
disponibles en t&eacute;l&eacute;chargement et peuvent &ecirc;tre install&eacute;es sur votre
serveur HTTP Apache. Le support de ces applications d&eacute;passe le sujet de
ce document, et nous vous invitons &agrave; consulter le site de leur &eacute;diteur
pour acc&eacute;der &agrave; leur documentation.</p>
</section>
<section id="logs">
<title>Fichiers journaux et r&eacute;solution des probl&egrave;mes</title>
<p>En tant qu'administrateur d'un serveur HTTP Apache, vos sources
d'informations principales sont les fichiers journaux, et en particulier
le journal des erreurs. Toute tentative de r&eacute;solution d'un probl&egrave;me sans
consulter le journal des erreurs revient &agrave; conduire les yeux ferm&eacute;s.</p>
<p>La position dans le syst&egrave;me de fichiers du journal des erreurs est
sp&eacute;cifi&eacute;e par la directive <directive module="core">ErrorLog</directive>
qui peut &ecirc;tre d&eacute;finie au niveau global, ou au niveau de chaque serveur
virtuel. Chaque entr&eacute;e du journal des erreurs vous informe sur la nature
des probl&egrave;mes et le moment de leur survenue. En outre, elle vous indique
souvent comment r&eacute;soudre le probl&egrave;me. Chaque message d'erreur contient
un code d'erreur que vous pouvez utiliser pour effectuer une recherche
en ligne afin d'obtenir une description plus d&eacute;taill&eacute;e de la mani&egrave;re de
r&eacute;soudre le probl&egrave;me. Vous pouvez aussi configurer votre journal des
erreurs de mani&egrave;re &agrave; ce qu'il enregistre un identifiant d'erreur que
vous pourrez ensuite utiliser pour effectuer une corr&eacute;lation avec le
journal des acc&egrave;s afin de d&eacute;terminer quelle requ&ecirc;te est &agrave; l'origine de
l'erreur.</p>
<p>Vous trouverez plus de d&eacute;tails &agrave; ce sujet dans la <a
href="logs.html">Documentation sur la journalisation</a>.</p>
</section>
<section id="other">
<title>Que dois-je savoir d'autre ?</title>
<p>Ce document ne couvre que les notions de base. Nous esp&eacute;rons qu'il
vous permettra de mettre le pied &agrave; l'&eacute;trier, mais il y a encore de
nombreuses choses que vous devez savoir. Voici une liste non exhaustive
des documents que nous vous recommandons de consulter :</p>
<ul>
<li><a href="howto/auth.html">Authentification et autorisation
(protection des ressources par mot de passe)</a></li>
<li><a href="howto/access.html">Contr&ocirc;le d'acc&egrave;s</a></li>
<li><a href="ssl/ssl_howto.html">Mise en oeuvre de SSL</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Foire aux questions</a></li>
</ul>
</section>
</manualpage>