From: Lucien Gentis Date: Sat, 13 Aug 2016 15:23:44 +0000 (+0000) Subject: XML updates. X-Git-Tag: 2.4.24~327 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=40856647a62f4f0ba50332cb0b98df84cbbfee25;p=thirdparty%2Fapache%2Fhttpd.git XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1756275 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_dir.xml.fr b/docs/manual/mod/mod_dir.xml.fr index 8204df021c8..7cd133f0676 100644 --- a/docs/manual/mod/mod_dir.xml.fr +++ b/docs/manual/mod/mod_dir.xml.fr @@ -1,7 +1,7 @@ - + - + @@ -25,40 +25,40 @@ mod_dir Permet la redirection des adresses se terminant par un -répertoire sans slash de fin et la mise à disposition des fichiers index -de répertoire +répertoire sans slash de fin et la mise à disposition des fichiers index +de répertoire Base mod_dir.c dir_module -

L'index d'un répertoire peut provenir de deux sources :

+

L'index d'un répertoire peut provenir de deux sources :

    -
  • Un fichier écrit par l'utilisateur, dont le nom, en général - appelé index.html, peut être défini à l'aide de la +
  • Un fichier écrit par l'utilisateur, dont le nom, en général + appelé index.html, peut être défini à l'aide de la directive DirectoryIndex fournie par le module mod_dir.
    • -
  • Un listing généré par le serveur, par l'intermédiaire du +
  • Un listing généré par le serveur, par l'intermédiaire du module mod_autoindex.

Les deux fonctions sont bien distinctes, si bien que vous pouvez - supprimer (ou remplacer) la génération automatique d'index, si vous + supprimer (ou remplacer) la génération automatique d'index, si vous le souhaitez.

-

Une redirection "slash de fin" est effectuée lorsque le serveur - reçoit une requête pour une URL du style - http://nom-serveur/foo/nom-rep où nom-rep - est le nom d'un répertoire. Comme les répertoires nécessitent un slash de +

Une redirection "slash de fin" est effectuée lorsque le serveur + reçoit une requête pour une URL du style + http://nom-serveur/foo/nom-rep où nom-rep + est le nom d'un répertoire. Comme les répertoires nécessitent un slash de fin, mod_dir effectue une redirection vers http://nom-serveur/foo/nom-rep/.

 DirectoryIndex -Liste des fichiers ressources à rechercher lorsque le -client envoie une requête pour un répertoire +Liste des fichiers ressources à rechercher lorsque le +client envoie une requête pour un répertoire DirectoryIndex disabled | url locale [url locale] ... DirectoryIndex index.html @@ -68,17 +68,17 @@ client envoie une requête pour un répertoire

La directive DirectoryIndex permet de - définir une liste de fichiers ressources à rechercher lorsqu'un - client envoie une requête pour l'index d'un répertoire, en ajoutant - un '/' à la fin du nom de ce dernier. url locale est - l'URL (codée avec caractères '%') d'un document du serveur, relative - au répertoire faisant l'objet de la requête ; il s'agit en général - du nom d'un fichier situé dans le répertoire. Si plusieurs URLs sont - fournies, le serveur renverra la première d'entre elles qui - correspond à une ressource existante. Si aucune ressource ne - correspond à la liste des URLs spécifiées, et si l'option - Indexes est définie, le serveur générera son propre - listing du répertoire.

+ définir une liste de fichiers ressources à rechercher lorsqu'un + client envoie une requête pour l'index d'un répertoire, en ajoutant + un '/' à la fin du nom de ce dernier. url locale est + l'URL (codée avec caractères '%') d'un document du serveur, relative + au répertoire faisant l'objet de la requête ; il s'agit en général + du nom d'un fichier situé dans le répertoire. Si plusieurs URLs sont + fournies, le serveur renverra la première d'entre elles qui + correspond à une ressource existante. Si aucune ressource ne + correspond à la liste des URLs spécifiées, et si l'option + Indexes est définie, le serveur générera son propre + listing du répertoire.

Exemple @@ -86,32 +86,32 @@ client envoie une requête pour un répertoire -

Avec cette configuration, une requête pour l'URL +

Avec cette configuration, une requête pour l'URL http://example.com/docs/ renverrait au client la ressource http://example.com/docs/index.html si elle - existe, ou provoquerait la génération du listing du répertoire si la + existe, ou provoquerait la génération du listing du répertoire si la ressource n'existe pas.

-

Notez qu'il n'est pas nécessaire que les documents soient - relatifs au répertoire ;

+

Notez qu'il n'est pas nécessaire que les documents soient + relatifs au répertoire ;

DirectoryIndex index.html index.txt /cgi-bin/index.pl -

