Rebuild. (5ddb9485) · Commits · CYBER - Cyber Security / TS 103 523 MSP / TLMSP / TLMSP Apache Httpd

docs/manual/mod/mod_rewrite.html.fr

+96 −93

Original line number	Diff line number	Diff line
		@@ -140,8 +140,9 @@ r
		rpertoire (htaccess), sauf si au moins une de ces conditions est
		vrifie :</p>
		<ul>
		<li>La requte initiale, ainsi que la substitution, sont dans
		la <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est
		<li>La requte initiale, ainsi que la substitution, se
		situent par raport la valeur de la directive
		<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est
		dire que pour y accder, il n'est pas ncessaire d'utiliser
		une directive telle qu'<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>).</li>
		<li>Le chemin du systme de fichiers vers le rpertoire
		@@ -149,8 +150,9 @@ r
		la substitution relative est aussi valide en tant qu'URL sur
		le serveur (ce qui est rare).</li>
		<li>A partir de la version 2.4.16 du serveur HTTP Apache,
		cette directive peut tre omise lorsque la requte est
		transforme via une directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> ou le module
		cette directive peut tre omise lorsque la requte est mise en
		correspondance avec le systme de fichiers via la directive
		<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> ou le module
		<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</li>
		</ul>

		@@ -179,7 +181,7 @@ AliasMatch "^/myapp" "/opt/myapp-1.2.3"
		la rcriture soit effectue
		</td></tr>
		<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> RewriteCond
		<em>chane_de_test</em> <em>expression_de_comparaison</em></code></td></tr>
		<em>chane_de_test</em> <em>expression_de_comparaison</em> [<em>drapeaux</em>]</code></td></tr>
		<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .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>Extension</td></tr>
		@@ -393,13 +395,12 @@ la r
		en-tte ajout par le navigateur. Cette
		valeur n'a pas t dschappe (dcode), la
		diffrence de la plupart des variables suivantes.</dd>

		</dl>

		</li>
		</ul>

		<p>Si <em>chane_de_test</em> contient la valeur spciale
		<p>Si la <em>chane_de_test</em> contient la valeur spciale
		<code>expr</code>, <em>expression_de_comparaison</em> sera trait
		en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>. Si des en-ttes HTTP sont
		rfrencs dans l'expression rationnelle, et si le drapeau
		@@ -517,7 +518,8 @@ la r
		<ol>
		<li>Vous pouvez prfixer l'expression avec un caractre
		'<code>!</code>' (point d'exclamation) pour inverser le rsultat
		de la condition, quelle que soit l'<em>expression_de_comparaison</em> utilise.</li>
		de la condition, quelle que soit l'<em>expression de
		comparaison</em> utilise.</li>

		<li>Vous pouvez effectuer des comparaisons lexicographiques de
		chanes :
		@@ -551,7 +553,7 @@ la r
		<em>chane_de_test</em> est compare la
		chane vide.</dd>

		<dt><strong><=expression_de_comparaison</strong></dt>
		<dt><strong><=expression de comparaison</strong></dt>
		<dd>infrieur ou gal au sens lexicographique<br />
		Considre l'<em>expression_de_comparaison</em> comme une
		chane de caractres et la compare au sens lexicographique
		@@ -560,7 +562,7 @@ la r
		gale <em>expression_de_comparaison</em> (les deux chanes
		sont identiques, caractre pour caractre).</dd>

		<dt><strong>>=expression_de_comparaison</strong></dt>
		<dt><strong>>=expression de comparaison</strong></dt>
		<dd>suprieur ou gal au sens lexicographique<br />
		Considre l'<em>expression_de_comparaison</em> comme une
		chane de caractres et la compare au sens lexicographique
		@@ -568,7 +570,8 @@ la r
		suit lexicographiquement <em>expression_de_comparaison</em>, ou est
		gale <em>expression_de_comparaison</em> (les deux chanes
		sont identiques, caractre pour caractre).</dd>
		</dl></li>
		</dl>
		</li>

		<li>
		Vous pouvez effectuer des comparaisons d'entiers :
		@@ -577,28 +580,31 @@ la r
		<dt><strong>-eq</strong></dt>
		<dd>est numriquement gal <br />
		La <em>chane_de_test</em> est considre comme un entier,
		et est compare numriquement l'<em>expression_de_comparaison</em>. Vrai si les deux expressions sont
		et est compare numriquement l'<em>expression de
		comparaison</em>. Vrai si les deux expressions sont
		numriquement gales.</dd>

		<dt><strong>-ge</strong></dt>
		<dd>est numriquement suprieur ou gal <br />
		La <em>chane_de_test</em> est considre comme un entier,
		et est compare numriquement l'<em>expression_de_comparaison</em>. Vrai si <em>chane_de_test</em> est
		numriquement
		suprieure ou gale
		et est compare numriquement l'<em>expression de
		comparaison</em>. Vrai si <em>chane_de_test</em> est
		numriquement suprieure ou gale
		<em>expression_de_comparaison</em>.</dd>

		<dt><strong>-gt</strong></dt>
		<dd>est numriquement suprieur <br />
		La <em>chane_de_test</em> est considre comme un entier,
		et est compare numriquement l'<em>expression_de_comparaison</em>. Vrai si <em>chane_de_test</em> est
		et est compare numriquement l'<em>expression de
		comparaison</em>. Vrai si <em>chane_de_test</em> est
		numriquement
		suprieure <em>expression_de_comparaison</em>.</dd>

		<dt><strong>-le</strong></dt>
		<dd>est numriquement infrieur ou gal <br />
		La <em>chane_de_test</em> est considre comme un entier,
		et est compare numriquement l'<em>expression_de_comparaison</em>. Vrai si <em>chane_de_test</em> est
		et est compare numriquement l'<em>expression de
		comparaison</em>. Vrai si <em>chane_de_test</em> est
		numriquement
		infrieure ou gale <em>expression_de_comparaison</em>.
		Attention la confusion avec le drapeau <strong>-l</strong>
		@@ -608,7 +614,8 @@ la r
		<dt><strong>-lt</strong></dt>
		<dd>est numriquement infrieur <br />
		La <em>chane_de_test</em> est considre comme un entier,
		et est compare numriquement l'<em>expression_de_comparaison</em>. Vrai si <em>chane_de_test</em> est
		et est compare numriquement l'<em>expression de
		comparaison</em>. Vrai si <em>chane_de_test</em> est
		numriquement
		infrieure <em>expression_de_comparaison</em>.
		Attention la confusion avec le drapeau <strong>-l</strong>
		@@ -630,7 +637,7 @@ la r
		<dl>

		<dt><strong>-d</strong></dt>
		<dd>est un rpertoire (<strong>d</strong>irectory)<br />
		<dd>est un <strong>r</strong>pertoire<br />
		Traite <em>chane_de_test</em> comme un chemin et vrifie
		s'il existe ou pas, et s'il s'agit d'un rpertoire.</dd>

		@@ -653,7 +660,7 @@ la r
		Voir <strong>-l</strong>.</dd>

		<dt><strong>-l</strong></dt>
		<dd>est un lien symbolique<br />
		<dd>est un <strong>l</strong>ien symbolique<br />
		Considre la <em>chane_de_test</em> comme un chemin et
		vrifie son existence et si elle est un lien symbolique. On
		peut aussi utiliser la convention bash <strong>-L</strong>
		@@ -671,7 +678,8 @@ la r
		d'une taille suprieure zro.</dd>

		<dt><strong>-U</strong></dt>
		<dd><p>test de l'existence d'une URL via une sous-requte<br />
		<dd><p>test de l'existence d'une
		URL via une sous-requte<br />
		Vrifie si <em>chane_de_test</em> est une URL valide,
		accessible travers tous les contrles d'accs du serveur
		actuellement configurs pour ce chemin. C'est une
		@@ -704,7 +712,7 @@ RewriteRule ^(.+) /other/archive/$1 [R]</pre>

		<li>
		<p>Si la <em>chane_de_test</em> contient la valeur spciale
		<code>expr</code>, la <em>chane_de_comparaison</em> sera
		<code>expr</code>, la <em>chane de comparaison</em> sera
		traite en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>.</p>

		<p>
		@@ -718,13 +726,14 @@ RewriteRule ^(.+) /other/archive/$1 [R]</pre>
		RewriteRule "^/images" "-" [F]</pre>

		</li>
		</ol>

		<li>Vous pouvez aussi dfinir certains drapeaux pour
		<p>Vous pouvez aussi dfinir certains drapeaux pour
		l'<em>expression_de_comparaison</em> en ajoutant ces
		<strong><code>[</code><em>drapeaux</em><code>]</code></strong>
		comme troisime argument de la directive
		<code>RewriteCond</code>, o <em>drapeaux</em> est un
		sous-ensemble spar par des virgules des drapeaux suivants :
		sous-ensemble spar par des virgules des drapeaux suivants :</p>

		<ul>
		<li>'<strong><code>nocase\|NC</code></strong>'
		@@ -765,8 +774,7 @@ RewriteRule ...r
		fonctionnement de l'en-tte Vary.
		</li>
		</ul>
		</li>
		</ol>


		<p><strong>Exemple :</strong></p>

		@@ -781,11 +789,12 @@ RewriteRule "^/$" "/homepage.std.html" [L]</pre>


		<p>Explications : si vous utilisez un navigateur
		qui s'identifie comme un navigateur de mobile (notez que cet
		exemple est incomplet car il existe de nombreuses autres
		plateformes mobiles), c'est la version mobile de la page
		d'accueil qui sera servie. Dans le cas contraire, vous verrez
		s'afficher la page d'accueil standard.</p>
		qui s'identifie comme un
		navigateur de plateforme mobile (notez que l'exemple est
		incomplet car il existe de nombreuses autres plateformes
		mobiles), c'est la version pour mobile de la page d'accueil qui
		sera renvoye. Dans le cas contraire, ce sera la page d'accueil
		standard.</p>


		</div>
		@@ -845,8 +854,7 @@ recherche de mots-cl
		La source utilise pour cette recherche peut tre de plusieurs
		types.</p>

		<p><a id="mapfunc" name="mapfunc"><em>MapName</em></a>
		est le nom de la table de correspondance
		<p><a id="mapfunc" name="mapfunc"><em>MapName</em></a> est le nom de la table de correspondance
		et servira spcifier une fonction de mise en correspondance
		pour les chanes de substitution d'une rgle de rcriture selon
		une des constructions suivantes :</p>
		@@ -873,7 +881,7 @@ recherche de mots-cl
		<p>Par exemple, vous pouvez dfinir une directive
		<code class="directive">RewriteMap</code> comme suit </p>

		<pre class="prettyprint lang-config">RewriteMap "map-exemple" "txt:/chemin/vers/fichier/map.txt"</pre>
		<pre class="prettyprint lang-config">RewriteMap map-exemple "txt:/chemin/vers/fichier/map.txt"</pre>


		<p>Vous pourrez ensuite utiliser cette table dans une
		@@ -883,7 +891,7 @@ recherche de mots-cl


		<p>Les combinaisons suivantes pour <em>type de correspondance</em>
		et <em>source de la correspondance</em>
		et <em>MapSource</em>
		peuvent tre utilises :</p>

		<dl>
		@@ -967,8 +975,7 @@ pour le moteur de r
		les rgles spcifies dans le niveau parent s'appliquent
		<strong>avant</strong> les rgles spcifies dans le niveau
		enfant.<br />
		Disponible depuis la version 2.3.10 du serveur HTTP
		Apache.</p>
		Disponible depuis la version 2.3.10 du serveur HTTP Apache.</p>
		</dd>

		<dt><code>InheritDown</code></dt>
		@@ -1053,21 +1060,23 @@ pour le moteur de r
		de l'URI rcrite, comme indiqu dans les liens ci-dessus.</p>
		</div>
		</dd>

		<dt><code>MergeBase</code></dt>
		<dd>

		<p>Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est copie depuis le
		rpertoire o elle est explicitement dfinie dans tout
		sous-rpertoire qui ne dfinit pas sa propre directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. C'tait le
		comportement par dfaut de la version 2.4.0 la version 2.4.3, et
		cette option permet de le rtablir partir de la version 2.4.4 du
		serveur HTTP Apache.</p>
		<p>Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est recopie depuis
		une valeur explicitement dfinie dans tout sous-rpertoire qui ne
		dfinit pas sa propre directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. Il s'agissait du
		comportement par dfaut avec les versions 2.4.0 2.4.3, et ce
		drapeau qui permet de retrouver ce comportement est disponible
		depuis la version 2.4.4 du serveur HTTP Apache.</p>
		</dd>

		<dt><code>IgnoreContextInfo</code></dt>
		<dd>

		<p>Lors d'une substitution relative dans un contexte de rpertoire (htaccess),
		<p>Lors d'une
		substitution relative dans un contexte de rpertoire (htaccess),
		et si la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> n'a pas t dfinie,
		ce module utilise des informations en provenance d'une extension
		d'URL et du contexte du systme de fichiers pour transformer la
		@@ -1101,45 +1110,44 @@ pour le moteur de r

		<p><a id="patterns" name="patterns"><em>Modle</em></a> est une
		<a id="regexp" name="regexp">expression rationnelle</a>
		compatible perl. Dans la premire rgle de rcriture,
		l'expression est compare au (%-decoded)
		<a href="./directive-dict.html#Syntax">chemin de l'URL</a> de la
		requte, ou, dans un contexte de rpertoire (voir
		ci-dessous), au chemin de l'URL relativement ce contexte de
		rpertoire.
		Les expressions suivantes sont compares la sortie de
		la dernire rgle de rcriture qui
		correspondait.</p>
		compatible perl. Ce avec quoi ce modle est compar dpend de l'endroit o
		la directive <code class="directive">RewriteRule</code> est dfinie.</p>

		<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est compar ?</a></h3>

		<p>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, le <em>modle</em> est tout
		<ul>
		<li><p>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, le <em>modle</em> est tout
		d'abord compar la portion de l'URL situe entre le nom d'hte
		ventuellement accompagn du port, et la chane de paramtres (par
		exemple "/app1/index.html").</p>

		<p>Dans les contextes de rpertoire <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et htaccess, le
		<em>modle</em> est tout d'abord compar au chemin du <em>systme
		de fichiers</em>, aprs suppression du prfixe ou chemin de base
		ayant conduit le serveur vers la rgle <code class="directive">RewriteRule</code> (par
		exemple "app1/index.html" ou
		"index.html" selon l'endroit o les directives sont dfinies).</p>
		exemple "/app1/index.html"). Il s'agit du <a href="directive-dict.html#Syntax">URL-path</a> dcod de sa valeur "%xx".</p></li>

		<li><p>Dans un contexte de rpertoire (sections <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et fichiers .htaccess), le
		<em>Modle</em> est compar avec une partie de chemin ; par exemple une
		requte pour "/app1/index.html" entranera une comparaison avec
		"app1/index.html" ou "index.html" selon l'endroit o la directive
		<code class="directive">RewriteRule</code> est dfinie.</p>

		<p>Le chemin o la rgle est dfini est supprim du chemin correspondant
		du systme de fichiers avant comparaison (jusqu'au slash final compris).
		En consquence de cette suppression, les rgles dfinies dans
		ce contexte n'effectuent des comparaisons qu'avec la portion du chemin
		du systme de fichiers "en dessous" de l'endroit o la rgle est dfinie.</p>

		<p>Le chemin correspondant actuel du systme de fichiers est dtermin par
		des directives telles que <code class="directive">DocumentRoot</code> et
		<code class="directive">Alias</code>, ou mme le rsultat de substitutions dans
		des rgles <code class="directive">RewriteRule</code> prcdentes.
		</p>
		</li>

		<p>Si vous souhaitez faire une comparaison sur le nom
		<li><p>Si vous souhaitez faire une comparaison sur le nom
		d'hte, le port, ou la chane de requte, utilisez une
		directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
		comportant respectivement les variables
		<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
		<code>%{QUERY_STRING}</code>.</p>

		<p>Dans tous les cas, il faut garder l'esprit que les expressions
		rationnelles permettent de rechercher des correspondances de sous-chanes.
		En d'autres termes, l'expression rationnelle n'a pas besoin de correspondre
		l'ensemble de la chane, mais seulement la partie que vous souhaitez
		voir correspondre. Ainsi, l'utilisation de l'expression <code>.</code> est
		souvent suffisante et prfrable <code>.*</code>, et l'expression
		<code>abc</code> <strong>n'est pas</strong> identique l'expression
		<code>^abc$</code>.</p>
		<code>%{QUERY_STRING}</code>.</p></li>
		</ul>

		</div>

		<div class="note"><h3>Rcritures dans un contexte de rpertoire</h3>
		@@ -1157,13 +1165,7 @@ niveau du r
		moteur de rcriture. Cette restriction a t instaure des fins de
		scurit.</li>

		<li>Lorsqu'on utilise le moteur de rcriture dans un fichier
		<code>.htaccess</code>, le chemin de base du rpertoire courant (autrement dit
		le chemin URI qui reprsente le rpertoire contenant ce fichier
		<code>.htaccess</code>) est automatiquement <em>supprim</em> au cours de la
		comparaison avec le modle de la rgle de rcriture, et automatiquement
		<em>ajout</em> lorsqu'une substitution relative (ne dbutant pas par un slash
		ou un nom de protocole) arrive la fin d'un jeu de rgles. Voir la directive
		<li>Voir la directive
		<code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de dtails
		propos de l'ajout du prfixe aprs les substitutions relatives.</li>

		@@ -1268,7 +1270,7 @@ substitution !

		</dl>

		<p>En plus du texte, la chane <em>Substition</em> peut
		<p>En plus du texte, la chane <em>Substitution</em> peut
		comporter :</p>

		<ol>
		@@ -1290,7 +1292,7 @@ substitution !
		<code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
		seront remplacs par le contenu du <strong>N</strong>me groupe
		du <em>Modle</em> qui correspondait. Les variables du serveur
		sont les mmes que dans la <em>Chane de test</em> d'une
		sont les mmes que dans la <em>Chane_de_test</em> d'une
		directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>. Les
		fonctions de comparaison sont issues de la directive <code class="directive"><a href="#rewritemap">RewriteMap</a></code> dans la
		section de laquelle elles sont dcrites. Ces trois types de
		@@ -1338,8 +1340,9 @@ substitution !
		</tr>
		<tr>
		<td>B</td>
		<td>Echappe les caractres non-alphanumriques dans les
		rfrences arrires <em>avant</em> d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">dtails ...</a></em></td>
		<td>Echappe les caractres non-alphanumriques
		dans les rfrences arrires <em>avant</em>
		d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">dtails ...</a></em></td>
		</tr>
		<tr class="odd">
		<td>backrefnoplus\|BNP</td>

docs/manual/mod/quickreference.html.fr

+1 −1

Original line number	Diff line number	Diff line
		@@ -1063,7 +1063,7 @@ pas.</td></tr>
		<tr><td><a href="mod_rewrite.html#rewritebase">RewriteBase <em>chemin_URL</em></a></td><td></td><td>dh</td><td>E</td></tr><tr><td class="descr" colspan="4">Dfinit l'URL de base pour les rcritures au niveau
		rpertoire</td></tr>
		<tr class="odd"><td><a href="mod_rewrite.html#rewritecond"> RewriteCond
		<em>chane_de_test</em> <em>expression_de_comparaison</em></a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dfinit une condition qui devra tre satisfaite pour que
		<em>chane_de_test</em> <em>expression_de_comparaison</em> [<em>drapeaux</em>]</a></td><td></td><td>svdh</td><td>E</td></tr><tr class="odd"><td class="descr" colspan="4">Dfinit une condition qui devra tre satisfaite pour que
		la rcriture soit effectue
		</td></tr>
		<tr><td><a href="mod_rewrite.html#rewriteengine">RewriteEngine on\|off</a></td><td> off </td><td>svdh</td><td>E</td></tr><tr><td class="descr" colspan="4">Active ou dsactive l'excution du