1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>Utilisation du serveur HTTP Apache sous Microsoft Windows - Serveur HTTP Apache Version 2.5</title>
11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <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" />
14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
18 <body id="manual-page"><div id="page-header">
19 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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>
20 <p class="apache">Serveur HTTP Apache Version 2.5</p>
21 <img alt="" src="../images/feather.png" /></div>
22 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
24 <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.5</a> > <a href="./">Notes spécifiques à un
25 système</a></div><div id="page-content"><div id="preamble"><h1>Utilisation du serveur HTTP Apache sous Microsoft Windows</h1>
27 <p><span>Langues Disponibles: </span><a href="../en/platform/windows.html" hreflang="en" rel="alternate" title="English"> en </a> |
28 <a href="../fr/platform/windows.html" title="Français"> fr </a> |
29 <a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
33 <p>Ce document décrit l'installation, la configuration et
34 l'exécution d'Apache 2.5 sous Microsoft Windows. Si vous avez des
35 questions après avoir lu la documentation, ou si vous avez rencontré
36 des évènements particuliers ou des rapports d'erreur, vous pouvez
37 consultez la <a href="http://httpd.apache.org/userslist.html">liste
38 de diffusion de la communauté des utilisateurs</a>.</p>
40 <p>Dans ce document, nous supposons que vous installez une
41 distribution binaire d'Apache. Si vous voulez compiler Apache
42 vous-même (par exemple pour aider au développement ou pour
43 rechercher des bogues), référez-vous au document <a href="win_compiling.html">Compilation d'Apache pour Microsoft
47 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Prérequis du système d'exploitation</a></li>
48 <li><img alt="" src="../images/down.gif" /> <a href="#down">Téléchargement d'Apache pour Windows</a></li>
49 <li><img alt="" src="../images/down.gif" /> <a href="#cust">Personnaliser Apache pour Windows</a></li>
50 <li><img alt="" src="../images/down.gif" /> <a href="#winsvc">Exécuter Apache en tant que service</a></li>
51 <li><img alt="" src="../images/down.gif" /> <a href="#wincons">Exécuter Apache depuis la console</a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#test">Vérification de l'installation</a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#windrivemap">Configuration de l'accès aux ressources réseau</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#tuning">Personnalisation sous Windows</a></li>
55 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
56 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
58 <h2><a name="req" id="req">Prérequis du système d'exploitation</a><a title="Lien permanent" href="#req" class="permalink">¶</a></h2>
61 <p>La plate-forme Windows de base pour l'exécution d'Apache 2.5 est
62 Windows 2000 ou supérieur. Veillez à toujours vous procurer et installer le
63 dernier service pack afin d'éviter les bogues du système
66 <div class="note">Les versions du serveur HTTP Apache supérieures à 2.2 ne
67 fonctionneront sous aucun système d'exploitation d'une version
68 antérieure à Windows 2000.</div>
70 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
72 <h2><a name="down" id="down">Téléchargement d'Apache pour Windows</a><a title="Lien permanent" href="#down" class="permalink">¶</a></h2>
75 <p>Le projet du serveur HTTP Apache proprement dit ne fournit pas de
76 distribution binaire mais seulement le code source. Certains membres
77 du projet <em>peuvent</em> mettre à disposition des paquets binaires
78 à titre individuel, mais ceux-ci n'ont pas vocation à être
79 distribués publiquement.</p>
82 pas en mesure de compiler le serveur HTTP Apache vous-même, vous
83 pouvez vous procurer un paquet binaire auprès des nombreuses
84 distributions disponibles sur Internet.</p>
86 <p>Quelques solutions populaires pour déployer Apache httpd, et
87 éventuellement PHP et MySQL sous Microsoft Windows :</p>
89 <li><a href="http://www.apachehaus.com/cgi-bin/download.plx">ApacheHaus</a></li>
90 <li><a href="http://www.apachelounge.com/download/">Apache Lounge</a></li>
91 <li><a href="http://bitnami.com/stack/wamp">Bitnami WAMP Stack</a></li>
92 <li><a href="http://www.wampserver.com/">WampServer</a></li>
93 <li><a href="http://www.apachefriends.org/en/xampp.html">XAMPP</a></li>
95 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
97 <h2><a name="cust" id="cust">Personnaliser Apache pour Windows</a><a title="Lien permanent" href="#cust" class="permalink">¶</a></h2>
100 <p>La configuration d'Apache est enregistrée dans les fichiers du
101 sous-répertoire <code>conf</code>. Ce sont les même fichiers que
102 ceux utilisés pour configurer la version Unix, mais il y a quelques
103 directives spécifiques à Apache pour Windows. Voir l'<a href="../mod/directives.html">index des directives</a> pour la liste
104 des directives disponibles.</p>
106 <p>Les principales spécificités d'Apache pour Windows sont :</p>
108 <li><p>Comme Apache pour Windows est un programme multithread, il
109 ne lance pas de processus séparé pour chaque requête, comme Apache
110 peut le faire sous Unix. En fait, il n'y a en général que deux
111 processus Apache en exécution : un processus parent, et un
112 processus enfant qui traite les requêtes. Chaque requête est
113 traitée par un thread séparé au sein du processus enfant.</p>
115 <p>Les directives de gestion de processus diffèrent également :</p>
117 <p><code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>
118 : comme dans la version Unix, cette directive contrôle le nombre
120 processus enfant particulier va traiter avant de s'arrêter.
121 Cependant, à la différence d'Unix, un processus de remplacement
122 n'est pas instantanément disponible. Utilisez la définition par
123 défaut <code>MaxConnectionsPerChild 0</code>, sauf si vous
124 risquez de manquer de mémoire dans des modules tiers ou dans des
125 applications in-process.</p>
127 <div class="warning"><strong>Attention : le fichier de
128 configuration du serveur est rechargé lorsqu'un nouveau processus
129 enfant est démarré. En conséquence, si vous avez modifié
130 <code>httpd.conf</code>, le nouveau processus enfant peut ne pas
131 démarrer, ou vous pouvez obtenir des résultats
132 inattendus.</strong></div>
134 <p><code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> : il
135 s'agit d'une nouvelle directive. Elle indique au serveur le nombre
136 de threads qu'il doit utiliser. Elle définit le nombre maximum de
137 connexions simultanées que le serveur peut gérer ; vous devez
138 donc vous assurer que ce nombre soit suffisamment grand pour les
139 besoins de votre site. La valeur par défaut <code>ThreadsPerChild
140 150</code> est recommandée, mais doit être ajustée à la valeur
141 maximale estimée de connexions simultanées à accepter.</p></li>
143 <li><p>Les directives qui acceptent des noms de fichiers comme
144 arguments doivent utiliser des noms de fichiers Windows et non
145 Unix. Cependant, comme Apache peut interpréter les anti-slashes
146 comme des séquences d'échappement de caractères, vous devez
147 absolument utiliser des slashes dans les noms de chemins à la
148 place des anti-slashes.</p></li>
150 <li><p>Alors que les noms de fichiers sont en général insensibles
151 à la casse sous Windows, les URLs sont encore sensibles à la casse
152 en interne avant d'être mises en correspondance avec le système de
153 fichiers. Par exemple, les directives <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, et <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> utilisent toutes des
154 arguments sensibles à la casse. Pour cette raison, il est
155 particulièrement recommandé d'utiliser la directive <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> lorsqu'on
156 désire limiter l'accès à certains contenus du système de fichiers,
157 car cette directive s'applique à tout contenu d'un répertoire,
158 sans tenir compte de la manière dont on y accède. Pour vous
159 assurer que seules des minuscules sont utilisées dans les URLs,
160 vous pouvez utiliser ceci :</p>
162 <pre class="prettyprint lang-config">RewriteEngine On
163 RewriteMap lowercase "int:tolower"
164 RewriteCond "%{REQUEST_URI}" "[A-Z]"
165 RewriteRule "(.*)" "${lowercase:$1}" [R,L]</pre>
168 <li><p>Lors de son exécution, Apache n'a besoin d'un accès en
169 écriture qu'au répertoire des journaux et à toute arborescence de
170 répertoires de cache configurée. Suite au problème d'insensibilité
171 à la casse et au format de noms courts 8.3, Apache doit valider
172 tous les noms de chemins fournis. Cela signifie que chaque
173 répertoire qu'Apache évalue doit avoir les droits en lecture,
174 listage et parcours, et ceci depuis la racine jusqu'aux feuilles.
175 Si Apache2.5 est installé dans C:\Program Files, le répertoire
176 racine, Program Files et Apache2.5 doivent tous être visibles pour
179 <li><p>Apache peut charger divers modules sans qu'il soit nécessaire
180 de recompiler le serveur. Si Apache est compilé
181 normalement, il va installer de nombreux modules optionnels dans
182 le répertoire <code>\Apache2.5\modules</code>. Pour activer ces
183 modules ou d'autres modules, on doit utiliser la
184 directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Par
185 exemple, pour activer le module status, ajoutez la ligne suivante
186 (en plus des directives d'activation de status dans
187 <code>access.conf</code>) :</p>
189 <pre class="prettyprint lang-config">LoadModule status_module "modules/mod_status.so"</pre>
192 <p>Des informations sont aussi à votre disposition pour <a href="../mod/mod_so.html#creating">créer des modules
193 chargeables</a></p></li>
195 <li><p>Apache peut aussi charger des extensions ISAPI (Internet
196 Server Application Programming Interface), comme celles qu'utilise
197 Microsoft IIS et d'autres serveurs Windows. <a href="../mod/mod_isapi.html">Voir ici pour plus
198 d'informations</a>. Notez qu'Apache ne peut <strong>pas</strong>
199 charger de filtres ISAPI, et que les gestionnaires ISAPI contenant
200 des extensions de fonctionnalités Microsoft ne fonctionneront
203 <li><p>Pour les scripts CGI, la méthode qu'utilise Apache pour
204 déterminer l'interpréteur du script est configurable grâce à la
205 directive <code class="directive"><a href="../mod/core.html#scriptinterpretersource">ScriptInterpreterSource</a></code></p></li>
207 <li><p>Comme il est souvent difficile de gérer des fichiers avec
208 des noms du style <code>.htaccess</code> sous Windows, vous avez
209 tout intérêt à changer le nom de ce fichier de configuration par
210 répertoire à l'aide de la directive <code class="directive"><a href="../mod/core.html#accessfilename">AccessFilename</a></code>.</p></li>
212 <li><p>Toute erreur survenant au cours du processus de démarrage
213 d'Apache est enregistrée dans le journal des évènements de
214 Windows si l'on est sous Windows NT. Ce mécanisme fonctionne comme
215 une sauvegarde pour les situations où Apache n'est pas encore prêt
216 à utiliser le fichier <code>error.log</code>. Vous pouvez
217 consulter le journal des évènements applicatifs Windows en
218 utilisant l'observateur d'évènements : Démarrage - Paramètres -
219 Panneau de configuration - Outils d'administration - Observateur
220 d'évènements.</p></li>
223 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
224 <div class="section">
225 <h2><a name="winsvc" id="winsvc">Exécuter Apache en tant que service</a><a title="Lien permanent" href="#winsvc" class="permalink">¶</a></h2>
228 <p>Apache fournit un utilitaire nommé Apache Service Monitor
229 (Moniteur du service Apache). Grâce à lui, vous pouvez voir et gérer
230 l'état de tous les services Apache installés sur toutes les machines
231 du réseau. Pour pouvoir gérer un service Apache avec le moniteur,
232 vous devez d'abord installer le service (soit automatiquement au
233 cours de l'installation, soit manuellement).</p>
235 <p>Vous pouvez installer Apache en tant que service Windows NT à
236 partir de la ligne de commandes et depuis le sous-répertoire Apache
237 <code>bin</code> comme suit :</p>
239 <div class="example"><p><code>
243 <p>Si vous avez installé plusieurs services Apache sur votre
244 ordinateur, vous devrez spécifier le nom du service que vous voulez
245 installer en utilisant la commande suivante (notez que si vous
246 spécifiez un nom durant l'installation, vous devrez aussi le
247 spécifier pour toute opération comportant l'option -k) :</p>
249 <div class="example"><p><code>
250 httpd.exe -k install -n "Nom-service"
253 <p>Si un service doit utiliser un fichier de configuration
254 spécifique, utilisez ceci :</p>
256 <div class="example"><p><code>
257 httpd.exe -k install -n "Nom-service" -f "c:\fichiers\Nom-service.conf"
260 <p>Si vous utilisez la première commande sans paramètre particulier,
261 excepté <code>-k install</code>, le service aura pour nom
262 <code>Apache2.5</code> et le fichier de configuration sera censé
263 être <code>conf\httpd.conf</code>.</p>
265 <p>Supprimer un service Apache est très simple. Utilisez
268 <div class="example"><p><code>
269 httpd.exe -k uninstall
272 <p>On peut spécifier un service Apache particulier en utilisant
275 <div class="example"><p><code>
276 httpd.exe -k uninstall -n "Nom service"
279 <p>Normalement, le démarrage, le redémarrage et l'arrêt d'un
280 service Apache s'effectuent via le Moniteur de Service Apache, ou en
281 utilisant des commandes telles que <code>NET START Apache2.5</code> et
282 <code>NET STOP Apache2.5</code>, ou encore via le gestionnaire de
283 services standard de Windows. Avant de démarrer Apache en tant que
284 service dans quelque but que ce soit, vous devez tester le fichier
285 de configuration du service en utilisant :</p>
287 <div class="example"><p><code>
288 httpd.exe -n "Nom-service" -t
291 <p>Vous pouvez aussi contrôler un service Apache à l'aide de ses
292 options de ligne de commande. Avec cette méthode, pour démarrer un
293 service Apache installé, vous utiliserez :</p>
295 <div class="example"><p><code>
296 httpd.exe -k start -n "Nom-Service"
299 <p>Pour arrêter un service Apache via les options de lignes de
300 commande, utilisez ceci :</p>
302 <div class="example"><p><code>
303 httpd.exe -k stop -n "Nom-Service"
308 <div class="example"><p><code>
309 httpd.exe -k shutdown -n "Nom-Service"
312 <p>Vous pouvez aussi redémarrer un service en exécution et le forcer
313 à relire son fichier de configuration en utilisant :</p>
315 <div class="example"><p><code>
316 httpd.exe -k restart -n "Nom-Service"
319 <p>Par défaut, tous les services Apache sont configurés pour
320 s'exécuter sous l'utilisateur system (le compte
321 <code>LocalSystem</code>). Le compte <code>LocalSystem</code> n'a
322 pas de privilèges sur votre réseau, que ce soit via un mécanisme
323 sécurisé de Windows, y compris le système de fichiers, des tubes
324 nommés, DCOM ou des RPC sécurisés. Il a cependant des privilèges
327 <div class="warning"><strong>N'accordez jamais de privilèges réseau
328 au compte <code>LocalSystem</code> ! Si Apache doit pouvoir accéder
329 à des ressources réseau, créez un compte séparé pour Apache comme
330 indiqué ci-dessous.</strong></div>
332 <p>Il est fortement fortement conseillé aux utilisateurs de créer un
333 compte séparé pour exécuter le(s) service(s) Apache, et même
334 obligatoire si vous devez accéder à des ressources réseau via
338 <li>Créez un compte d'utilisateur du domaine normal, et
339 assurez-vous de retenir son mot de passe.</li>
341 <li>Accordez à l'utilisateur nouvellement créé les privilèges
342 <code>Log on as a service</code> et <code>Act as part of the
343 operating system</code>. Sous Windows NT 4.0, ces privilèges sont
344 accordés via le Gestionnaire des utilisateurs du Domaine, mais
345 sous Windows 2000 et XP, vous aurez plutôt intérêt à utiliser une
346 GPO pour propager ces configurations. Vous pouvez aussi effectuer
347 ces réglages via la Politique de Sécurité Locale intégrée à la
350 <li>Vérifiez que le compte nouvellement créé est membre du groupe
353 <li>Accordez à ce compte les droits Lecture et Exécution (RX) sur
354 tous les documents et répertoires de scripts (<code>htdocs</code>
355 et <code>cgi-bin</code> par exemple), et aussi sur l'exécutable
356 binaire <code>httpd.exe</code>.</li>
358 <li>Accordez aussi à ce compte les droits de modification sur le
359 répertoire <code>logs</code>.</li>
363 <div class="note">Il est en général de bonne pratique d'accorder à l'utilisateur
364 sous lequel le service Apache s'exécute les droits en lecture et
365 exécution (RX) sur l'ensemble du répertoire Apache2.5, sauf pour le
366 sous-répertoire <code>logs</code>, sur lequel l'utilisateur doit
367 avoir au moins les droits de modification (RWXD).</div>
369 <p>Si vous permettez à ce compte de se connecter en tant
370 qu'utilisateur et service, vous pouvez ouvrir une session sous ce
371 compte et vérifier s'il a bien le droit d'exécuter les scripts, de
372 lire les pages web, et si vous pouvez démarrer Apache à partir d'une
373 console Windows. Si tout fonctionne, et si vous avez suivi les
374 étapes ci-dessus, Apache devrait s'exécuter en tant que service sans
377 <div class="note"><strong>Le code d'erreur 2186</strong> indique probablement
378 qu'Apache ne peut pas accéder à une ressource réseau nécessaire, et
379 que vous devez revoir la configuration "Log On As" (Se connecter en
380 tant que ...) du service.</div>
382 <p>Lorsqu'Apache démarre en tant que service, il se peut que vous
383 obteniez un message d'erreur du Gestionnaire de Services Windows.
384 Par exemple, si vous essayez de démarrer Apache en utilisant
385 l'applet Services du Panneau de configuration de Windows, vous
386 pouvez obtenir le message suivant :</p>
388 <div class="example"><p><code>
389 Could not start the Apache2.5 service on \\COMPUTER <br />
390 Error 1067; The process terminated unexpectedly.
393 <p>Vous obtiendrez cette erreur à caractère général pour tout
394 problème survenant au cours du démarrage du service Apache. Afin de
395 déterminer exactement la cause du problème, vous devez suivre les
396 instructions permettant d'exécuter Apache pour Windows depuis la
397 ligne de commande.</p>
399 <p>Si vous rencontrez des problèmes avec le service, il est
400 conseillé de suivre les instructions ci-dessous afin d'essayer de
401 démarrer httpd.exe depuis une console, et d'analyser les erreurs
402 plutôt que vous démener à essayer de démarrer le service.</p>
404 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
405 <div class="section">
406 <h2><a name="wincons" id="wincons">Exécuter Apache depuis la console</a><a title="Lien permanent" href="#wincons" class="permalink">¶</a></h2>
409 <p>Il est en général recommandé d'exécuter Apache en tant que
410 service, mais il est parfois plus simple d'utiliser la ligne de
411 commande, en particulier au cours de la configuration initiale et
414 <p>Pour exécuter Apache depuis la ligne de commande et en tant
415 qu'application de console, utilisez la commande suivante :</p>
417 <div class="example"><p><code>
421 <p>Apache va démarrer, et continuera son exécution jusqu'à ce qu'on
422 l'arrête en tapant Ctrl-C.</p>
424 <p>Vous pouvez également démarrer Apache via le raccourci "Démarrer
425 Apache dans une console" placé dans <code>Démarrer -->
426 Programmes --> Apache HTTP Server 2.5.xx --> Control Apache
427 Server</code> au cours de l'installation. Ceci va
428 ouvrir une console Windows, et y démarrer Apache.
429 Si vous n'avez pas installé Apache en tant que service, la
430 fenêtre Windows restera ouverte jusqu'à ce que vous arrêtiez Apache
431 en tapant Ctrl-C dans cette fenêtre. Le serveur va alors s'arrêter
432 au bout de quelques secondes. Cependant, si vous avez installé
433 Apache en tant que service, c'est ce dernier que le raccourci
434 ci-dessus va lancer. Si le service Apache est déjà en cours
435 d'exécution, le raccourci va rester sans effet.</p>
437 <p>Si Apache s'exécute en tant que service, vous pouvez l'arrêter en
438 ouvrant une autre console et en entrant :</p>
440 <div class="example"><p><code>
441 httpd.exe -k shutdown
444 <p>Plutôt que de lancer Apache à partir d'une console, il est
445 préférable de l'exécuter en tant que service car dans ce cas, il
446 termine proprement les opérations en cours avant de s'éteindre.</p>
448 <p>Si le serveur a été lancé depuis une console, vous ne pouvez
449 l'arrêter qu'en pressant la combinaison de touches Ctrl-C dans la
452 <p>Vous pouvez aussi redémarrer Apache. Ceci le force à recharger
453 son fichier de configuration. Toute opération en cours peut être
454 achevée sans interruption. Pour redémarrer Apache, vous pouvez soit
455 taper Control-Break dans la fenêtre de console que vous avez
456 utilisée pour le démarrer, soit entrer :</p>
458 <div class="example"><p><code>
462 <p>si le serveur s'exécute en tant que service.</p>
464 <div class="note">Note pour les utilisateurs familiers de la version Unix
465 d'Apache : les commandes ci-dessus représentent pour Windows
466 l'équivalent des commandes <code>kill -TERM <em>pid</em></code> et
467 <code>kill -USR1 <em>pid</em></code>. L'option de ligne de commande
468 <code>-k</code> a été choisie à titre de rapprochement avec la
469 commande <code>kill</code> utilisée sous Unix.</div>
471 <p>Si la fenêtre de la console Apache se ferme immédiatement ou
472 inopinément après le démarrage d'Apache, ouvrez une console Windows
473 depuis le menu Démarrer --> Programmes. Placez-vous dans le
474 répertoire d'installation d'Apache, tapez la commande
475 <code>httpd.exe</code>, et observez le message d'erreur. Allez
476 ensuite dans le répertoire des journaux, et visualisez le fichier
477 <code>error.log</code> pour détecter d'éventuelles erreurs de
478 configuration. Si Apache a été installé dans <code>C:\Program
479 Files\Apache Software Foundation\Apache2.5\</code>, vous
480 pouvez entrer ce qui suit :</p>
482 <div class="example"><p><code>
484 cd "\Program Files\Apache Software Foundation\Apache2.5\bin" <br />
488 <p>Attendez ensuite qu'Apache s'arrête ou tapez Ctrl-C. Entrez alors
489 la commande suivante :</p>
491 <div class="example"><p><code>
496 <p>Lorsqu'on travaille avec Apache, il est important de comprendre
497 comment ce dernier trouve son fichier de configuration. Vous pouvez
498 spécifier un fichier de configuration à partir de la ligne de
499 commande de deux façons :</p>
502 <li><p>L'option <code>-f</code> permet de spécifier un chemin
503 absolu ou relatif vers un fichier de configuration particulier
504 :</p>(sous Windows 9x, il est recommandé d'utiliser la ligne de
505 commande à cause du manque de fiabilité du support des services
506 fourni par ce système).
508 <div class="example"><p><code>
509 httpd.exe -f "c:\fichiers-de-mon-serveur\autre-config.conf"
514 <div class="example"><p><code>
515 httpd.exe -f fichiers-de-mon-serveur\autre-config.conf
516 </code></p></div></li>
518 <li><p>L'option <code>-n</code> permet de spécifier le service
519 Apache installé dont le fichier de configuration doit être utilisé
522 <div class="example"><p><code>
523 httpd.exe -n "Nom-service"
528 <p>Dans les deux cas, la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> doit être correctement définie
529 dans le fichier de configuration.</p>
531 <p>Si vous ne spécifiez aucun fichier de configuration à l'aide des
532 options <code>-f</code> ou <code>-n</code>, Apache utilisera le nom
533 du fichier de configuration compilé dans le serveur, en général
534 <code>conf\httpd.conf</code>. Ce chemin codé en dur est relatif au
535 répertoire d'installation. Vous pouvez vérifier ce chemin à partir
536 de la valeur de l'étiquette <code>SERVER_CONFIG_FILE</code> en
537 invoquant Apache avec l'option <code>-V</code>, comme ceci :</p>
539 <div class="example"><p><code>
543 <p>Apache va ensuite essayer de déterminer la valeur de son
544 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> en effectuant les
545 recherches suivantes, dans cet ordre :</p>
548 <li>Une directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>
549 via l'option de ligne de commande <code>-C</code>.</li>
551 <li>L'option de ligne de commande <code>-d</code>.</li>
553 <li>Le répertoire de travail courant.</li>
555 <li>Une entrée de la base de registre créée dans le cas d'une
556 installation binaire.</li>
558 <li>La racine des documents (<code>DocumentRoot</code>) codée en dur
559 dans le serveur. Elle
560 correspond par défaut à <code>/apache</code>, et vous pouvez le
561 vérifier en tapant <code>httpd.exe -V</code> et en recherchant
562 l'étiquette <code>HTTPD_ROOT</code>.</li>
565 <p>Si vous n'avez pas effectué d'installation binaire, dans certains
566 scénarios, Apache va signaler l'absence de cette clé de registre.
567 On peut passer outre cet avertissement si le serveur a été en mesure
568 de trouver son fichier de configuration d'une autre manière.</p>
570 <p>La valeur de cette clé correspond au répertoire <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> qui contient lui-même le
571 sous-répertoire <code>conf</code>. Lors de son démarrage, Apache lit
572 le fichier <code>httpd.conf</code> à partir de ce répertoire. Si ce
573 fichier contient une directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> qui spécifie un répertoire
574 différent de celui que contient la clé de registre ci-dessus, Apache
575 oubliera la clé de registre, et utilisera le répertoire spécifié par
576 le fichier de configuration. Si vous déplacez le répertoire Apache
577 ou ses fichiers de configuration, il est vital de mettre à jour la
578 directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> dans
579 <code>httpd.conf</code> afin de refléter la nouvelle
582 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
583 <div class="section">
584 <h2><a name="test" id="test">Vérification de l'installation</a><a title="Lien permanent" href="#test" class="permalink">¶</a></h2>
587 <p>Une fois Apache démarré (soit à partir d'une console Windows,
588 soit en tant que service), ce dernier va se mettre à l'écoute sur
589 le port 80 (à moins que vous ayiez modifié la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> dans les fichiers de
590 configuration ou que vous ayiez installé Apache pour l'utilisateur
591 courant seulement). Pour vous connecter au serveur et accéder à la
592 page par défaut, lancez un navigateur et entrez cette URL :</p>
594 <div class="example"><p><code>
598 <p>Apache devrait renvoyer une page de bienvenue et vous devriez
599 voir s'afficher "It Works!". Si rien ne se passe ou si vous obtenez
600 une erreur, consultez le fichier <code>error.log</code> dans le
601 sous-répertoire <code>logs</code>. Si votre serveur n'est pas
602 connecté au réseau, ou si vous avez de sérieux problèmes avec la
603 configuration de votre DNS (Domain Name Service), vous devez
604 utiliser cette URL :</p>
606 <div class="example"><p><code>
610 <p>Si Apache écoute un port non standard, vous devez le préciser
611 explicitement dans l'URL :</p>
613 <div class="example"><p><code>
614 http://127.0.0.1:8080/
617 <p>Après que votre installation de base fonctionne, vous devez la
618 configurer correctement en éditant les fichiers du sous-répertoire
619 <code>conf</code>. Encore une fois, si vous modifiez la
620 configuration du service Apache sous Windows NT, essayez d'abord de
621 redémarrer le service depuis la ligne de commande afin de vous
622 assurer de l'absence d'erreur.</p>
624 <p>Comme Apache <strong>ne peut pas</strong> partager le même port
625 avec d'autres applications TCP/IP, il se peut que vous soyez amené à
626 arrêter, désinstaller ou reconfigurer certains services avant de
627 démarrer Apache. Ces services entrant en conflit avec Apache
628 comprennent les autres serveurs WWW, certaines implémentations de
629 pare-feu, et même certaines applications client (comme Skype) qui
630 utilisent le port 80 afin de contourner les pare-feu.</p>
632 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
633 <div class="section">
634 <h2><a name="windrivemap" id="windrivemap">Configuration de l'accès aux ressources réseau</a><a title="Lien permanent" href="#windrivemap" class="permalink">¶</a></h2>
637 <p>L'accès à des fichiers par le réseau peut être spécifié via deux
638 mécanismes fournis par Windows :</p>
641 <dt>Association de lettres de lecteur</dt>
642 <dd>Par exemple, <code>Alias /images/ Z:/</code></dd>
645 <dd>Par exemple, <code>Alias /images/ //imagehost/www/images/</code></dd>
648 <p>L'association de lettres de lecteur permet à l'administrateur de
649 maintenir une correspondance avec une certaine machine et un certain
650 chemin en dehors de la configuration d'Apache httpd. Cependant, ces
651 associations ne sont possibles que dans le cadre des sessions
652 interactives, et ne sont pas directement disponibles pour Apache httpd
653 lorsqu'il est démarré en tant que service. <strong>N'utilisez par
655 chemins UNC pour les ressources réseau dans httpd.conf,</strong> de
656 façon à ce que les ressources soient accessibles quelle que soit la
657 manière dont Apache httpd a été démarré (des procédures exotiques et
658 probablement sujettes aux erreurs peuvent permettre de contourner la
659 restriction due aux associations de lettres de lecteur, mais leur
660 utilisation est déconseillée).</p>
662 <div class="example"><h3>Exemple de DocumentRoot avec chemin UNC</h3><pre class="prettyprint lang-config">DocumentRoot "//dochost/www/html/"</pre>
665 <div class="example"><h3>Exemple de DocumentRoot avec adresse IP dans le chemin UNC</h3><pre class="prettyprint lang-config">DocumentRoot "//192.168.1.50/docs/"</pre>
668 <div class="example"><h3>Exemple d'Alias et répertoire correspondant avec
669 chemin UNC</h3><pre class="prettyprint lang-config">Alias "/images/" "//imagehost/www/images/"
671 <Directory "//imagehost/www/images/">
673 <Directory></pre>
676 <p>Lorsqu'Apache s'exécute en tant que service, vous devez créer un
677 compte spécifique afin de pouvoir accéder aux ressources réseau, comme
678 décrit ci-dessus.</p>
679 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
680 <div class="section">
681 <h2><a name="tuning" id="tuning">Personnalisation sous Windows</a><a title="Lien permanent" href="#tuning" class="permalink">¶</a></h2>
684 <li><p>Si on utilise un grand nombre de redirections de journaux
685 via des pipes, il est souvent nécessaire d'augmenter la
686 taille de la mémoire du bureau ("desktop heap"). Pour une information plus
687 détaillée, veuillez vous reporter à la documentation sur les <a href="../logs.html#piped">redirections de journaux</a>.</p></li>
690 <div class="bottomlang">
691 <p><span>Langues Disponibles: </span><a href="../en/platform/windows.html" hreflang="en" rel="alternate" title="English"> en </a> |
692 <a href="../fr/platform/windows.html" title="Français"> fr </a> |
693 <a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
694 </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>
695 <script type="text/javascript"><!--//--><![CDATA[//><!--
696 var comments_shortname = 'httpd';
697 var comments_identifier = 'http://httpd.apache.org/docs/trunk/platform/windows.html';
699 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
700 d.write('<div id="comments_thread"><\/div>');
701 var s = d.createElement('script');
702 s.type = 'text/javascript';
704 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
705 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
708 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
710 })(window, document);
711 //--><!]]></script></div><div id="footer">
712 <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>
713 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
714 if (typeof(prettyPrint) !== 'undefined') {