provoquerait l'exécution du script CGI +

provoquerait l'exécution du script CGI /cgi-bin/index.pl si aucun des fichiers index.html ou index.txt n'existe dans le - répertoire considéré.

+ répertoire considéré.

-

La spécification du seul argument "disabled" empêche +

La spécification du seul argument "disabled" empêche mod_dir de rechercher un index. Un argument - "disabled" sera interprété de manière littérale si d'autres - arguments sont présents avant ou après lui, même s'ils sont - eux-mêmes des arguments "disabled".

+ "disabled" sera interprété de manière littérale si d'autres + arguments sont présents avant ou après lui, même s'ils sont + eux-mêmes des arguments "disabled".

Note: Positionner plusieurs directives DirectoryIndex - au coeur du même context complète la liste des ressources et ne l'écrase pas : + au coeur du même context complète la liste des ressources et ne l'écrase pas :

# Exemple A: Positionner index.html en page d'index, puis ajouter index.php. @@ -120,13 +120,13 @@ client envoie une requête pour un répertoire DirectoryIndex index.php </Directory> -# Exemple B: La même chose que l'exemple A, mais réalisé au moyen d'une seule directive. +# Exemple B: La même chose que l'exemple A, mais réalisé au moyen d'une seule directive. <Directory "/foo"> DirectoryIndex index.html index.php </Directory> # Exemple C: Pour remplacer la liste des ressources, il faut d'abord la vider : -# Ici, seul index.php restera référencé comme ressource d'index. +# Ici, seul index.php restera référencé comme ressource d'index. <Directory "/foo"> DirectoryIndex index.html DirectoryIndex disabled @@ -139,8 +139,8 @@ client envoie une requête pour un répertoire DirectoryIndexRedirect -Définit une redirection externe pour les index de -répertoires. +Définit une redirection externe pour les index de +répertoires. DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code @@ -152,20 +152,20 @@ répertoires. Disponible depuis la version 2.3.14 -

Par défaut, c'est la page définie par la directive - DirectoryIndex qui est sélectionnée et - renvoyée de manière transparente au client. La directive +

Par défaut, c'est la page définie par la directive + DirectoryIndex qui est sélectionnée et + renvoyée de manière transparente au client. La directive DirectoryIndexRedirect permet de rediriger le client via une redirection de type 3xx.

-

Les arguments acceptés sont :

+

Les arguments acceptés sont :

  • on : envoie une redirection 302 vers l'index choisi.
  • off : n'envoie aucune redirection. Il s'agit du comportement historique de mod_dir.
  • permanent : envoie une redirection 301 (permanent) vers l'index choisi.
    • -
  • temp : ceci est équivalent à on
    • -
  • seeother : envoie une redirection 303 (également appelée "See Other") vers l'index choisi.
    • -
  • 3xx-code : envoie une redirection accompagnée du code 3xx choisi.
    • +
  • temp : ceci est équivalent à on
    • +
  • seeother : envoie une redirection 303 (également appelée "See Other") vers l'index choisi.
    • +
  • 3xx-code : envoie une redirection accompagnée du code 3xx choisi.
@@ -176,7 +176,7 @@ répertoires. -

Une requête pour http://example.com/docs/ se +

Une requête pour http://example.com/docs/ se solderait par une redirection temporaire vers http://example.com/docs/index.html si cette ressource existe.

@@ -186,7 +186,7 @@ répertoires. DirectorySlash -Activation/Désactivation de la redirection "slash de +Activation/Désactivation de la redirection "slash de fin" DirectorySlash On|Off DirectorySlash On @@ -197,63 +197,63 @@ host

La directive DirectorySlash permet de - déterminer si mod_dir doit corriger ou non les URLs - pointant vers un répertoire.

+ déterminer si mod_dir doit corriger ou non les URLs + pointant vers un répertoire.

-

En général, si un utilisateur envoie une requête pour une - ressource sans slash de fin, cette ressource représentant un - répertoire, mod_dir le redirige vers la même +

En général, si un utilisateur envoie une requête pour une + ressource sans slash de fin, cette ressource représentant un + répertoire, mod_dir le redirige vers la même ressource, mais en ajoutant un slash de fin, et ceci pour plusieurs bonnes raisons :

    -
  • La requête de l'utilisateur contiendra finalement l'URL +
  • La requête de l'utilisateur contiendra finalement l'URL canonique de la ressource
  • mod_autoindex fonctionnera correctement. Comme il n'indique pas le chemin dans le lien, le chemin de l'URL serait incorrect.
  • La directive DirectoryIndex n'est évaluée - que pour les répertoires se terminant par un slash.
    • -
  • Les références à des URLs relatives dans les pages html + module="mod_dir">DirectoryIndex n'est évaluée + que pour les répertoires se terminant par un slash.
    • +
  • Les références à des URLs relatives dans les pages html fonctionneront alors correctement.

