granicus.if.org Git - apache/blob - docs/manual/mod/mod_sed.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1673947 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_sed.xml.meta">
  26
  27 <name>mod_sed</name>
  28 <description>Filtre les contenus en entr&eacute;e (requ&ecirc;tes) et en sortie
  29 (r&eacute;ponses) en utilisant la syntaxe de <code>sed</code></description>
  30 <status>Exp&eacute;rimental</status>
  31 <sourcefile>mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h</sourcefile>
  32 <identifier>sed_module</identifier>
  33 <compatibility>Disponible depuis la version 2.3 d'Apache</compatibility>
  34
  35 <summary>
  36 <p><module>mod_sed</module> est un filtre de contenu "in-process". Le
  37 filtre <module>mod_sed</module> fournit les commandes d'&eacute;dition de
  38 <code>sed</code> impl&eacute;ment&eacute;es par le programme <code>sed</code> de
  39 Solaris 10 comme d&eacute;crit dans la <a
  40 href="http://www.gnu.org/software/sed/manual/sed.txt">page de
  41 manuel</a>. Cependant, &agrave; la diff&eacute;rence de <code>sed</code>,
  42 <module>mod_sed</module> ne re&ccedil;oit pas de donn&eacute;es sur son entr&eacute;e
  43 standard. Au lieu de cela, le filtre agit sur les donn&eacute;es &eacute;chang&eacute;es
  44 entre le client et le serveur. <module>mod_sed</module> peut &ecirc;tre
  45 utilis&eacute; comme filtre en entr&eacute;e ou en sortie. <module>mod_sed</module>
  46 est un filtre de contenu, ce qui signifie qu'on ne peut pas l'utiliser
  47 pour modifier les en-t&ecirc;tes http du client ou du serveur.
  48 </p>
  49 <p>
  50 Le filtre en sortie <module>mod_sed</module> accepte un tron&ccedil;on de
  51 donn&eacute;es, ex&eacute;cute le script <code>sed</code> sur ces donn&eacute;es, puis g&eacute;n&egrave;re
  52 une sortie qui est transmise au filtre suivant dans la cha&icirc;ne.
  53 </p>
  54
  55 <p>
  56 Le filtre en entr&eacute;e <module>mod_sed</module> re&ccedil;oit des donn&eacute;es en
  57 provenance du filtre suivant dans la cha&icirc;ne, ex&eacute;cute les scripts
  58 <code>sed</code>, et renvoie les donn&eacute;es g&eacute;n&eacute;r&eacute;es au filtre appelant
  59 dans la cha&icirc;ne de filtrage.
  60 </p>
  61
  62 <p>
  63 Les filtres en entr&eacute;e ou en sortie ne traitent les donn&eacute;es que si des
  64 caract&egrave;res newline sont d&eacute;tect&eacute;s dans le contenu &agrave; filtrer. A la fin des
  65 donn&eacute;es, ce qui reste est trait&eacute; comme la derni&egrave;re ligne.
  66 </p>
  67
  68 <p>Vous trouverez sur le <a
  69 href="https://blogs.oracle.com/basant/entry/using_mod_sed_to_filter">blog de
  70 l'auteur</a> un article en forme de tutoriel, ainsi que les raisons pour
  71 lesquelles ce filtre est plus puissant qu'une simple
  72 recherche/remplacement de cha&icirc;ne ou d'expression rationnelle.</p>
  73
  74 </summary>
  75
  76 <section id="sampleconf"><title>Exemple de configuration</title>
  77     <example><title>Ajout d'un filtre en sortie</title>
  78             <highlight language="config">
  79 # Dans l'exemple suivant, le filtre sed va remplacer la cha&icirc;ne
  80          # "monday" par "MON" et la cha&icirc;ne "sunday" par "SUN" dans les
  81          # documents html avant de les envoyer au client.
  82 &lt;Directory "/var/www/docs/sed"&gt;
  83     AddOutputFilter Sed html
  84     OutputSed "s/monday/MON/g"
  85     OutputSed "s/sunday/SUN/g"
  86 &lt;/Directory&gt;
  87     </highlight>
  88     </example>
  89
  90     <example><title>Ajout d'un filtre en entr&eacute;e</title>
  91     <highlight language="config">
  92          # Dans l'exemple suivant, le filtre sed va remplacer la cha&icirc;ne
  93          # "monday" par "MON" et la cha&icirc;ne "sunday" par "SUN" dans les
  94          # donn&eacute;es POST envoy&eacute;es &agrave; PHP.
  95         &lt;Directory "/var/www/docs/sed"&gt;
  96     AddInputFilter Sed php
  97     InputSed "s/monday/MON/g"
  98     InputSed "s/sunday/SUN/g"
  99 &lt;/Directory&gt;
 100         </highlight>
 101     </example>
 102 </section>
 103 <section id="sed_commands"><title>Commandes sed</title>
 104     <p>
 105     Vous trouverez tous les d&eacute;tails &agrave; propos de la commande
 106     <code>sed</code> dans sa <a href="http://www.gnu.org/software/sed/manual/sed.txt">page
 107     de manuel</a>.
 108     </p>
 109     <dl>
 110         <dt><code>b</code></dt>
 111         <dd>Saut vers le label sp&eacute;cifi&eacute; (similaire &agrave; goto).</dd>
 112         <dt><code>h</code></dt>
 113         <dd>Copie la ligne courante dans le tampon.</dd>
 114         <dt><code>H</code></dt>
 115         <dd>Ajoute la ligne courante au tampon.</dd>
 116         <dt><code>g</code></dt>
 117         <dd>Copie le contenu du tampon dans la ligne courante.</dd>
 118         <dt><code>G</code></dt>
 119         <dd>Ajoute le contenu du tampon &agrave; la ligne courante.</dd>
 120         <dt><code>x</code></dt>
 121         <dd>Echange les contenus du tampon et de la ligne courante.</dd>
 122     </dl>
 123 </section>
 124
 125 <directivesynopsis>
 126 <name>OutputSed</name>
 127 <description>Commande sed pour le filtrage des contenus de type
 128 r&eacute;ponse</description>
 129 <syntax>OutputSed <var>commande-sed</var></syntax>
 130 <contextlist><context>directory</context><context>.htaccess</context>
 131 </contextlist>
 132
 133 <usage>
 134     <p>La directive <directive>OutputSed</directive> permet de sp&eacute;cifier
 135     la commande <code>sed</code> &agrave; ex&eacute;cuter dans le cadre du traitement
 136     d'une r&eacute;ponse.
 137     </p>
 138 </usage>
 139 </directivesynopsis>
 140
 141 <directivesynopsis>
 142 <name>InputSed</name>
 143 <description>Commande sed &agrave; ex&eacute;cuter pour le filtrage des donn&eacute;es d'une
 144 requ&ecirc;te (en g&eacute;n&eacute;ral des donn&eacute;es <code>POST</code>)</description>
 145 <syntax>InputSed <var>commande-sed</var></syntax>
 146 <contextlist><context>directory</context><context>.htaccess</context>
 147 </contextlist>
 148
 149 <usage>
 150     <p>La directive <directive>InputSed</directive> permet de sp&eacute;cifier
 151     la commande sed &agrave; ex&eacute;cuter pour le filtrage des donn&eacute;es (en g&eacute;n&eacute;ral
 152     des donn&eacute;es <code>POST</code>) d'une requ&ecirc;te.
 153     </p>
 154 </usage>
 155 </directivesynopsis>
 156
 157 </modulesynopsis>