You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2017/08/21 13:43:47 UTC
svn commit: r1805630 [4/30] - in /httpd/httpd/trunk/docs/manual: ./ mod/
Modified: httpd/httpd/trunk/docs/manual/mod/mod_alias.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_alias.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_alias.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_alias.html.fr Mon Aug 21 13:43:45 2017
@@ -132,61 +132,54 @@ Alias "/foo" "/gaq"</pre>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="alias" id="alias">Directive</a> <a name="Alias" id="Alias">Alias</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec des chemins du système
-de fichiers</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias [<var>chemin URL</var>]
-<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr>
-<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps URLs to filesystem locations</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias [<var>URL-path</var>]
+<var>file-path</var>|<var>directory-path</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>La directive <code class="directive">Alias</code> permet de stocker des
- documents (destinés à être servis) dans des zones du système de
- fichiers situées en dehors de l'arborescence du site web <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Les URLs dont le chemin
- (décodé avec caractères %) commence par <var>chemin URL</var> seront
- mises en correspondance avec des fichiers locaux dont le chemin
- commence par <var>chemin répertoire</var>. Le <var>chemin URL</var>
- est sensible à la casse, même sur les systèmes de fichiers
- insensibles à la casse.</p>
+ <p>The <code class="directive">Alias</code> directive allows documents to
+ be stored in the local filesystem other than under the
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. URLs with a
+ (%-decoded) path beginning with <var>URL-path</var> will be mapped
+ to local files beginning with <var>directory-path</var>. The
+ <var>URL-path</var> is case-sensitive, even on case-insensitive
+ file systems.</p>
<pre class="prettyprint lang-config">Alias "/image" "/ftp/pub/image"</pre>
- <p>Une requête pour <code>http://example.com/image/foo.gif</code> fera
- renvoyer par le serveur le fichier
- <code>/ftp/pub/image/foo.gif</code>. Seuls les éléments de chemin
- complets sont testés ; ainsi l'alias précédent ne conviendra pas
- pour une requête du style <code>http://example.com/imagefoo.gif</code>.
- Pour des mises en correspondance plus complexes faisant intervenir
- les expressions rationnelles, veuillez vous reporter à la directive
- <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>.</p>
-
- <p>Notez que si vous ajoutez un slash de fin au <var>chemin
- URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la
- requête. Autrement dit, si vous définissez</p>
+ <p>A request for <code>http://example.com/image/foo.gif</code> would cause
+ the server to return the file <code>/ftp/pub/image/foo.gif</code>. Only
+ complete path segments are matched, so the above alias would not match a
+ request for <code>http://example.com/imagefoo.gif</code>. For more complex
+ matching using regular expressions, see the <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> directive.</p>
+
+ <p>Note that if you include a trailing / on the
+ <var>URL-path</var> then the server will require a trailing / in
+ order to expand the alias. That is, if you use</p>
<pre class="prettyprint lang-config">Alias "/icons/" "/usr/local/apache/icons/"</pre>
- <p>l'alias précédent ne s'appliquera pas à l'URL
- <code>/icons</code> à cause de l'absence du slash final. Ainsi, si
- le slash final est absent du <var>chemin de l'URL</var>, il doit
- aussi l'être du <var>chemin du fichier</var>.</p>
-
- <p>Notez qu'il pourra s'avérer nécessaire de définir des sections
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
- supplémentaires qui couvriront la <em>destination</em> des alias.
- Le traitement des alias intervenant avant le traitement des sections
- <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>,
- seules les cibles des alias sont affectées (Notez cependant
- que les sections <code class="directive"><a href="../mod/core.html#location"><Location></a></code> sont traitées avant les alias, et
- s'appliqueront donc).</p>
-
- <p>En particulier, si vous créez un alias ayant pour cible un
- répertoire situé en dehors de l'arborescence de votre site web
- <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, vous devrez
- probablement permettre explicitement l'accès à ce répertoire.</p>
+ <p>then the URL <code>/icons</code> will not be aliased, as it lacks
+ that trailing /. Likewise, if you omit the slash on the
+ <var>URL-path</var> then you must also omit it from the
+ <var>file-path</var>.</p>
+
+ <p>Note that you may need to specify additional <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections which
+ cover the <em>destination</em> of aliases. Aliasing occurs before
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections
+ are checked, so only the destination of aliases are affected.
+ (Note however <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
+ sections are run through once before aliases are performed, so
+ they will apply.)</p>
+
+ <p>In particular, if you are creating an <code>Alias</code> to a
+ directory outside of your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, you may need to explicitly
+ permit access to the target directory.</p>
<pre class="prettyprint lang-config">Alias "/image" "/ftp/pub/image"
<Directory "/ftp/pub/image">
@@ -194,14 +187,15 @@ de fichiers</td></tr>
</Directory></pre>
- <p>Le nombre de slashes dans le paramètre <var>chemin URL</var> doit
- correspondre au nombre de slashes dans le chemin URL de la requête.</p>
+ <p>Any number slashes in the <var>URL-path</var> parameter
+ matches any number of slashes in the requested URL-path.</p>
- <p>Si la directive <code class="directive">Alias</code> est définie au sein
- d'une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>, <var>chemin URL</var> est
- omis et <var>chemin fichier</var> est interprété en utilisant la <a href="../expr.html">syntaxe des expressions</a>.<br />
- Cette syntaxe est disponible à partir de la version 2.4.19 du
- serveur HTTP Apache.</p>
+ <p>If the <code class="directive">Alias</code> directive is used within a
+ <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
+ or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>
+ section the URL-path is omitted, and the file-path is interpreted
+ using <a href="../expr.html">expression syntax</a>.<br />
+ This syntax is available in Apache 2.4.19 and later.</p>
<pre class="prettyprint lang-config"><Location "/image">
Alias "/ftp/pub/image"
@@ -216,79 +210,83 @@ de fichiers</td></tr>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="aliasmatch" id="aliasmatch">Directive</a> <a name="AliasMatch" id="AliasMatch">AliasMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec le système de fichiers
-en faisant intervenir les expressions rationnelles</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps URLs to filesystem locations using regular
+expressions</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AliasMatch <var>regex</var>
-<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr>
+<var>file-path</var>|<var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>Cette directive est identique à la directive <code class="directive"><a href="#alias">Alias</a></code>, mais fait appel aux <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la place d'une
- simple mise en correspondance de préfixe. L'expression rationnelle
- fournie est mise en correspondance avec le chemin URL, et si elle
- correspond, le serveur va substituer toute partie de chemin
- correspondant à l'expression entre parenthèses dans la chaîne
- fournie et l'utiliser comme nom de fichier.
- Par exemple, pour activer le répertoire <code>/icons</code>, on peut
- utiliser :</p>
-
- <pre class="prettyprint lang-config">AliasMatch "^/icons(.*)" "/usr/local/apache/icons$1$2"</pre>
-
-
- <p>Toute la puissance des <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions
- rationnelles</a> peut être mise à contribution. Par exemple,
- il est possible de construire un alias avec un modèle de chemin URL
- insensible à la casse :</p>
+ <p>This directive is equivalent to <code class="directive"><a href="#alias">Alias</a></code>, but makes use of
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>,
+ instead of simple prefix matching. The
+ supplied regular expression is matched against the URL-path, and
+ if it matches, the server will substitute any parenthesized
+ matches into the given string and use it as a filename. For
+ example, to activate the <code>/icons</code> directory, one might
+ use:</p>
+
+ <pre class="prettyprint lang-config">AliasMatch "^/icons(/|$)(.*)" "/usr/local/apache/icons$1$2"</pre>
+
+
+ <p>The full range of <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expression</a>
+ power is available. For example,
+ it is possible to construct an alias with case-insensitive
+ matching of the URL-path:</p>
<pre class="prettyprint lang-config">AliasMatch "(?i)^/image(.*)" "/ftp/pub/image$1"</pre>
- <p>Il existe une différence subtile entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> : <code class="directive"><a href="#alias">Alias</a></code> copie automatiquement toute
- portion supplémentaire de l'URI située après la partie du modèle qui
- correspond, à la fin du chemin du fichier de la partie droite, alors
- que <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne le fait
- pas. Cela signifie qu'il sera préférable dans la plupart des cas de
- comparer l'expression rationnelle du modèle à la totalité de l'URI
- de la requête, et d'utiliser les substitutions dans la partie
- droite.</p>
-
- <p>En d'autres termes, le remplacement d'<code class="directive"><a href="#alias">Alias</a></code> par <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne produira pas le même
- résultat. Au minimum, vous devez ajouter <code>^</code> au début de
- l'expression rationnelle, <code>(.*)$</code> à sa fin et
- <code>$1</code> à la fin de la chaîne de remplacement.</p>
+ <p>One subtle difference
+ between <code class="directive"><a href="#alias">Alias</a></code>
+ and <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> is
+ that <code class="directive"><a href="#alias">Alias</a></code> will
+ automatically copy any additional part of the URI, past the part
+ that matched, onto the end of the file path on the right side,
+ while <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> will
+ not. This means that in almost all cases, you will want the
+ regular expression to match the entire request URI from beginning
+ to end, and to use substitution on the right side.</p>
+
+ <p>In other words, just changing
+ <code class="directive"><a href="#alias">Alias</a></code> to
+ <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> will not
+ have the same effect. At a minimum, you need to
+ add <code>^</code> to the beginning of the regular expression
+ and add <code>(.*)$</code> to the end, and add <code>$1</code> to
+ the end of the replacement.</p>
- <p>Par exemple, supposons que nous voulions reformuler cet alias
- avec AliasMatch :</p>
+ <p>For example, suppose you want to replace this with AliasMatch:</p>
<pre class="prettyprint lang-config">Alias "/image/" "/ftp/pub/image/"</pre>
- <p>Le simple remplacement d'Alias par AliasMatch ne produira pas le
- même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes
- qui contiennent /image/ vers /ftp/pub/image/ :</p>
+ <p>This is NOT equivalent - don't do this! This will send all
+ requests that have /image/ anywhere in them to /ftp/pub/image/:</p>
<pre class="prettyprint lang-config">AliasMatch "/image/" "/ftp/pub/image/"</pre>
- <p>Voici la directive AliasMatch qui produira le même résultat que
- la directive Alias ci-dessus :</p>
+ <p>This is what you need to get the same effect:</p>
<pre class="prettyprint lang-config">AliasMatch "^/image/(.*)$" "/ftp/pub/image/$1"</pre>
- <p>Bien entendu, il n'y a aucune raison d'utiliser <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> dans le cas où <code class="directive"><a href="#alias">Alias</a></code> suffit. <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> vous permet d'effectuer
- des choses beaucoup plus sophistiquées. Par exemple, vous pouvez
- servir différentes sortes de fichiers à partir de répertoires
- différents :</p>
-
- <pre class="prettyprint lang-config"> AliasMatch "^/image/(.*)\.jpg$" "/fichiers/jpg.images/$1.jpg"
- AliasMatch "^/image/(.*)\.gif$" "/fichiers/gif.images/$1.gif"</pre>
+ <p>Of course, there's no point in
+ using <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
+ where <code class="directive"><a href="#alias">Alias</a></code> would
+ work. <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> lets
+ you do more complicated things. For example, you could
+ serve different kinds of files from different directories:</p>
+
+ <pre class="prettyprint lang-config">AliasMatch "^/image/(.*)\.jpg$" "/files/jpg.images/$1.jpg"
+AliasMatch "^/image/(.*)\.gif$" "/files/gif.images/$1.gif"</pre>
- <p>Les éventuels slashes de tête multiples seront supprimés par le
- serveur avant que les directives de ce module n'effectuent des
- comparaisons avec le chemin URL de la requête.
+ <p>Multiple leading slashes in the requested URL are discarded
+ by the server before directives from this module compares
+ against the requested URL-path.
</p>
@@ -296,117 +294,110 @@ en faisant intervenir les expressions ra
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="redirect" id="redirect">Directive</a> <a name="Redirect" id="Redirect">Redirect</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe demandant au client
-d'effectuer une autre requête avec une URL différente</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var>état</var>] [<var>URL-path</var>]
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect asking the client to fetch
+a different URL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var>status</var>] [<var>URL-path</var>]
<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>La directive <code class="directive">Redirect</code> permet de faire correspondre
- une ancienne URL à une nouvelle en demandant au client d'aller chercher la
- ressource à une autre localisation.</p>
-
- <p>L'ancien <em>URL-path</em> est un chemin sensible à la casse
- (décodé à l'aide de caractères %) commençant par un slash. Les
- chemins relatifs ne sont pas autorisés.</p>
-
- <p>La nouvelle <em>URL</em>
- peut être une URL absolue commençant par un protocole et un nom
- d'hôte, mais on peut aussi utiliser un chemin URL commençant par un
- slash, auquel cas le protocole et le nom d'hôte du serveur local
- seront ajoutés, si vous avez défini <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> à on. Si <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> n'a pas été défini à on, le nom
- d'hôte sera remplacé par la valeur de l'en-tête requested Host.</p>
-
- <p>Ensuite, toute requête commençant par <em>URL-path</em> va
- renvoyer une redirection au client vers l'<em>URL</em> cible. Tout
- élément de chemin supplémentaire situé en aval du <em>URL-path</em> sera
- ajouté à l'URL cible.</p>
+ <p>The <code class="directive">Redirect</code> directive maps an old URL into a new one by asking
+ the client to refetch the resource at the new location.</p>
+
+ <p>The old <em>URL-path</em> is a case-sensitive (%-decoded) path
+ beginning with a slash. A relative path is not allowed.</p>
+
+ <p>The new <em>URL</em> may be either an absolute URL beginning
+ with a scheme and hostname, or a URL-path beginning with a slash.
+ In this latter case the scheme and hostname of the current server
+ will be added if you have
+ <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> set to on,
+ otherwise the hostname will be replaced with the requested Host
+ header.</p>
+
+ <p>Then any request beginning with <em>URL-path</em> will return a
+ redirect request to the client at the location of the target
+ <em>URL</em>. Additional path information beyond the matched
+ <em>URL-path</em> will be appended to the target URL.</p>
- <pre class="prettyprint lang-config"># Redirige vers une URL sur un serveur différent
+ <pre class="prettyprint lang-config"># Redirect to a URL on a different host
Redirect "/service" "http://foo2.example.com/service"
-# Redirige vers une URL sur le même serveur
+# Redirect to a URL on the same host
Redirect "/one" "/two"</pre>
- <p>Si le client effectue une requête pour l'URL
- <code>http://example.com/service/foo.txt</code>, il lui sera demandé
- d'en effectuer une autre pour l'URL
- <code>http://foo2.example.com/service/foo.txt</code>. Ceci concerne
- les requêtes avec paramètres <code>GET</code>, comme
- <code>http://example.com/service/foo.pl?q=23&a=42</code>, qui
- seront redirigées vers
+ <p>If the client requests <code>http://example.com/service/foo.txt</code>,
+ it will be told to access
+ <code>http://foo2.example.com/service/foo.txt</code>
+ instead. This includes requests with <code>GET</code> parameters, such as
+ <code>http://example.com/service/foo.pl?q=23&a=42</code>,
+ it will be redirected to
<code>http://foo2.example.com/service/foo.pl?q=23&a=42</code>.
- Notez que les <code>POST</code>s seront ignorés.<br />
- Seuls les
- éléments de chemin complets sont testés, si bien que l'exemple
- précédent ne s'appliquera pas à l'URL
- <code>http://example.com/servicefoo.txt</code>. Pour des mises en
- correspondance plus complexes utilisant la <a href="../expr.html">syntaxe des expressions</a>, ne spécifiez pas
- d'argument <var>URL-path</var> comme décrit ci-dessous. En outre,
- pour une mise en correspondance en utilisant les expressions
- rationnelles, veuillez vous reporter à la directive <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.</p>
+ Note that <code>POST</code>s will be discarded.<br />
+ Only complete path segments are matched, so the above
+ example would not match a request for
+ <code>http://example.com/servicefoo.txt</code>. For more complex matching
+ using the <a href="../expr.html">expression syntax</a>, omit the URL-path
+ argument as described below. Alternatively, for matching using regular
+ expressions, see the <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code> directive.</p>
<div class="note"><h3>Note</h3>
- <p>Les directives <code class="directive">Redirect</code> ont priorité sur les
- directives <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, quel que soit leur ordre
- d'apparition dans le fichier de configuration. Les directives
- <code class="directive">Redirect</code> définies au sein d'une section Location
- l'emportent sur les directives <code class="directive">Redirect</code> et <code class="directive"><a href="#alias">Alias</a></code> comportant un argument
- <var>URL-path</var>.</p></div>
-
- <p>Si aucun argument <var>état</var> n'est spécifié, la
- redirection sera temporaire (code HTTP 302). Le client est alors
- informé que la ressource a été temporairement déplacée. On peut
- utiliser l'argument <var>état</var> pour renvoyer d'autres codes HTTP :</p>
+ <p><code class="directive">Redirect</code> directives take precedence over <code class="directive"><a href="#alias">Alias</a></code> and <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>
+ directives, irrespective of their ordering in the configuration
+ file. <code class="directive">Redirect</code> directives inside a Location take
+ precedence over <code class="directive">Redirect</code> and <code class="directive"><a href="#alias">Alias</a></code> directives with an <var>URL-path</var>.</p>
+ </div>
+
+ <p>If no <var>status</var> argument is given, the redirect will
+ be "temporary" (HTTP status 302). This indicates to the client
+ that the resource has moved temporarily. The <var>status</var>
+ argument can be used to return other HTTP status codes:</p>
<dl>
<dt>permanent</dt>
- <dd>Renvoie un code de redirection permanente (301), indiquant
- que la ressource a été définitivement déplacée.</dd>
+ <dd>Returns a permanent redirect status (301) indicating that
+ the resource has moved permanently.</dd>
<dt>temp</dt>
- <dd>Renvoie un code de redirection temporaire (302). C'est le
- comportement par défaut.</dd>
+ <dd>Returns a temporary redirect status (302). This is the
+ default.</dd>
<dt>seeother</dt>
- <dd>Renvoie un code "See Other" (303) indiquant que la ressource
- a été remplacée par une autre.</dd>
+ <dd>Returns a "See Other" status (303) indicating that the
+ resource has been replaced.</dd>
<dt>gone</dt>
- <dd>Renvoie un code "Gone" (410) indiquant que la ressource a
- été définitivement supprimée. Lorsque
- ce code est utilisé, on ne
- doit pas utiliser l'argument <var>URL</var>.</dd>
+ <dd>Returns a "Gone" status (410) indicating that the
+ resource has been permanently removed. When this status is
+ used the <var>URL</var> argument should be omitted.</dd>
</dl>
- <p>On peut renvoyer d'autres codes en spécifiant le code
- numérique comme valeur de l'argument of <var>état</var>.
- Si le code est compris entre 300 et 399, l'argument
- <var>URL</var> doit être présent. Si le code
- n'est <em>pas</em> compris entre 300 et 399, l'argument
- <var>URL</var> ne doit pas apparaître. Le code doit être un code
- HTTP valide, connu du serveur HTTP Apache (voir la
- fonction <code>send_error_response</code> dans
- http_protocol.c).</p>
+ <p>Other status codes can be returned by giving the numeric
+ status code as the value of <var>status</var>. If the status is
+ between 300 and 399, the <var>URL</var> argument must be present.
+ If the status is <em>not</em> between 300 and 399, the
+ <var>URL</var> argument must be omitted. The status must be a valid
+ HTTP status code, known to the Apache HTTP Server (see the function
+ <code>send_error_response</code> in http_protocol.c).</p>
<pre class="prettyprint lang-config">Redirect permanent "/one" "http://example.com/two"
Redirect 303 "/three" "http://example.com/other"</pre>
- <p>Si une directive <code class="directive">Redirect</code> est définie au
- sein d'une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> et si l'argument <var>URL-path</var> est omis, l'argument <var>URL</var> sera interprété en
- utilisant la <a href="../expr.html">syntaxe des expressions</a>.<br />
- Cette syntaxe est disponible à partir de la version 2.4.19 du
- serveur HTTP Apache.</p>
+ <p>If the <code class="directive">Redirect</code> directive is used within a
+ <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
+ or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>
+ section with the <var>URL-path</var> omitted, then the <var>URL</var> parameter
+ will be interpreted using <a href="../expr.html">expression syntax</a>.<br />
+ This syntax is available in Apache 2.4.19 and later.</p>
<pre class="prettyprint lang-config"><Location "/one">
Redirect permanent "http://example.com/two"
@@ -424,98 +415,95 @@ Redirect 303 "/three" "http://example.co
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="redirectmatch" id="redirectmatch">Directive</a> <a name="RedirectMatch" id="RedirectMatch">RedirectMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe faisant appel aux
-expressions rationnelles pour la mise en correspondance de l'URL
-courante</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var>état</var>] <var>regex</var>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external redirect based on a regular expression match
+of the current URL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var>status</var>] <var>regex</var>
<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>Cette directive est identique à la directive <code class="directive"><a href="#redirect">Redirect</a></code>, mais fait appel aux
- <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la
- place d'une simple mise en correspondance de préfixe. L'expression
- rationnelle fournie est mise en correspondance avec le chemin URL,
- et si elle correspond, le serveur va substituer toute partie de
- chemin correspondante entre parenthèses dans la chaîne spécifiée et
- l'utiliser comme nom de fichier. Par exemple, pour rediriger tous
- les fichiers GIF vers les fichiers JPEG de même nom sur un autre
- serveur, on peut utiliser :</p>
-
- <pre class="prettyprint lang-config">RedirectMatch "(.*)\.gif$" "http://autre.example.com$1.jpg"</pre>
-
-
- <p>Les remarques à propos de la différence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi à la
- différence entre les directives <code class="directive"><a href="#redirect">Redirect</a></code> et <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>. Voir la directive
- <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de
- détails.</p>
+ <p>This directive is equivalent to <code class="directive"><a href="#redirect">Redirect</a></code>, but makes use of
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>,
+ instead of simple prefix matching. The
+ supplied regular expression is matched against the URL-path, and
+ if it matches, the server will substitute any parenthesized
+ matches into the given string and use it as a filename. For
+ example, to redirect all GIF files to like-named JPEG files on
+ another server, one might use:</p>
+
+ <pre class="prettyprint lang-config">RedirectMatch "(.*)\.gif$" "http://other.example.com$1.jpg"</pre>
+
+
+ <p>The considerations related to the difference between
+ <code class="directive"><a href="#alias">Alias</a></code> and
+ <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
+ also apply to the difference between
+ <code class="directive"><a href="#redirect">Redirect</a></code> and
+ <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.
+ See <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> for
+ details.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="redirectpermanent" id="redirectpermanent">Directive</a> <a name="RedirectPermanent" id="RedirectPermanent">RedirectPermanent</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe permanente demandant au
-client d'effectuer une nouvelle requête avec une URL
-différente</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>chemin URL</var> <var>URL</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external permanent redirect asking the client to fetch
+a different URL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>URL-path</var> <var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>Cette directive informe le client que la redirection est
- permanente (code 301). Son comportement est exactement le même
- que celui de <code>Redirect permanent</code>.</p>
+ <p>This directive makes the client know that the Redirect is
+ permanent (status 301). Exactly equivalent to <code>Redirect
+ permanent</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="redirecttemp" id="redirecttemp">Directive</a> <a name="RedirectTemp" id="RedirectTemp">RedirectTemp</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe temporaire demandant au
-client d'effectuer une nouvelle requête avec une URL
-différente</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>chemin URL</var> <var>URL</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sends an external temporary redirect asking the client to fetch
+a different URL</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>URL-path</var> <var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>Cette directive informe le client que la redirection n'est
- que temporaire (code 302). Son comportement est exactement le même
- que celui de <code>Redirect temp</code>.</p>
+ <p>This directive makes the client know that the Redirect is
+ only temporary (status 302). Exactly equivalent to
+ <code>Redirect temp</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="scriptalias" id="scriptalias">Directive</a> <a name="ScriptAlias" id="ScriptAlias">ScriptAlias</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL à une zone du système de fichiers
-et désigne la cible comme script CGI</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias [<var>chemin URL</var>]
-<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps a URL to a filesystem location and designates the
+target as a CGI script</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias [<var>URL-path</var>]
+<var>file-path</var>|<var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>La directive <code class="directive">ScriptAlias</code> présente le même
- comportement que la directive <code class="directive"><a href="#alias">Alias</a></code>, mais désigne en plus le
- répertoire cible comme conteneur de scripts CGI qui seront traitées
- par le gestionnaire cgi-script du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>.
- Les URLs dont le chemin URL sensible à la casse (décodé avec
- caractères %) commence par <var>chemin URL</var> seront mises en
- correspondance avec les scripts dont le chemin commence par le
- second argument, qui est un chemin complet dans le système de
- fichiers local.</p>
+ <p>The <code class="directive">ScriptAlias</code> directive has the same
+ behavior as the <code class="directive"><a href="#alias">Alias</a></code>
+ directive, except that in addition it marks the target directory
+ as containing CGI scripts that will be processed by <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>'s cgi-script handler. URLs with a case-sensitive
+ (%-decoded) path beginning with <var>URL-path</var> will be mapped
+ to scripts beginning with the second argument, which is a full
+ pathname in the local filesystem.</p>
<pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-bin/"</pre>
- <p>Une requête pour <code>http://example.com/cgi-bin/foo</code>
- ferait exécuter par le serveur le script
- <code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement
- équivalente à :</p>
+ <p>A request for <code>http://example.com/cgi-bin/foo</code> would cause the
+ server to run the script <code>/web/cgi-bin/foo</code>. This configuration
+ is essentially equivalent to:</p>
<pre class="prettyprint lang-config">Alias "/cgi-bin/" "/web/cgi-bin/"
<Location "/cgi-bin">
SetHandler cgi-script
@@ -523,44 +511,43 @@ et désigne la cible comme script CGI</t
</Location></pre>
- <p>Vous pouvez aussi utiliser <code class="directive">ScriptAlias</code>
- avec un script ou gestionnaire de votre cru. Par exemple :</p>
+ <p><code class="directive">ScriptAlias</code> can also be used in conjunction with
+ a script or handler you have. For example:</p>
- <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"</pre>
+ <pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"</pre>
- <p>Dans ce scénario, tous les fichiers faisant l'objet d'une requête
- dans <code>/cgi-bin/</code> seront traités par le fichier que vous
- avez spécifié, ce qui vous permet d'utiliser votre propre
- gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour
- les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p>
-
- <div class="warning">Il est préférable d'éviter de placer les
- scripts CGI dans l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> afin d'éviter de révéler
- accidentellement leur code source lors d'une modification de
- configuration. On y parvient aisément avec
- <code class="directive">ScriptAlias</code> en mettant en correspondance une
- URL et en désignant la cible comme scripts CGI par la même occasion.
- Si vous choisissez de placer vos scripts CGI dans un répertoire
- accessible depuis le web, n'utilisez pas
- <code class="directive">ScriptAlias</code>. Utilisez plutôt <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, et <code class="directive"><a href="../mod/core.html#options">Options</a></code> comme dans l'exemple suivant :
+ <p>In this scenario all files requested in <code>/cgi-bin/</code> will be
+ handled by the file you have configured, this allows you to use your own custom
+ handler. You may want to use this as a wrapper for CGI so that you can add
+ content, or some other bespoke action.</p>
+
+ <div class="warning">It is safer to avoid placing CGI scripts under the
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> in order to
+ avoid accidentally revealing their source code if the
+ configuration is ever changed. The
+ <code class="directive">ScriptAlias</code> makes this easy by mapping a
+ URL and designating CGI scripts at the same time. If you do
+ choose to place your CGI scripts in a directory already
+ accessible from the web, do not use
+ <code class="directive">ScriptAlias</code>. Instead, use <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, and <code class="directive"><a href="../mod/core.html#options">Options</a></code> as in:
<pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/cgi-bin">
SetHandler cgi-script
Options ExecCGI
</Directory></pre>
- Ceci est nécessaire car plusieurs <var>chemins URL</var> peuvent
- correspondre à la même zone du système de fichiers, court-circuitant
- ainsi la directive <code class="directive">ScriptAlias</code> et révélant le
- code source des scripts CGI s'ils ne sont pas protégés par une
- section <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>.</div>
-
- <p>Si la directive <code class="directive">ScriptAlias</code> est définie au
- sein d'une section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code> et si l'argument <var>chemin
- URL</var> est omis, l'argument <var>URL</var> sera interprété en
- utilisant la <a href="../expr.html">syntaxe des expressions</a>.<br />
- Cette syntaxe est disponible à partir de la version 2.4.19 du
- serveur HTTP Apache.</p>
+ This is necessary since multiple <var>URL-paths</var> can map
+ to the same filesystem location, potentially bypassing the
+ <code class="directive">ScriptAlias</code> and revealing the source code
+ of the CGI scripts if they are not restricted by a
+ <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> section.</div>
+
+ <p>If the <code class="directive">ScriptAlias</code> directive is used within
+ a <code class="directive"><a href="../mod/core.html#location"><Location></a></code>
+ or <code class="directive"><a href="../mod/core.html#locationmatch"><LocationMatch></a></code>
+ section with the URL-path omitted, then the URL parameter will be
+ interpreted using <a href="../expr.html">expression syntax</a>.<br />
+ This syntax is available in Apache 2.4.19 and later.</p>
<pre class="prettyprint lang-config"><Location "/cgi-bin">
ScriptAlias "/web/cgi-bin/"
@@ -573,44 +560,48 @@ et désigne la cible comme script CGI</t
<h3>Voir aussi</h3>
<ul>
-<li><a href="../howto/cgi.html">Tutoriel CGI</a></li>
+<li><a href="../howto/cgi.html">CGI Tutorial</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="scriptaliasmatch" id="scriptaliasmatch">Directive</a> <a name="ScriptAliasMatch" id="ScriptAliasMatch">ScriptAliasMatch</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL à une zone du système de fichiers
-en faisant appel aux expressions rationnelles et en désignant la cible
-comme un script CGI</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maps a URL to a filesystem location using a regular expression
+and designates the target as a CGI script</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAliasMatch <var>regex</var>
-<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr>
+<var>file-path</var>|<var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
- <p>Cette directive est équivalente à la directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, mais fait appel aux
- <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la
- place d'une simple mise en correspondance de préfixe. L'expression
- rationnelle fournie est mise en correspondance avec le chemin URL,
- et si elle correspond, le serveur va substituer toute partie de
- chemin entre parenthèses dans la chaîne spécifiée et l'utiliser
- comme nom de fichier. Par exemple, pour activer le répertoire
- standard <code>/cgi-bin</code>, on peut utiliser :</p>
+ <p>This directive is equivalent to <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, but makes use of
+ <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">regular expressions</a>,
+ instead of simple prefix matching. The
+ supplied regular expression is matched against the URL-path,
+ and if it matches, the server will substitute any parenthesized
+ matches into the given string and use it as a filename. For
+ example, to activate the standard <code>/cgi-bin</code>, one
+ might use:</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"</pre>
- <p>Comme dans le cas d'AliasMatch, toute la puissance des <a class="glossarylink" href="../glossary.html#rexex" title="voir glossaire">expressions rationnelles</a> peut être mise à
- contribution. Par exemple, il est possible de construire un alias
- avec une comparaison du modèle du chemin URL insensible à la casse :</p>
+ <p>As for AliasMatch, the full range of <a class="glossarylink" href="../glossary.html#rexex" title="voir glossaire">regular
+ expression</a> power is available.
+ For example, it is possible to construct an alias with case-insensitive
+ matching of the URL-path:</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "(?i)^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"</pre>
- <p>Les remarques à propos de la différence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi à la
- différence entre les directives <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> et <code class="directive"><a href="#scriptaliasmatch">ScriptAliasMatch</a></code>. Voir la directive
- <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de
- détails.</p>
+ <p>The considerations related to the difference between
+ <code class="directive"><a href="#alias">Alias</a></code> and
+ <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>
+ also apply to the difference between
+ <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> and
+ <code class="directive"><a href="#scriptaliasmatch">ScriptAliasMatch</a></code>.
+ See <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> for
+ details.</p>
</div>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_allowmethods.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_allowmethods.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_allowmethods.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_allowmethods.html.fr Mon Aug 21 13:43:45 2017
@@ -57,7 +57,7 @@ est du style :</p>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="allowmethods" id="allowmethods">Directive</a> <a name="AllowMethods" id="AllowMethods">AllowMethods</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restreint l'accès aux méthodes HTTP spécifiées</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict access to the listed HTTP methods</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowMethods reset|<em>HTTP-method</em>
[<em>HTTP-method</em>]...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowMethods reset</code></td></tr>
@@ -66,25 +66,24 @@ est du style :</p>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_allowmethods</td></tr>
</table>
-<p>Le nom de chaque méthode HTTP est sensible à la casse, et est le plus
-souvent défini en majuscules, comme dans les RFCs. Les méthodes GET et
-HEAD sont traitées de la même manière. Le mot-clé
-<code>reset</code> permet de désactiver
-<code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> dans les niveaux inférieurs
-d'imbrication :</p>
+<p>The HTTP-methods are case sensitive and are generally, as per
+RFC, given in upper case. The GET and HEAD methods are treated as
+equivalent. The <code>reset</code> keyword can be used to
+turn off <code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> in a deeper nested context:</p>
<pre class="prettyprint lang-config"><Location "/svn">
AllowMethods reset
</Location></pre>
-<div class="note"><h3>Avertissement</h3>
- <p>La méthode TRACE ne peut pas être rejetée par ce module ; pour ce
- faire, vous devez utiliser la directive <code class="directive"><a href="../mod/core.html#traceenable">TraceEnable</a></code>.</p>
+<div class="note"><h3>Caution</h3>
+ <p>The TRACE method cannot be denied by this module;
+ use <code class="directive"><a href="../mod/core.html#traceenable">TraceEnable</a></code> instead.</p>
</div>
-<p>Le module <code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> a été écrit pour
-remplacer l'implémentation "bricolée" des directives <code class="directive"><a href="../mod/core.html#limit">Limit</a></code> et <code class="directive"><a href="../mod/core.html#limitexcept">LimitExcept</a></code>.</p>
+<p><code class="module"><a href="../mod/mod_allowmethods.html">mod_allowmethods</a></code> was written to replace the rather
+kludgy implementation of <code class="directive"><a href="../mod/core.html#limit">Limit</a></code> and
+<code class="directive"><a href="../mod/core.html#limitexcept">LimitExcept</a></code>.</p>
</div>
</div>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_auth_basic.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_auth_basic.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_auth_basic.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_auth_basic.html.fr Mon Aug 21 13:43:45 2017
@@ -66,9 +66,8 @@ l'authentification</a></li>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authbasicauthoritative" id="authbasicauthoritative">Directive</a> <a name="AuthBasicAuthoritative" id="AuthBasicAuthoritative">AuthBasicAuthoritative</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si les processus d'autorisation et
-d'authentification peuvent être confiés à des modules de plus bas
-niveau</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether authorization and authentication are passed to
+lower level modules</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicAuthoritative On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicAuthoritative On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
@@ -76,82 +75,74 @@ niveau</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
</table>
- <p>Normalement, chaque module d'autorisation énuméré dans la
- directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> va tenter de
- vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des
- fournisseurs, l'accès sera refusé. Définir explicitement la
- directive <code class="directive">AuthBasicAuthoritative</code> à
- <code>Off</code> permet de confier l'autorisation et
- l'authentification à d'autres modules non basés sur les fournisseurs
- si <strong>aucun identifiant utilisateur</strong> ou aucune
- <strong>règle</strong> ne correspondent à l'identifiant utilisateur
- spécifié. Ceci ne peut s'avérer nécessaire que lorsque
- <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> est combiné avec des modules tiers
- qui n'ont pas été configurés à l'aide de la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>. Lorsqu'on
- utilise de tels modules, l'ordre dans lequel s'effectue le
- traitement est défini dans le code source des modules et n'est pas
- configurable.</p>
+ <p>Normally, each authorization module listed in <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> will attempt
+ to verify the user, and if the user is not found in any provider,
+ access will be denied. Setting the
+ <code class="directive">AuthBasicAuthoritative</code> directive explicitly
+ to <code>Off</code> allows for both authentication and
+ authorization to be passed on to other non-provider-based modules
+ if there is <strong>no userID</strong> or <strong>rule</strong>
+ matching the supplied userID. This should only be necessary when
+ combining <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> with third-party modules
+ that are not configured with the <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>
+ directive. When using such modules, the order of processing
+ is determined in the modules' source code and is not configurable.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authbasicfake" id="authbasicfake">Directive</a> <a name="AuthBasicFake" id="AuthBasicFake">AuthBasicFake</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Authentification de base simulée à l'aide des nom
-d'utilisateur et mot de passe fournis</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicFake off|nom-utilisateur [mot-de-passe]</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fake basic authentication using the given expressions for
+username and password</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicFake off|username [password]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
-Apache</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.4.5 and later</td></tr>
</table>
- <p>Les nom d'utilisateur et mot de passe spécifiés sont rassemblés
- dans un en-tête d'autorisation qui est transmis au serveur ou au
- service sous-jacent au serveur. Ces nom d'utilisateur et mot de
- passe sont interprétés par l'<a href="../expr.html">interpréteur
- d'expression</a>, ce qui permet de les définir en fonction de
- paramètres de la requête.</p>
-
- <p>Si aucun mot de passe n'est spécifié, la valeur par défaut
- "password" sera utilisée. Pour désactiver l'authentification de base
- simulée pour un espace d'URL, définissez AuthBasicFake à "off".</p>
+ <p>The username and password specified are combined into an
+ Authorization header, which is passed to the server or service
+ behind the webserver. Both the username and password fields are
+ interpreted using the <a href="../expr.html">expression parser</a>,
+ which allows both the username and password to be set based on
+ request parameters.</p>
+
+ <p>If the password is not specified, the default value "password"
+ will be used. To disable fake basic authentication for an URL
+ space, specify "AuthBasicFake off".</p>
- <p>Dans l'exemple suivant, un nom d'utilisateur et un mot de passe
- prédéfinis sont transmis à un serveur d'arrière-plan :</p>
+ <p>In this example, we pass a fixed username and password to a
+ backend server.</p>
- <div class="example"><h3>Exemple de transmission d'un nom d'utilisateur et
- d'un mot de passe prédéfinis</h3><pre class="prettyprint lang-config"><Location "/demo">
+ <div class="example"><h3>Fixed Example</h3><pre class="prettyprint lang-config"><Location "/demo">
AuthBasicFake demo demopass
</Location></pre>
</div>
- <p>Dans l'exemple suivant, l'adresse email extraite d'un certificat
- client est transmise au serveur, étendant par là-même la
- fonctionnalité de l'option FakeBasicAuth de la directive <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. Comme avec l'option
- FakeBasicAuth, le mot de passe se voit attribué le contenu fixe de
- la chaîne "password".</p>
+ <p>In this example, we pass the email address extracted from a client
+ certificate, extending the functionality of the FakeBasicAuth option
+ within the <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code>
+ directive. Like the FakeBasicAuth option, the password is set to the
+ fixed string "password".</p>
- <div class="example"><h3>Exemple d'utilisation avec un certificat</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <div class="example"><h3>Certificate Example</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}"
</Location></pre>
</div>
- <p>Pour compléter l'exemple précédent, il est possible de générer la
- valeur du mot de passe en procédant à un hashage de l'adresse email
- à partir d'un mot d'une passphrase initial fixée, puis de transmettre le
- résultat obtenu au serveur d'arrière-plan. Ceci peut s'avérer utile
- pour donner accès à des serveurs anciens qui ne supportent pas les
- certificats clients.</p>
+ <p>Extending the above example, we generate a password by hashing the
+ email address with a fixed passphrase, and passing the hash to the
+ backend server. This can be used to gate into legacy systems that do
+ not support client certificates.</p>
- <div class="example"><h3>Exemple de génération de mot de passe par hashage de
- l'adresse email</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <div class="example"><h3>Password Example</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}" "%{sha1:passphrase-%{SSL_CLIENT_S_DN_Email}}"
</Location></pre>
</div>
- <div class="example"><h3>Désactivation de l'authentification simulée</h3><pre class="prettyprint lang-config"><Location "/public">
+ <div class="example"><h3>Exclusion Example</h3><pre class="prettyprint lang-config"><Location "/public">
AuthBasicFake off
</Location></pre>
</div>
@@ -161,25 +152,21 @@ Apache</td></tr>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authbasicprovider" id="authbasicprovider">Directive</a> <a name="AuthBasicProvider" id="AuthBasicProvider">AuthBasicProvider</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(les) fournisseur(s) d'authentification pour
-cette zone du site web</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicProvider <var>nom fournisseur</var>
-[<var>nom fournisseur</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the authentication provider(s) for this location</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicProvider <var>provider-name</var>
+[<var>provider-name</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicProvider file</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
</table>
- <p>La directive <code class="directive">AuthBasicProvider</code> permet de
- définir le fournisseur utilisé pour authentifier les utilisateurs
- pour la zone du site web concernée. Le fournisseur par défaut
- <code>file</code> est implémenté par le module
- <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le module
- implémentant le fournisseur choisi soit bien présent dans le
- serveur.</p>
-
- <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location "/secure">
+ <p>The <code class="directive">AuthBasicProvider</code> directive sets
+ which provider is used to authenticate the users for this location.
+ The default <code>file</code> provider is implemented
+ by the <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> module. Make sure
+ that the chosen provider module is present in the server.</p>
+ <div class="example"><h3>Example</h3><pre class="prettyprint lang-config"><Location "/secure">
AuthType basic
AuthName "private area"
AuthBasicProvider dbm
@@ -188,23 +175,21 @@ cette zone du site web</td></tr>
Require valid-user
</Location></pre>
</div>
- <p>Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un
- d'entre eux trouve une correspondance pour le nom d'utilisateur de
- la requête ; alors, ce dernier fournisseur sera le seul à vérifier
- le mot de passe. Un échec dans la vérification du mot de passe
- n'entraîne pas le passage du contrôle au fournisseur suivant.</p>
+ <p> Providers are queried in order until a provider finds a match
+ for the requested username, at which point this sole provider will
+ attempt to check the password. A failure to verify the password does
+ not result in control being passed on to subsequent providers.</p>
- <p>Les différents fournisseurs disponibles sont implémentés par les
- modules <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
+ <p>Providers are implemented by <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>,
- <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> et <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>.</p>
+ <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> and <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authbasicusedigestalgorithm" id="authbasicusedigestalgorithm">Directive</a> <a name="AuthBasicUseDigestAlgorithm" id="AuthBasicUseDigestAlgorithm">AuthBasicUseDigestAlgorithm</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie les mots de passe auprès des fournisseurs
-d'authentification à la manière de l'authentification de type Digest.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Check passwords against the authentication providers as if
+Digest Authentication was in force instead of Basic Authentication.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicUseDigestAlgorithm MD5|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicUseDigestAlgorithm Off</code></td></tr>
@@ -212,74 +197,64 @@ d'authentification à la manière de l'a
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.7 du serveur HTTP
-Apache</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Apache HTTP Server 2.4.7 and later</td></tr>
</table>
- <p>Normalement, lorsqu'on utilise l'authentification basique, les
- fournisseurs spécifiés via la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> tentent de
- contrôler l'identité d'un utilisateur en recherchant dans leurs
- bases de données l'existence d'un couple utilisateur/mot de passe
- correspondant. Les mots de passe enregistrés sont en général
- chiffrés, mais ce n'est pas systématique ; chaque fournisseur peut
- choisir son propre mode de stockage des mots de passe.</p>
-
- <p>Lorsqu'on utilise l'authentification de type Digest, les
- fournisseurs spécifiés par la directive <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> effectuent
- une recherche similaire dans leurs bases de
- données pour trouver un couple utilisateur/mot de passe
- correspondant. Cependant, à la différence de l'authentification
- basique, les données associées à chaque utilisateur et comportant le
- nom d'utilisateur, le domaine de protection (realm) et le mot de
- passe doivent être contenues dans une chaîne chiffrée (Voir le
- document <a href="http://tools.ietf.org/html/rfc2617#section-3.2.2.2">RFC 2617,
- Section 3.2.2.2</a> pour plus de détails à propos du type de
- chiffrement utilisé pour cette chaîne).</p>
-
- <p>A cause de la différence entre les méthodes de stockage des
- données des authentifications de type basique et digest, le passage
- d'une méthode d'authentification de type digest à une méthode
- d'authentification de type basique requiert l'attribution de
- nouveaux
- mots de passe à chaque utilisateur, car leur mots de passe existant
- ne peut pas être extrait à partir du schéma de stockage utilisé
- par les fournisseurs d'authentification de type digest.</p>
-
- <p>Si la directive <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code> est
- définie à la valeur <code>MD5</code>, le mot de passe d'un
- utilisateur dans le cas de l'authentification basique sera vérifié
- en utilisant le même format de chiffrement que dans le cas de
- l'authentification de type digest. Tout d'abord, une chaîne
- comportant le nom d'utilisateur, le domaine de protection (realm) et
- le mot de passe est générée sous forme de condensé (hash) en
- utilisant l'algorithme MD5 ; puis le nom d'utilisateur et cette
- chaîne chiffrée sont transmis aux fournisseurs spécifiés via la
- directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> comme si la
- directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>
- était définie à <code>Digest</code> et si l'authentification de type
- Digest était utilisée.
+ <p>Normally, when using Basic Authentication, the providers listed in
+ <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>
+ attempt to verify a user by checking their data stores for
+ a matching username and associated password. The stored passwords
+ are usually encrypted, but not necessarily so; each provider may
+ choose its own storage scheme for passwords.</p>
+
+ <p>When using <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> and Digest
+ Authentication, providers perform a similar check to find a matching
+ username in their data stores. However, unlike in the Basic
+ Authentication case, the value associated with each stored username
+ must be an encrypted string composed from the username, realm name,
+ and password. (See
+ <a href="http://tools.ietf.org/html/rfc2617#section-3.2.2.2">
+ RFC 2617, Section 3.2.2.2</a> for more details on the format used
+ for this encrypted string.)</p>
+
+ <p>As a consequence of the difference in the stored values between
+ Basic and Digest Authentication, converting from Digest
+ Authentication to Basic Authentication generally requires that all
+ users be assigned new passwords, as their existing passwords cannot
+ be recovered from the password storage scheme imposed on those
+ providers which support Digest Authentication.</p>
+
+ <p>Setting the <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code> directive
+ to <code>MD5</code> will cause the user's Basic Authentication password
+ to be checked using the same encrypted format as for Digest
+ Authentication. First a string composed from the username, realm name,
+ and password is hashed with MD5; then the username and this encrypted
+ string are passed to the providers listed in
+ <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>
+ as if
+ <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>
+ was set to <code>Digest</code> and Digest Authentication was in force.
</p>
- <p>Grâce à cette directive, un site peut basculer d'une
- authentification de type digest à basique sans devoir changer les
- mots de passe des utilisateurs. </p>
+ <p>Through the use of <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
+ a site may switch from Digest to Basic Authentication without
+ requiring users to be assigned new passwords.</p>
<div class="note">
- Le processus inverse consistant à passer d'une authentification de
- type basique à digest sans changer les mots de passe n'est en
- général pas possible. Les mots de passe enregistrés dans le cas
- d'une authentification de type basique ne pourront être extraits
- et chiffrés à nouveau selon le schéma de l'authentification de
- type digest, que s'ils ont été stockés en clair ou selon un schéma de
- chiffrement réversible.
+ The inverse process of switching from Basic to Digest
+ Authentication without assigning new passwords is generally
+ not possible. Only if the Basic Authentication passwords
+ have been stored in plain text or with a reversable encryption
+ scheme will it be possible to recover them and generate a
+ new data store following the Digest Authentication password
+ storage scheme.
</div>
<div class="note">
- Seuls les fournisseurs qui supportent l'authentification de type
- digest pourront authentifier les utilisateurs lorsque la directive
- <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
- est définie à <code>MD5</code>. L'utilisation d'un autre
- fournisseur provoquera un message d'erreur et le client se verra
- refuser l'accès.</div>
+ Only providers which support Digest Authentication will be able
+ to authenticate users when <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
+ is set to <code>MD5</code>. Use of other providers will result
+ in an error response and the client will be denied access.
+ </div>
</div>
</div>