Si vous ne souhaitez pas voir ces effets, et si - les raisons évoquées ci-dessus ne s'appliquent pas à vous, vous - pouvez désactiver la redirection comme indiqué ci-dessous. - Gardez cependant à l'esprit que ceci peut avoir des répercutions en - matière de sécurité.

+ les raisons évoquées ci-dessus ne s'appliquent pas à vous, vous + pouvez désactiver la redirection comme indiqué ci-dessous. + Gardez cependant à l'esprit que ceci peut avoir des répercutions en + matière de sécurité.

-# voir l'avertissement de sécurité ci-dessous ! +# voir l'avertissement de sécurité ci-dessous ! <Location "/some/path"> DirectorySlash Off SetHandler some-handler </Location> - Avertissement de sécurité -

La désactivation de la redirection "slash de fin" peut entraîner - la divulgation d'informations. Considérons la situation où + Avertissement de sécurité +

La désactivation de la redirection "slash de fin" peut entraîner + la divulgation d'informations. Considérons la situation où mod_autoindex est actif (Options - +Indexes), où la directive ), où la directive DirectoryIndex a pour valeur une ressource valide (par - exemple index.html), et où aucun gestionnaire - particulier n'a été défini pour cette URL. Dans ce cas, une requête + exemple index.html), et où aucun gestionnaire + particulier n'a été défini pour cette URL. Dans ce cas, une requête avec slash de fin afficherait le contenu du fichier - index.html ; par contre, une requête sans slash + index.html ; par contre, une requête sans slash de fin afficherait un listing du contenu du - répertoire.

+ répertoire.

Notez aussi que certains navigateurs peuvent modifier par erreur - des requêtes POST en requêtes GET lors d'une redirection, les - données POST étant alors perdues.

+ des requêtes POST en requêtes GET lors d'une redirection, les + données POST étant alors perdues.

 FallbackResource -Définit une URL par défaut pour les requêtes qui ne ciblent +Définit une URL par défaut pour les requêtes qui ne ciblent aucun fichier FallbackResource disabled | url-locale disabled - httpd renvoie un code d'erreur 404 (Not Found) @@ -263,38 +263,38 @@ aucun fichier L'argument disabled est disponible à partir de la version 2.4.4 du serveur HTTP Apache. -

Cette directive permet de définir un traitement pour toute URL - qui ne correspond à aucune ressource de votre système de fichiers, +

Cette directive permet de définir un traitement pour toute URL + qui ne correspond à aucune ressource de votre système de fichiers, et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404 (Not Found). Par exemple

FallbackResource /not-404.php -

fait en sorte que les requêtes ne correspondant à aucun fichier - soient traitées par non-404.php, sans affecter les - requêtes pour des fichiers existants.

+

fait en sorte que les requêtes ne correspondant à aucun fichier + soient traitées par non-404.php, sans affecter les + requêtes pour des fichiers existants.

Il est souvent souhaitable qu'un seul fichier ou ressource traite - toutes les requêtes à destination d'un répertoire - particulier, sauf pour les requêtes qui correspondent à un fichier - ou script existant. On y fait souvent référence sous le terme - 'contrôleur frontal'.

-

Dans les versions plus anciennes de httpd, cet effet nécessitait - en général mod_rewrite, et l'utilisation des tests - conditionnels -f et -d pour vérifier - l'existence des fichiers et répertoires. Maintenant, une seule ligne - de configuration est nécessaire.

+ toutes les requêtes à destination d'un répertoire + particulier, sauf pour les requêtes qui correspondent à un fichier + ou script existant. On y fait souvent référence sous le terme + 'contrôleur frontal'.

+

Dans les versions plus anciennes de httpd, cet effet nécessitait + en général mod_rewrite, et l'utilisation des tests + conditionnels -f et -d pour vérifier + l'existence des fichiers et répertoires. Maintenant, une seule ligne + de configuration est nécessaire.

FallbackResource /index.php

Les fichiers existants comme des images, des fichiers css, etc... - seront traités normalement.

+ seront traités normalement.

L'argument disabled permet de désactiver cette fonctionnalité dans le cas où l'héritage d'un répertoire parent n'est pas souhaité.

-

Pour un URI intermédiaire tel que - http://example.com/blog/, cet URI intermédiaire doit être - spécifié en tant que url-locale :

+

Pour un URI intermédiaire tel que + http://example.com/blog/, cet URI intermédiaire doit être + spécifié en tant que url-locale :

