From: Lucien Gentis Date: Tue, 7 Jan 2020 16:55:45 +0000 (+0000) Subject: fr doc XML updates. X-Git-Tag: 2.5.0-alpha2-ci-test-only~1717 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e7da535798054df36d5492e45853549b3abfa7ca;p=thirdparty%2Fapache%2Fhttpd.git fr doc XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1872450 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/expr.xml.fr b/docs/manual/expr.xml.fr index fc9544e10c3..8a1a3920358 100644 --- a/docs/manual/expr.xml.fr +++ b/docs/manual/expr.xml.fr @@ -1,7 +1,7 @@ - + @@ -688,6 +688,61 @@ DIGIT ::= <any US-ASCII digit "0".."9"> module="mod_ssl">SSLRequire).

+ +
+ Autres + + + + + + + + + + + + + + + + + +
NomAlternative Description
-ininchaîne contenue dans une liste
/regexp/m#regexp#Expression rationnelle (la seconde forme permet de spécifier + des délimiteurs autres que /)
/regexp/im#regexp#iExpression rationnelle insensible à la casse
$0 ... $9Références arrières dans les expressions rationnelles
+ +
+ Références arrières dans les expressions rationnelles +

Les chaînes $0 ... $9 permettent de + référencer les groupes de capture en provenance d'expressions + rationnelles précédemment exécutées et mises en correspondance avec + succès. Elles ne peuvent normalement être utilisées que dans la + même expression que celle mise en correspondance, mais certains + modules permettent de les utiliser de manière spéciale.

+
+ +
+ +
+ Comparaison avec SSLRequire +

La syntaxe ap_expr consiste principalement en une + surcouche de la syntaxe de la directive obsolète SSLRequire. Vous pouvez consulter la + liste de leur différences dans la documentation de la directive + SSLRequire.

+
+ +
+ Historique de version +

La fonction req_novary est + disponible à partir de la version 2.4.4 du serveur HTTP Apache.

+

Les variables + SERVER_PROTOCOL_VERSION, + SERVER_PROTOCOL_VERSION_MAJOR et + SERVER_PROTOCOL_VERSION_MINOR sont disponibles à partir + de la version 2.5.0 du serveur HTTP Apache.

+
+
Exemples d'expressions @@ -770,58 +825,4 @@ CustomLog logs/access-errors-specific.log common "expr=%{REQUEST_STATUS} -in {'4
-
- Autres - - - - - - - - - - - - - - - - - -
NomAlternative Description
-ininchaîne contenue dans une liste
/regexp/m#regexp#Expression rationnelle (la seconde forme permet de spécifier - des délimiteurs autres que /)
/regexp/im#regexp#iExpression rationnelle insensible à la casse
$0 ... $9Références arrières dans les expressions rationnelles
- -
- Références arrières dans les expressions rationnelles -

Les chaînes $0 ... $9 permettent de - référencer les groupes de capture en provenance d'expressions - rationnelles précédemment exécutées et mises en correspondance avec - succès. Elles ne peuvent normalement être utilisées que dans la - même expression que celle mise en correspondance, mais certains - modules permettent de les utiliser de manière spéciale.

-
- -
- -
- Comparaison avec SSLRequire -

La syntaxe ap_expr consiste principalement en une - surcouche de la syntaxe de la directive obsolète SSLRequire. Vous pouvez consulter la - liste de leur différences dans la documentation de la directive - SSLRequire.

-
- -
- Historique de version -

La fonction req_novary est - disponible à partir de la version 2.4.4 du serveur HTTP Apache.

-

Les variables - SERVER_PROTOCOL_VERSION, - SERVER_PROTOCOL_VERSION_MAJOR et - SERVER_PROTOCOL_VERSION_MINOR sont disponibles à partir - de la version 2.5.0 du serveur HTTP Apache.

-
- diff --git a/docs/manual/mod/mod_dir.xml.fr b/docs/manual/mod/mod_dir.xml.fr index d60031e6f91..350641ca279 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,49 +86,49 @@ 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".

- -

Note :La définition de plusieurs directives - DirectoryIndex au sein d'un même - contexte permet d'ajouter des ressources à rechercher plutôt - que de remplacer celle déjà définies : + "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 :La définition de plusieurs directives + DirectoryIndex au sein d'un même + contexte permet d'ajouter des ressources à rechercher plutôt + que de remplacer celle déjà définies :

-# Exemple A: définit index.html comme page d'index, ainsi qu'index.php. +# Exemple A: définit index.html comme page d'index, ainsi qu'index.php. <Directory "/foo"> DirectoryIndex index.html DirectoryIndex index.php </Directory> -# Exemple B: identique à l'exemple A, mais avec une seule directive. +# Exemple B: identique à l'exemple A, mais avec une seule directive. <Directory "/foo"> DirectoryIndex index.html index.php </Directory> # Exemple C: pour remplacer la liste des pages d'index par une autre, -# vous devez tout d'abord supprimer la première liste : dans l'exemple +# vous devez tout d'abord supprimer la première liste : dans l'exemple # suivant, il ne restera qu'index.php comme page d'index. <Directory "/foo"> DirectoryIndex index.html @@ -142,8 +142,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 @@ -155,20 +155,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.
@@ -179,7 +179,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.

@@ -189,7 +189,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 @@ -200,104 +200,104 @@ 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 -Désactivé - httpd renvoie un code d'erreur 404 (Not Found) +Désactivé - httpd renvoie un code d'erreur 404 (Not Found) server configvirtual host directory.htaccess Indexes L'argument disabled est disponible depuis 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.

-

Utilisez l'argument disabled pour désactiver cette - fonctionnalité si 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 :

+ seront traités normalement.

+

Utilisez l'argument disabled pour désactiver cette + fonctionnalité si 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 :

<Directory "/web/example.com/htdocs/blog"> FallbackResource /blog/index.php @@ -306,35 +306,39 @@ version 2.4.4 du serveur HTTP Apache FallbackResource disabled </Directory> +

Un gestionnaire de ressource par défaut (dans l'exemple ci-dessus + /blog/index.php) peut accéder à l'URL de la requête originale + via la variable de serveur REQUEST_URI. Pour accéder à cette + variable en PHP, par exemple, utilisez $_SERVER['REQUEST_URI'].

 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 à l'exécution 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 à l'exécution via des directives telles que SetHandler ou par 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 à +

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.

 diff --git a/docs/manual/rewrite/avoid.xml.fr b/docs/manual/rewrite/avoid.xml.fr index 98dceb58532..b146a2a8b0b 100644 --- a/docs/manual/rewrite/avoid.xml.fr +++ b/docs/manual/rewrite/avoid.xml.fr @@ -1,7 +1,7 @@ - + diff --git a/docs/manual/sections.xml.fr b/docs/manual/sections.xml.fr index 66b6e4f4285..cb3c571d03d 100644 --- a/docs/manual/sections.xml.fr +++ b/docs/manual/sections.xml.fr @@ -3,7 +3,7 @@ - +