mirror of
https://github.com/apache/httpd.git
synced 2025-08-13 14:40:20 +00:00
d53638f494
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1836025 13f79535-47bb-0310-9956-ffa450edef68
276 lines
18 KiB
Plaintext
276 lines
18 KiB
Plaintext
<?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>
|
|
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
|
|
<!--
|
|
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
This file is generated from xml source: DO NOT EDIT
|
|
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
-->
|
|
<title>Pour démarrer - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
|
|
<script src="./style/scripts/prettify.min.js" type="text/javascript">
|
|
</script>
|
|
|
|
<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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
|
|
<p class="apache">Serveur HTTP Apache Version 2.4</p>
|
|
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Pour démarrer</h1>
|
|
<div class="toplang">
|
|
<p><span>Langues Disponibles: </span><a href="./en/getting-started.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
|
<a href="./fr/getting-started.html" title="Français"> fr </a></p>
|
|
</div>
|
|
|
|
<p>Si vous ne connaissez rien au serveur HTTP Apache, ou même au
|
|
fonctionnement d'un site web, vous vous demandez probablement par où
|
|
commencer et quelles questions poser. Ce document vous permettra de
|
|
parcourir les bases du sujet.</p>
|
|
</div>
|
|
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#clientserver">Clients, serveurs et URLs</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#dns">Noms d'hôte et DNS</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">Fichiers de configuration et directives</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#content">Contenu du site web</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#logs">Fichiers journaux et résolution des problèmes</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#other">Et maintenant, quelle est la suite des opérations ?</a></li>
|
|
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="clientserver" id="clientserver">Clients, serveurs et URLs</a></h2>
|
|
|
|
|
|
<p>
|
|
Les adresses des pages web sur la Toile se présentent sous forme d'URLs
|
|
- Uniform Resource Locators - qui comportent un protocole (par
|
|
exemple <code>http</code>), un nom de serveur (par exemple
|
|
<code>www.apache.org</code>), un chemin (par exemple
|
|
<code>/docs/current/getting-started.html</code>), et le cas échéant
|
|
une chaîne de requête (query string) (par exemple <code>?arg=value</code>)
|
|
permettant de transmettre des informations supplémentaires au serveur.
|
|
</p>
|
|
|
|
<p>Un client (par exemple un navigateur web) se connecte à un serveur
|
|
(par exemple votre serveur HTTP Apache) avec un protocole spécifique, et
|
|
effectue une <strong>requête</strong> pour une ressource en spécifiant
|
|
son chemin.</p>
|
|
|
|
<p>Un chemin peut représenter plusieurs types de ressources sur le
|
|
serveur. Ce peut être un fichier (comme
|
|
<code>getting-started.html</code>), un gestionnaire (comme <a href="mod/mod_status.html">server-status</a>), ou toute sorte de
|
|
programme (comme <code>index.php</code>). Nous décrirons tout ceci plus
|
|
en détails ci-dessous dans la section <a href="#content">Contenu d'un
|
|
site web</a>.</p>
|
|
|
|
<p>
|
|
Le serveur envoie alors une <strong>réponse</strong> comportant un code
|
|
d'état, et éventuellement un corps de réponse. Le code d'état indique si
|
|
la requête a été traitée avec succès, ou dans la négative quel type
|
|
d'erreur a été rencontré. Le client est alors sensé savoir quoi faire de
|
|
la réponse. Vous pouvez vous familiariser avec les différents codes
|
|
d'état en consultant le <a href="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">Wiki du
|
|
serveur HTTP Apache</a>.</p>
|
|
|
|
<p>Les détails de la transaction, ainsi que les erreurs rencontrées,
|
|
sont enregistrés dans des fichiers journaux. Tout ceci est décrit en
|
|
détails ci-dessous dans la section <a href="#logs">Débogage et fichiers
|
|
journaux</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="dns" id="dns">Noms d'hôte et DNS</a></h2>
|
|
|
|
|
|
<p>Pour se connecter à un serveur, le client doit tout d'abord résoudre
|
|
le nom du serveur en adresse IP, cette dernière permettant de localiser
|
|
le serveur sur Internet. Ainsi, pour que votre serveur web soit
|
|
accessible, son nom doit être enregistré dans le DNS.</p>
|
|
|
|
<p>Si vous ne savez pas comment effectuer cet enregistrement, vous
|
|
devrez contacter votre administrateur réseau ou votre fournisseur
|
|
d'accès à Internet afin qu'il effectue cette opération pour vous.</p>
|
|
|
|
<p>Plusieurs noms d'hôte peuvent pointer vers la même adresse IP, et
|
|
plusieurs adresses IP peuvent être attachées au même serveur physique.
|
|
Vous pouvez ainsi héberger plusieurs serveurs web sur le même serveur
|
|
physique grâce au mécanisme des <a href="vhosts/">serveurs virtuels</a>.</p>
|
|
|
|
<p>Pour tester un serveur non encore accessible sur Internet, vous
|
|
pouvez renseigner son nom d'hôte dans votre fichier hosts afin
|
|
d'effectuer une résolution de nom locale. Par exemple, pour tester le
|
|
serveur web <code>www.example.com</code> depuis le serveur physique qui
|
|
l'héberge, vous pouvez ajouter la ligne suivante au fichier hosts de ce
|
|
dernier : </p>
|
|
|
|
<div class="example"><p><code>
|
|
127.0.0.1 www.example.com
|
|
</code></p></div>
|
|
|
|
<p>En général, le fichier hosts se trouve dans le répertoire
|
|
<code>/etc</code> sur les systèmes de style Unix, ou
|
|
<code>C:\Windows\system32\drivers\etc</code> sous Windows.</p>
|
|
|
|
<p>Vous trouverez plus de détails à propos du fichier hosts à <a href="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>,
|
|
et à propos du DNS à <a href="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</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="configuration" id="configuration">Fichiers de configuration et directives</a></h2>
|
|
|
|
|
|
<p>La configuration du serveur HTTP Apache s'effectue via de simples
|
|
fichiers textes. Ces fichiers peuvent se trouver dans de nombreux
|
|
endroits diffé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épertoire par défaut
|
|
des fichiers de configuration est <code>/usr/local/apache2/conf</code>.
|
|
Le nom du fichier de configuration par défaut est en géné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énéral divisé en plusieurs
|
|
fichiers afin d'en faciliter la gestion. Ces fichiers sont inclus dans
|
|
le fichier de configuration principal via la directive <code class="directive"><a href="./mod/core.html#include">Include</a></code>. Les noms ou positions de ces fichiers
|
|
ne sont pas figés et peuvent varier considérablement d'une distribution
|
|
à l'autre. N'hésitez pas à les arranger et subdiviser selon
|
|
<strong>vos</strong> goûts et besoins, quitte à en modifier
|
|
l'organisation par défaut.</p>
|
|
|
|
<p>La configuration du serveur s'effectue via des <a href="mod/quickreference.html">directives de configuration</a> que l'on
|
|
insère dans les fichiers de configuration. Une directive se compose d'un
|
|
mot-clé suivi d'un ou plusieurs arguments qui définissent sa valeur.</p>
|
|
|
|
<p>La réponse à la question "<em>Où dois-je placer cette directive
|
|
?</em>" dépend en général du niveau auquel cette directive doit être
|
|
prise en compte. S'il s'agit du niveau global, elle doit être placée
|
|
dans le fichier de configuration principal, et en dehors de toute
|
|
section <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>, ou de toute autre section. Si
|
|
par exemple elle ne doit s'appliquer qu'à un répertoire particulier,
|
|
elle doit être placée dans la section <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> qui fait référence à ce répertoire.
|
|
Voir la documentation sur les <a href="sections.html">Sections de
|
|
configuration</a> pour plus de détails.</p>
|
|
|
|
<p>En complément des fichiers de configuration principaux, certaines
|
|
directives peuvent être insérées dans des fichiers
|
|
<code>.htaccess</code> que l'on place directement dans le répertoire
|
|
concerné. Les fichiers <code>.htaccess</code> sont essentiellement
|
|
destinés aux personnes qui n'ont pas accès aux fichiers de configuration
|
|
du serveur. Vous trouverez plus de détails à propos des fichiers
|
|
<code>.htaccess</code> dans ce <a href="howto/htaccess.html"><code>.htaccess</code>howto</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="content" id="content">Contenu du site web</a></h2>
|
|
|
|
|
|
<p>Si le contenu du site web peut se présenter sous de nombreuses
|
|
formes, il peut en général être scindé 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ésidant dans le système
|
|
de fichiers. La directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> permet de définir la position
|
|
dans l'arborescence du site où vous devez placer ces fichiers. Cette
|
|
directive peut être définie au niveau global, ou au niveau de chaque
|
|
serveur virtuel. Vous pouvez consulter vos fichiers de configuration
|
|
pour vérifier la manière dont cette directive est définie pour votre
|
|
serveur.</p>
|
|
|
|
<p>En général, et si aucun nom de fichier n'est spécifié dans la
|
|
requête, c'est une page de nom <code>index.html</code> qui sera
|
|
renvoyée. Par exemple, si la directive <code>DocumentRoot</code> est
|
|
définie à <code>/var/www/html</code>, et si une requête est effectué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é au
|
|
client par le serveur.</p>
|
|
|
|
<p>Un contenu dynamique est un contenu qui est généré au moment du
|
|
traitement de la requête, et qui peut différer d'une requête à l'autre.
|
|
Ces contenus dynamiques peuvent être générés de nombreuses manières par
|
|
l'intermédiaire de <a href="handler.html">gestionnaires de contenu</a>
|
|
ou "handlers". Il est aussi possible de créer des <a href="howto/cgi.html">programmes CGI</a> pour générer le contenu de
|
|
votre site.</p>
|
|
|
|
<p>Enfin, on peut utiliser des modules tiers comme mod_php pour écrire
|
|
du code permettant d'effectuer de nombreuses choses. De nombreuses
|
|
applications tierces écrites à partir de divers langages ou outils sont
|
|
disponibles en téléchargement et peuvent être installées sur votre
|
|
serveur HTTP Apache. Le support de ces applications dépasse le sujet de
|
|
ce document, et nous vous invitons à consulter le site de leur éditeur
|
|
pour accéder à leur documentation.</p>
|
|
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<div class="section">
|
|
<h2><a name="logs" id="logs">Fichiers journaux et résolution des problèmes</a></h2>
|
|
|
|
<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ésolution d'un problème sans
|
|
consulter le journal des erreurs revient à conduire les yeux fermés.</p>
|
|
|
|
<p>La position dans le système de fichiers du journal des erreurs est
|
|
spécifiée par la directive <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>
|
|
qui peut être définie au niveau global, ou au niveau de chaque serveur
|
|
virtuel. Chaque entrée du journal des erreurs vous informe sur la nature
|
|
des problèmes et le moment de leur survenue. En outre, elle vous indique
|
|
souvent comment résoudre le problè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étaillée de la manière de
|
|
résoudre le problème. Vous pouvez aussi configurer votre journal des
|
|
erreurs de manière à ce qu'il enregistre un identifiant d'erreur que
|
|
vous pourrez ensuite utiliser pour effectuer une corrélation avec le
|
|
journal des accès afin de déterminer quelle requête est à l'origine de
|
|
l'erreur.</p>
|
|
|
|
<p>Vous trouverez plus de détails à ce sujet dans la <a href="logs.html">Documentation sur la journalisation</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="other" id="other">Et maintenant, quelle est la suite des opérations ?</a></h2>
|
|
|
|
|
|
<p>La question des prérequis étant réglée, il est temps de passer aux
|
|
choses sérieuses.</p>
|
|
|
|
<p>Ce document ne couvre que les notions de base. Nous espérons qu'il
|
|
vous permettra de mettre le pied à l'étrier, mais il y a encore de
|
|
nombreuses choses que vous devez savoir.</p>
|
|
|
|
<ul>
|
|
<li><a href="http://httpd.apache.org/download.cgi">Téléchargement</a></li>
|
|
<li><a href="install.html">Installation</a></li>
|
|
<li><a href="configuring.html">Configuration</a></li>
|
|
<li><a href="invoking.html">Démarrage du serveur</a></li>
|
|
<li><a href="http://wiki.apache.org/httpd/FAQ">Foire aux questions</a></li>
|
|
</ul>
|
|
|
|
</div></div>
|
|
<div class="bottomlang">
|
|
<p><span>Langues Disponibles: </span><a href="./en/getting-started.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
|
<a href="./fr/getting-started.html" title="Français"> fr </a></p>
|
|
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
|
|
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
|
var comments_shortname = 'httpd';
|
|
var comments_identifier = 'http://httpd.apache.org/docs/2.4/getting-started.html';
|
|
(function(w, d) {
|
|
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
|
d.write('<div id="comments_thread"><\/div>');
|
|
var s = d.createElement('script');
|
|
s.type = 'text/javascript';
|
|
s.async = true;
|
|
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
|
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
|
}
|
|
else {
|
|
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
|
}
|
|
})(window, document);
|
|
//--><!]]></script></div><div id="footer">
|
|
<p class="apache">Copyright 2018 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
|
|
if (typeof(prettyPrint) !== 'undefined') {
|
|
prettyPrint();
|
|
}
|
|
//--><!]]></script>
|
|
</body></html> |