<Directory "/web/example.com/htdocs/blog"> FallbackResource /blog/index.php @@ -308,32 +308,32 @@ de la version 2.4.4 du serveur HTTP Apache. DirectoryCheckHandler -Définit la réponse de ce module lorsqu'un autre -gestionnaire est utilisé +Définit la réponse de ce module lorsqu'un autre +gestionnaire est utilisé DirectoryCheckHandler On|Off DirectoryCheckHandler Off server configvirtual host directory.htaccess Indexes Disponible depuis la version 2.4.8 du serveur HTTP -Apache. Les versions antérieures à 2.4 se comportaient implicitement -comme si "DirectoryCheckHandler ON" avait été spécifié. +Apache. Les versions antérieures à 2.4 se comportaient implicitement +comme si "DirectoryCheckHandler ON" avait été spécifié.

La directive DirectoryCheckHandler permet de faire en sorte que mod_dir recherche un index - de répertoire ou ajoute des slashes de fin lorsqu'un autre - gestionnaire à été défini pour l'URL considérée. Les gestionnaires - peuvent être définis à via des directives telles que + de répertoire ou ajoute des slashes de fin lorsqu'un autre + gestionnaire à été défini pour l'URL considérée. Les gestionnaires + peuvent être définis à via des directives telles que SetHandler ou par d'autres modules tels que mod_rewrite au cours des substitutions de niveau répertoire.

-

Dans les versions antérieures à 2.4, ce module ne modifiait pas - son comportement si un autre gestionnaire avait été défini pour - l'URL considérée. Ceci permettait de servir des index de répertoires - même si une directive SetHandler avait été - définie pour un répertoire entier, mais pouvait aussi être à - l'origine de conflits avec d'autres modules.

+

Dans les versions antérieures à 2.4, ce module ne modifiait pas son + comportement si un autre gestionnaire avait été défini pour l'URL + considérée. Ceci permettait de servir des index de répertoires même si une + directive SetHandler avait été définie pour un + répertoire entier, mais pouvait aussi être à l'origine de conflits avec + d'autres modules comme mod_rewrite.

 diff --git a/docs/manual/mod/mod_rewrite.xml.fr b/docs/manual/mod/mod_rewrite.xml.fr index d6e0a92fbbb..a9d593a61a8 100644 --- a/docs/manual/mod/mod_rewrite.xml.fr +++ b/docs/manual/mod/mod_rewrite.xml.fr @@ -1,7 +1,7 @@ - + @@ -1184,15 +1184,14 @@ moteur de réécriture. Cette restriction a été instaurée à des fins de sécurité.
  • Lorsqu'on utilise le moteur de réécriture dans un fichier -.htaccess, le chemin de base du répertoire courant (qui est -toujours le même pour ce même répertoire) est automatiquement -supprimé au cours de la comparaison avec le modèle de la règle -de réécriture, et automatiquement ajouté lorsqu'une -substitution relative (ne débutant pas par un slash ou un nom de -protocole) arrive à la fin d'un jeu de règles. Voir la directive -RewriteBase pour plus de -détails à propos de l'ajout du préfixe après les substitutions -relatives.
    • +.htaccess, le chemin de base du répertoire courant (autrement dit +le chemin URI qui représente le répertoire contenant ce fichier +.htaccess) est automatiquement supprimé au cours de la +comparaison avec le modèle de la règle de réécriture, et automatiquement +ajouté lorsqu'une substitution relative (ne débutant pas par un slash +ou un nom de protocole) arrive à la fin d'un jeu de règles. Voir la directive +RewriteBase pour plus de détails à +propos de l'ajout du préfixe après les substitutions relatives.
  • Si vous souhaitez effectuer une comparaison en prenant en compte l'intégralité du diff --git a/docs/manual/mod/mpm_common.xml.fr b/docs/manual/mod/mpm_common.xml.fr index 4fae03b8e18..8852eb2e33a 100644 --- a/docs/manual/mod/mpm_common.xml.fr +++ b/docs/manual/mod/mpm_common.xml.fr @@ -1,7 +1,7 @@ - + @@ -114,7 +114,7 @@ gestionnaires d'exception après un crash

    Deux modules, mod_whatkilledus et mod_backtrace utilisent ce hook. Veuillez vous référer à la page EnableExceptionHook de Jeff Trawick pour plus d'informations à leur sujet.

    diff --git a/docs/manual/sections.xml.fr b/docs/manual/sections.xml.fr index 008f6183518..43ac3b14eb9 100644 --- a/docs/manual/sections.xml.fr +++ b/docs/manual/sections.xml.fr @@ -3,7 +3,7 @@ - +