]> granicus.if.org Git - apache/commitdiff
XML updates.
authorLucien Gentis <lgentis@apache.org>
Sun, 7 Dec 2014 15:56:04 +0000 (15:56 +0000)
committerLucien Gentis <lgentis@apache.org>
Sun, 7 Dec 2014 15:56:04 +0000 (15:56 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1643688 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/expr.xml.fr
docs/manual/mod/mod_authnz_ldap.xml.fr
docs/manual/mod/mod_authz_core.xml.fr
docs/manual/mod/mod_headers.xml.fr
docs/manual/mod/mod_rewrite.xml.fr
docs/manual/rewrite/advanced.xml.fr
docs/manual/rewrite/remapping.xml.fr

index e44cfcce77ecb997bac14aa32aa9032642a0170d..fa421d00e085943be77dd33c7c2cbdbb343115e7 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
-<!-- English Revision: 1641890:1643268 (outdated) -->
+<!-- English Revision : 1643268 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -588,7 +588,7 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
 &lt;/Directory&gt;
 
 # V&eacute;rifie si un en-t&ecirc;te HTTP correspond &agrave; une des valeurs d'une liste
-&lt;If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz'}"&gt;
+&lt;If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz' }"&gt;
     La d&eacute;finition de l'en-t&ecirc;te correspond &agrave; une des valeurs recherch&eacute;es
 &lt;/If&gt;
 
@@ -606,6 +606,18 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
       SetOutputFilter INFLATE
 &lt;/If&gt;
 &lt;/Directory&gt;
+
+# Exemples de fonctions dans un contexte bool&eacute;en
+&lt;If "md5('foo') == 'acbd18db4cc2f85cedef654fccc4a4d8'"&gt;
+  Header set checksum-matched true
+&lt;/If&gt;
+&lt;If "md5('foo') == replace('md5:XXXd18db4cc2f85cedef654fccc4a4d8', 'md5:XXX', 'acb')&gt;
+  Header set checksum-matched-2 true
+&lt;/If&gt;
+
+# Function example in string context
+Header set foo-checksum "expr=%{md5:foo}"
+
        </highlight>
 </section>
 
index 009a153d20a3ca71cef409bed6f068d3982a2cb5..8688d4fc4c3f29ce9ac6a51a4098e2cf15ddf015 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1605618:1643418 (outdated) -->
+<!-- English Revision : 1643318 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -457,12 +457,12 @@ uniqueMember: cn=Elliot Rhodes, o=Example
 </pre></example>
 
     <p>Les directives suivantes autoriseraient alors l'acc&egrave;s &agrave; Bob
-    Ellis, Tom Jackson, Barbara Jensen, Fred User, Allan Jefferson, et
+    Ellis, Tom Jackson, Barbara Jonsen, Fred User, Allan Jefferson, et
     Paul Tilley, mais l'interdiraient &agrave; Jim Swenson, ou Elliot Rhodes
     (car ils sont situ&eacute;s dans un sous-groupe de niveau de profondeur 2)
     :</p>
 <highlight language="config">
-Require ldap-group cn=Employees, o-Example
+Require ldap-group cn=Employees, o=Example
 AuthLDAPMaxSubGroupDepth 1
 </highlight>
 
index d242719321336aa0989d5c966174844186860a8f..0887dd725293e94ee84d8880b491af585abb0719 100644 (file)
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1600400:1642592 (outdated) -->
+<!-- English Revision : 1642592 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -235,12 +235,23 @@ SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in
   <section id="reqexpr"><title>Require expr</title>
 
   <p>Le fournisseur <code>expr</code> permet d'accorder l'autorisation
-  d'acc&egrave;s en fonction d'expressions arbitraires.</p>
+  d'acc&egrave;s de base en fonction d'expressions arbitraires.</p>
 
     <highlight language="config">
          Require expr "%{TIME_HOUR} -ge 9 &amp;&amp; %{TIME_HOUR} -le 17"
     </highlight>
 
+    <highlight language="config">
+&lt;RequireAll&gt;
+    Require expr "!(%{QUERY_STRING} =~ /secret/)"
+    Require expr "%{REQUEST_URI} in { '/example.cgi', '/other.cgi' }" 
+&lt;/RequireAll&gt;
+    </highlight>
+
+    <highlight language="config">
+        Require expr "!(%{QUERY_STRING} =~ /secret/) &amp;&amp; %{REQUEST_URI} in { '/example.cgi', '/other.cgi' }" 
+    </highlight>
+
     <p>La syntaxe de l'expression est d&eacute;crite dans la documentation de <a
     href="../expr.html">ap_expr</a>.</p>
 
index eb9fac5f106ad6147f54e6e7ff7ca33c1f6f79b3..e9572d9da05ff0a87d492ed3d33637dac81a27e9 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1600543:1643445 (outdated) -->
+<!-- English Revision: 1643445 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -562,6 +562,28 @@ version 2.4.10</compatibility>
       efficace que <code>%s</code>.</p>
     </note>
 
+    <note><title>Note &agrave; propos des valeurs des expressions</title>
+    <p>Lorsque le param&egrave;tre valeur utilise l'interpr&eacute;teur <a
+    href="../expr.html">ap_expr</a>, certaines syntaxes d'expressions
+    seront diff&eacute;rentes des exemples qui &eacute;valuent des expressions
+    <em>bool&eacute;ennes</em> telles que &lt;If&gt; :</p>
+    <ul>
+      <li>Le point de d&eacute;part de la syntaxe est 'string' au lieu de
+      'expr'.</li>
+      <li>Les appels de fonction utilisent la syntaxe %{funcname:arg} au
+      lieu de funcname(arg).</li>
+      <li>Les fonctions multi-arguments ne sont pas encore disponibles
+      depuis le point de d&eacute;part 'string'.</li>
+      <li>Il faut mettre entre guillemets l'ensemble du param&egrave;tre, comme
+      dans l'exemple suivant : 
+          <highlight language="config">
+        Header set foo-checksum "expr=%{md5:foo}"
+          </highlight>
+       </li>
+                   
+    </ul>
+    </note>
+
     <p><code>edit</code>n&eacute;cessite les deux arguments
     <var>valeur</var>, qui est une <glossary ref="regex">expression
     rationnelle</glossary>, et une cha&icirc;ne additionnelle
index 62d1917d6c75949c58d351fc9a35b6f8190bff50..076dbe5b45b758e5f656b96b94dc8b54d796d7b4 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1601533:1643036 (outdated) -->
+<!-- English Revision : 1643036 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -1155,8 +1155,11 @@ signifie que la comparaison s'effectue avec une cha&icirc;ne qui ne comporte
 <li>Bien que les r&egrave;gles de r&eacute;&eacute;criture soient permises du point de vue de
 la syntaxe dans les sections <directive type="section"
 module="core">Location</directive> et <directive type="section"
-module="core">Files</directive>, elles n'y sont pas prises en compte, et
-n'y sont &agrave; priori d'aucune utilit&eacute;.</li>
+module="core">Files</directive> (y compris leurs versions sous forme
+d'expression rationnelle), elles n'y sont pas prises en compte, et
+n'y sont &agrave; priori d'aucune utilit&eacute;. Les substitutions
+relatives sont une fonctionnalit&eacute; qui n'est, elle non-plus pas support&eacute;e
+dans ce genre de contexte.</li>
 </ul>
 </note>
 
index 73d5ef15a7374be4f22e404bfd037c93a5d39371..170a2ce84861f58d7fa79ea6300fd76fd5cf6f12 100644 (file)
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1638070:1642856 (outdated) -->
+<!-- English Revision : 1642856 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
index 2beb81829a6dc55bf9227aa8f4fb034d60e1dbcb..47d12946b5e7b84dc0fd97ff1e9d03f9ab4ee5c0 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1" ?>
 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1363237 -->
+<!-- English Revision : 1643532 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -647,4 +647,67 @@ fichier <code>.htaccess</code> que dans une section
 
 </section>
 
+<section id="rewrite-query">
+<title>Rewrite query string</title>
+
+<dl>
+<dt>Description :</dt>
+<dd>Vous voulez extraire une valeur particuli&egrave;re d'une cha&icirc;ne de
+param&egrave;tres d'une URL, et soit la remplacer, soit l'incorporer dans un
+autre composant de l'URL.</dd>
+
+<dt>Solutions :</dt>
+<dd>
+<p>Dans la plupart des solutions de cette section, on utilise la m&ecirc;me
+condition qui stocke la valeur recherch&eacute;e dans la r&eacute;f&eacute;rence arri&egrave;re %2.
+%1 est le d&eacute;but de la requ&ecirc;te, et %3 ce qui reste. Cette condition est
+un peu complexe car elle introduit de la flexibilit&eacute; et &eacute;vite les
+doubles perluettes '&amp;&amp;' dans les substitutions.</p>
+<ul>
+  <li>Cette solution supprime le couple cl&eacute;/valeur recherch&eacute; :
+
+<highlight language="config">
+# Remove mykey=???
+RewriteCond %{QUERY_STRING} (.*(?:^|&amp;))mykey=([^&amp;]*)&amp;?(.*)&amp;?$
+RewriteRule (.*) $1?%1%3
+</highlight>
+  </li>
+
+  <li>Cette solution remplace la partie de l'URL qui suit la valeur
+  recherch&eacute;e par un '?' :
+
+<highlight language="config">
+# Copy from query string to PATH_INFO
+RewriteCond %{QUERY_STRING} (.*(?:^|&amp;))mykey=([^&amp;]*)&amp;?(.*)&amp;?$
+RewriteRule (.*) $1/products/%2/? [PT]
+</highlight>
+  </li>
+
+  <li>Cette solution utilise la valeur recherch&eacute;e dans une deuxi&egrave;me
+  condition ::
+
+<highlight language="config">
+# Capture the value of mykey in the query string
+RewriteCond %{QUERY_STRING} (.*(?:^|&amp;))mykey=([^&amp;]*)&amp;?(.*)&amp;?$
+RewriteCond %2 !=not-so-secret-value 
+RewriteRule (.*) - [F]
+</highlight>
+  </li>
+
+  <li>Cette solution produit l'effet inverse des pr&eacute;c&eacute;dentes ; elle
+  copie des composantes du chemin (peut-&ecirc;tre PATH_INFO) depuis l'URL
+  vers sa cha&icirc;ne de param&egrave;tres :
+<highlight language="config">
+# The desired URL might be /products/kitchen-sink, and the script expects 
+# /path?products=kitchen-sink.
+RewriteRule ^/?path/([^/]+)/([^/]+) /path?$1=$2 [PT]
+</highlight>
+  </li>
+</ul>
+
+</dd>
+
+</dl>
+</section>
+
 </manualpage>