<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 807930:930744 (outdated) -->
+<!-- English Revision: 930744 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
journalisation et interpréter le contenu des journaux.</p>
</summary>
+ <section id="overview">
+ <title>Vue d'ensemble</title>
+
+ <related>
+ <modulelist>
+ <module>mod_log_config</module>
+ <module>mod_log_forensic</module>
+ <module>mod_logio</module>
+ <module>mod_rewrite</module>
+ <module>mod_cgi</module>
+ </modulelist>
+ </related>
+
+ <p>
+ Le serveur HTTP Apache fournit toute une variété de mécanismes
+ différents pour la journalisation de tout ce qui peut se passer au
+ sein de votre serveur, depuis la requête initiale, en passant par le
+ processus de mise en correspondance des URLs, et jusqu'à la fermeture
+ de la connexion, y compris toute erreur pouvant survenir au cours du
+ traitement. De plus, certains modules tiers fournissent des
+ fonctionnalités de journalisation ou insèrent des entrées dans les
+ fichiers journaux existants, et les applications comme les programmes
+ CGI, les scripts PHP ou autres gestionnaires peuvent envoyer des
+ messages vers le journal des erreurs du serveur.
+ </p>
+
+ <p>
+ Ce document décrit le fonctionnement des modules de journalisation
+ fournis en standard avec le serveur httpd.
+ </p>
+
+ </section>
+
<section id="security">
<title>Avertissement à propos de la sécurité</title>
<p>Tout utilisateur qui a les droits en écriture sur le répertoire dans
- lequel Apache écrit ses journaux pourra quasi
+ lequel Apache httpd écrit ses journaux pourra quasi
certainement avoir accès à l'uid sous lequel le serveur est démarré, en
l'occurrence habituellement root. N'accordez <em>PAS</em> aux utilisateurs
l'accès en écriture au répertoire dans lequel les journaux sont stockés
<title>Journal des erreurs</title>
<related>
+ <modulelist>
+ <module>core</module>
+ </modulelist>
<directivelist>
<directive module="core">ErrorLog</directive>
<directive module="core">LogLevel</directive>
les 10000 requêtes. Il est par conséquent nécessaire d'effectuer
périodiquement la rotation des journaux en déplaçant ou supprimant les
fichiers correspondants. On ne peut pas le faire pendant que le serveur
- est en cours d'exécution, car Apache va continuer à écrire dans l'ancien
+ est en cours d'exécution, car Apache httpd va continuer à écrire dans l'ancien
fichier journal aussi longtemps qu'il le maintiendra ouvert.
C'est pourquoi le serveur doit être
<a href="stopping.html">redémarré</a> après le déplacement ou la
vers un tube de communication, remplacez simplement le nom de fichier
journal par
le caractère pipe "<code>|</code>", suivi du nom de l'exécutable qui va
- recueillir les entrées de journal sur son entrée standard. Apache va
+ recueillir les entrées de journal sur son entrée
+ standard. Le serveur va
lancer le processus de redirection des journaux au moment du démarrage du
serveur, et le relancera s'il cesse de fonctionner
pendant l'exécution du serveur.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English revision : 805049 -->
+<!-- English revision : 932380 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<p>De même, soyez méfiant en jouant avec la directive
<directive module="mod_userdir">UserDir</directive> ; la positionner à
<code>"./"</code> aurait le même effet, pour root, que le premier exemple plus haut.
- Si vous utilisez Apache version 1.3 ou supérieure, nous vous conseillons
+ Nous vous conseillons
fortement d'inclure la ligne suivante dans le fichier de configuration de
votre serveur :</p>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 926439 -->
+<!-- English Revision : 932384 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
fichier partiel ou un nom de fichier complet.</p>
<example><title>Exemples</title>
- AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br />
- AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
- AddIcon /icons/backup.xbm *~
+ AddIcon (IMG,/icons/image.png) .gif .jpg .png<br />
+ AddIcon /icons/dir.png ^^DIRECTORY^^<br />
+ AddIcon /icons/backup.png *~
</example>
<p>Lorsque c'est possible, il est préférable d'utiliser <directive
<code>x-compress</code>.</p>
<example><title>Exemple</title>
- AddIconByEncoding /icons/compress.xbm x-compress
+ AddIconByEncoding /icons/compress.png x-compress
</example>
</usage>
</directivesynopsis>
génériques représentant le type MIME.</p>
<example><title>Exemple</title>
- AddIconByType (IMG,/icons/image.xbm) image/*
+ AddIconByType (IMG,/icons/image.png) image/*
</example>
</usage>
</directivesynopsis>
caractères '%') vers l'icône.</p>
<example><title>Exemple</title>
- DefaultIcon /icon/inconnu.xbm
+ DefaultIcon /icon/unknown.png
</example>
</usage>
</directivesynopsis>
-->
<dl><dt>Options d'index incrémentales</dt>
<dd>
- <p>Apache httpd 1.3.3 a apporté d'importantes modifications dans la
- gestion des directives <directive>IndexOptions</directive>. En
- particulier :</p>
+ <p>Vous devez porter une attention particulière à la manière dont
+ les <directive>IndexOptions</directive> multiples sont traitées.</p>
<ul>
<li>Plusieurs directives <directive>IndexOptions</directive>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 804977 -->
+<!-- English Revision : 932389 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<syntax>AddModuleInfo <var>nom-module</var> <var>chaîne</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Disponible depuis la version 1.3 d'Apache</compatibility>
<usage>
<p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 926430 -->
+<!-- English Revision : 931689 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<p>Si en outre, vous désirez activer la mise en cache, consultez la
documentation de <module>mod_cache</module>.</p>
+ <example><title>Mandataire inverse</title>
+ ProxyPass /foo http://foo.example.com/bar<br />
+ ProxyPassReverse /foo http://foo.example.com/bar
+ </example>
+
<example><title>Mandataire direct</title>
ProxyRequests On<br />
ProxyVia On<br />
</indent>
</Proxy>
</example>
-
- <example><title>Mandataire inverse</title>
- ProxyRequests Off<br />
- <br />
- <Proxy *><br />
- <indent>
- Order deny,allow<br />
- Allow from all<br />
- </indent>
- </Proxy><br />
- <br />
- ProxyPass /foo http://foo.example.com/bar<br />
- ProxyPassReverse /foo http://foo.example.com/bar
- </example>
</section> <!-- /examples -->
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 926413 -->
+<!-- English Revision : 932389 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Windows</title>
<note><title>Note</title>
- <p>Le format des noms de modules pour Windows a été modifié avec
- les version 1.3.15 et 2.0 du serveur HTTP Apache - les modules
- possèdent maintenant un nom du style "mod_foo.so".</p>
-
- <p>Bien que mod_so puisse encore charger des modules possèdant un
- nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la
+ <p>Sous Windows, où les modules chargeables possèdent en général
+ l'extension de nom de fichier <code>.dll</code>, les modules Apache
+ httpd se nomment <code>mod_nom-module.so</code>, tout comme sur les
+ autres plates-formes. Vous trouverez cependant encore des modules
+ tiers, comme PHP par exemple, qui continuent d'utiliser la
+ convention de nommage avec extension <code>.dll</code>.</p>
+
+ <p>Bien que <code>mod_so puisse encore charger des modules
+ possèdant un nom du style <code>ApacheModuleFoo.dll</code>,
+ il est préférable d'utiliser la
nouvelle convention de nommage ; si vous modifiez votre module
chargeable pour la version 2.0, veuillez aussi modifier son nom pour
respecter cette nouvelle convention.</p></note>
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 927824:930742 (outdated) -->
+<!-- English Revision: 930742 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 922907:932378 (outdated) -->
+<!-- English Revision: 932378 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<related>
<modulelist>
+<module>mod_actions</module>
<module>mod_alias</module>
+<module>mod_dir</module>
+<module>mod_imagemap</module>
+<module>mod_negotiation</module>
<module>mod_proxy</module>
<module>mod_rewrite</module>
-<module>mod_userdir</module>
<module>mod_speling</module>
+<module>mod_userdir</module>
<module>mod_vhost_alias</module>
</modulelist>
<directivelist>
Cette technique est appelée <em>mandataire inverse ou reverse
proxying</em> car le serveur web agit comme un serveur mandataire en
rapatriant les documents depuis un serveur distant puis les renvoyant
-au client. Ceci diffère d'un service de proxy usuel car, pour le client,
+au client. Ceci diffère d'un service de mandataire usuel (direct) car, pour le client,
les documents semblent appartenir au serveur mandataire inverse.</p>
<p>Dans l'exemple suivant, quand les clients demandent des documents situés
ne seront pas réécrits. Ainsi, tout lien absolu sur
<code>internal.example.com</code> fera décrocher le client
du serveur mandataire et effectuer sa requête directement sur
-<code>internal.example.com</code>. Un module tiers
+<code>internal.example.com</code>. Vous pouvez modifier ces liens (et
+d'utres contenus) situés dans la page au moment où elle est envoyée au
+client en utilisant le module <module>mod_substitute</module>.</p>
+
+<example>
+Substitute s/internal\.example\.com/www.example.com/i
+</example>
+
+<p>En outre, un module tiers
<a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
permet de réécrire les liens dans les documents HTML et XHTML.</p>
</section>
<p>Le moteur de réécriture <module>mod_rewrite</module> peut s'avérer
utile lorsqu'une substitution plus puissante est nécessaire.
- Les directives fournies par ce module utilisent des caractéristiques de la
+ Les directives fournies par ce module peuvent utiliser des caractéristiques de la
requête comme le type de navigateur ou l'adresse IP source afin de décider
depuis où servir le contenu. En outre, mod_rewrite peut utiliser des
fichiers ou programmes de bases de données externes pour déterminer comment
<a href="custom-error.html">Réponses personnalisées aux erreurs</a>.</p>
</section>
+<section id="other"><title>Autres modules de mise en correspondance des
+URLs</title>
+
+<!-- TODO Flesh out each of the items in the list below. -->
+
+ <p>Les autres modules disponibles pour la mise en correspondance des
+ URLs sont :
+ <ul>
+ <li><module>mod_actions</module> - Met une URL en correspondance
+ avec un script CGI en fonction de la méthode de la requête, ou du
+ type MIME de la ressource.</li>
+ <li><module>mod_dir</module> - Permet une mise en correspondance
+ basique d'un slash terminal dans un fichier index comme
+ <code>index.html</code>.</li>
+ <li><module>mod_imagemap</module> - Met en correspondance une
+ requête avec une URL en fonction de la zone d'une image intégrée à
+ un document HTML dans laquelle un utilisateur clique.</li>
+ <li><module>mod_negotiation</module> - Sélectionne le document
+ approprié en fonction de préférences du client telles que la langue
+ ou la compression du contenu.</li>
+ </ul>
+ </p>
+
+</section>
+
</manualpage>
<?xml version='1.0' encoding='ISO-8859-1' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 659902:931524 (outdated) -->
+<!-- English Revision: 931524 -->
<!-- French translation by Vincent Deffontaines, Alain B., review by -->
<!-- updated by Lucien Gentis -->
sera servie par le serveur virtuel par défaut, et toute autre
requête vers une adresse et un port non spécifiés sera servie
par le serveur principal.</p>
+
+ <p>L'utilisation du caractère générique <code>*</code> dans la
+ déclaration d'un serveur virtuel l'emporte sur
+ <code>_default_</code>.</p>
</section>
</section>
<?xml version='1.0' encoding='ISO-8859-1' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 420990:932383 (outdated) -->
+<!-- English Revision: 932383 -->
<!-- french translation by alain B, review by Vincent Deffontaines -->
<!--
ou <em>serveur virtuel non-IP</em>.</p>
<p>Vous trouverez ci-dessous une liste documentaire qui vous
- expliquera en détails le fonctionnement des serveurs virtuels
- sous Apache 1.3 et ses versions suivantes.</p>
+ expliquera en détails le fonctionnement du support des serveurs
+ virtuels par le serveur HTTP Apache.</p>
</summary>
<?xml version='1.0' encoding='ISO-8859-1' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 659902:930608 (outdated) -->
+<!-- English Revision: 930608 -->
<!-- French translation by alain B, review by Vincent Deffontaines
updated by Lucien GENTIS -->
<seealso><a href="details.html">Détails sur le fonctionnement des serveurs virtuels</a></seealso>
<seealso><a href="mass.html">Configuration dynamique des hébergements virtuels de masse</a></seealso>
<seealso><a href="examples.html">Exemples d'utilisations de VirtualHost</a></seealso>
-<seealso><a href="examples.html#serverpath">Utilisation de la directive ServerPath</a></seealso>
<section id="namevip"><title>Serveurs virtuels par nom vs. par IP</title>
sont exposées ci-après :</p>
<ul>
- <li>Certains anciens navigateurs ne sont pas compatibles
- avec les serveurs virtuels par nom, car pour fonctionner,
- un client doit transmettre un champ d'en-tête HTTP Host.
- Cet en-tête est exigé pour HTTP/1.1, et peut être implémenté
- sur des navigateurs modernes HTTP/1.0 grâce à une extension.
- Si vous devez maintenir des clients obsolètes tout en
- utilisant l'hébergement virtuel par nom, il existe une
- technique qui est traitée à la fin de ce document.</li>
-
<li>L'hébergement virtuel par nom ne peut pas être utilisé
avec des serveurs sécurisés SSL à cause de la nature même
du protocole SSL.</li>
<directive module="core">NameVirtualHost</directive>
<directive module="core">ServerAlias</directive>
<directive module="core">ServerName</directive>
- <directive module="core">ServerPath</directive>
<directive module="core" type="section">VirtualHost</directive>
</directivelist>
</related>
</section>
-<section id="compat"><title>Compatibilité avec les navigateurs anciens</title>
-
- <p>Comme mentionné plus tôt, certains clients ne transmettent
- pas les données nécessaires pour le bon fonctionnement des
- serveurs virtuels par nom. Ces clients recevront toujours les pages
- du premier serveur virtuel listé pour cette adresse IP (le
- serveur virtuel par nom <cite>primaire</cite>).</p>
-
- <note><title>De combien plus anciens ?</title>
- <p>Veuillez noter que quand nous disons plus anciens, nous
- disons vraiment plus anciens. Vous avez peu de chances de rencontrer
- de tels navigateurs encore utilisés de nos jours. Toutes les
- versions actuelles des navigateurs transmettent leur en-tête
- <code>Host</code> comme exigé par les serveurs virtuels par nom.</p>
- </note>
-
- <p>Il existe une solution avec la directive
- <directive module="core">ServerPath</directive>, bien que
- légèrement complexe :</p>
-
- <p>Exemple de configuration :</p>
-
- <example>
- NameVirtualHost 111.22.33.44<br />
- <br />
- <VirtualHost 111.22.33.44><br />
- <indent>
- ServerName www.domain.tld<br />
- ServerPath /domain<br />
- DocumentRoot /web/domain<br />
- </indent>
- </VirtualHost><br />
- </example>
-
- <p>Qu'est-ce que cela signifie ? Il signifie qu'une requête
- pour tout URI qui commence par "<code>/domain</code>" sera
- servie par le serveur virtuel <code>www.domain.tld</code>.
- Ainsi, les pages sont accessibles à
- <code>http://www.domain.tld/domain/</code> pour tous les
- clients, bien que ceux qui transmettent un en-tête
- <code>Host:</code> peuvent également y accéder à
- <code>http://www.domain.tld/</code>.</p>
-
- <p>Pour rendre cette technique fonctionnelle, mettez un lien
- dans votre serveur virtuel primaire vers
- <code>http://www.domain.tld/domain/</code>. Ensuite, dans les
- pages de ce serveur virtuel, assurez vous ne n'utiliser que
- des liens relatifs (<em>par exemple</em>, "<code>file.html</code>"
- ou "<code>../icons/image.gif</code>") ou des liens contenant
- le préfixe <code>/domain/</code> (<em>par exemple</em>,
- "<code>http://www.domain.tld/domain/misc/file.html</code>"
- ou "<code>/domain/misc/file.html</code>").</p>
-
- <p>Cela requiert un peu de discipline, mais si vous suivez
- cette ligne de conduite, vous serez assuré que vos pages
- s'afficheront dans tous les navigateurs, nouveaux et anciens.</p>
-
-</section>
</manualpage>