granicus.if.org Git - apache/blob - docs/manual/mod/mod_headers.xml.ja

   1 <?xml version="1.0" encoding="iso-2022-jp"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <modulesynopsis metafile="mod_headers.xml.meta">
   5 <!-- English revision: 1.7 -->
   6
   7 <name>mod_headers</name>
   8 <description>HTTP \e$B%j%/%(%9%H$N%X%C%@$H1~Ez$N%X%C%@$N%+%9%?%^%$%:\e(B</description>
   9 <status>Extension</status>
  10 <sourcefile>mod_headers.c</sourcefile>
  11 <identifier>headers_module</identifier>
  12 <compatibility><directive module="mod_headers">RequestHeader</directive>
  13 \e$B$O\e(B Apache 2.0 \e$B0J9_$N$_$G;HMQ2DG=\e(B</compatibility>
  14
  15 <summary>
  16     <p>\e$B$3$N%b%8%e!<%k$O\e(B HTTP \e$B$N%j%/%(%9%H%X%C%@$H1~Ez%X%C%@$r@)8f$7!"\e(B
  17     \e$BJQ99$9$k$?$a$N%G%#%l%/%F%#%V$rDs6!$7$^$9!#%X%C%@$rDI2C$7$?$j!"\e(B
  18     \e$BCV$-49$($?$j!":o=|$7$?$j$9$k$3$H$,$G$-$^$9!#\e(B</p>
  19 </summary>
  20
  21 <section id="order"><title>\e$B=hM}$N=gHV\e(B</title>
  22
  23     <p><module>mod_header</module> \e$B$N%G%#%l%/%F%#%V$O%5!<%P@_Dj$N$[$\$I$3$K$G$b\e(B
  24     \e$B=q$/$3$H$,$G$-!"1F6A$9$kHO0O$r\e(B<a
  25     href="../sections.html">\e$B@_DjMQ%;%/%7%g%s\e(B</a>\e$B$G0O$`$3$H$G8BDj$9$k\e(B
  26     \e$B$3$H$,$G$-$^$9!#\e(B</p>
  27
  28     <p>\e$B=hM}$N=gHV$O=EMW$G!"@_Dj%U%!%$%kCf$N=gHV$H!"\e(B<a
  29     href="../sections.html">\e$B@_DjMQ%;%/%7%g%s\e(B</a>\e$BFb$N0LCV$H$NN>J}$K\e(B
  30     \e$B1F6A$5$l$^$9!#0J2<$NFs$D$N%X%C%@$O=gHV$,5U$K$J$k$H\e(B
  31     \e$B0c$&7k2L$K$J$j$^$9\e(B:</p>
  32
  33     <example>
  34       RequestHeader append MirrorID "mirror 12"<br />
  35       RequestHeader unset MirrorID
  36     </example>
  37
  38     <p>\e$B$3$N=gHV$N>l9g$O!"\e(B<code>MirrorID</code> \e$B%X%C%@$O@_Dj$5$l$^$;$s!#\e(B
  39     \e$B5U$K$J$C$F$$$k$H!"\e(BMirrorID \e$B%X%C%@$O\e(B "mirror 12" \e$B$K@_Dj$5$l$^$9!#\e(B</p>
  40 </section>
  41
  42 <section id="examples"><title>\e$BNc\e(B</title>
  43
  44     <ol>
  45       <li>\e$B%j%/%(%9%H%X%C%@Cf$N\e(B "TS" \e$B$G;O$^$k%U%#!<%k%I$r$9$Y$F1~Ez%X%C%@$K\e(B
  46         \e$B%3%T!<$7$^$9\e(B:
  47         <example>
  48           Header echo ^TS
  49         </example>
  50       </li>
  51
  52       <li>
  53         \e$B%j%/%(%9%H$r<u$1IU$1$?;~9o$H%j%/%(%9%H$r=hM}$7$?;~4V$rF~$l$?%X%C%@!"\e(B
  54         <code>MyHeader</code> \e$B$r1~Ez$KDI2C$7$^$9!#$3$N%X%C%@$O%/%i%$%"%s%H$,\e(B
  55         \e$B%5!<%P$NIi2Y$rD>4QE*$KCN$k$?$a$d!"%/%i%$%"%s%H\e(B-\e$B%5!<%P4V$N\e(B
  56         \e$B%\%H%k%M%C%/$rD4$Y$k$?$a$K;H$&$3$H$,$G$-$^$9!#\e(B
  57
  58         <example>
  59            Header add MyHeader "%D %t"
  60         </example>
  61
  62         <p>\e$B>e5-$N@_Dj$G$O!"0J2<$N$h$&$J%X%C%@$,1~Ez$KDI2C$5$l$k$3$H$K$J$j$^$9\e(B:</p>
  63
  64         <example>
  65            MyHeader: D=3775428 t=991424704447256
  66         </example>
  67       </li>
  68
  69       <li>
  70         Joe \e$B$K$"$$$5$D$r$7$^$9\e(B:
  71
  72         <example>
  73            Header add MyHeader "Hello Joe. It took %D microseconds for Apache to serve this request."
  74         </example>
  75
  76         <p>\e$B0J2<$N$h$&$J%X%C%@$,1~Ez$KDI2C$5$l$k$3$H$K$J$j$^$9\e(B</p>
  77
  78         <example>
  79            MyHeader: Hello Joe. It took D=3775428 microseconds for Apache to serve this request.
  80         </example>
  81       </li>
  82
  83       <li>\e$B%j%/%(%9%H$K\e(B "MyRequestHeader" \e$B$,$"$k$H$-$K8B$j\e(B <code>MyHeader</code> \e$B$r1~Ez$K\e(B
  84       \e$BIU$1$^$9!#$3$l$O!"%/%i%$%"%s%H$NMW5a$K1~$($F%X%C%@$r:n@.$9$k$H$-$K\e(B
  85       \e$BLr$KN)$A$^$9!#$3$NNc$G$O\e(B <module>mod_setenvif</module> \e$B%b%8%e!<%k$,I,MW$J$3$H$K\e(B
  86       \e$BCm0U$7$F$/$@$5$$!#\e(B
  87
  88         <example>
  89            SetEnvIf MyRequestHeader value HAVE_MyRequestHeader<br />
  90            Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
  91         </example>
  92
  93         <p>\e$B$b$7\e(B HTTP \e$B%j%/%(%9%H$K\e(B <code>MyRequestHeader: value</code> \e$B%X%C%@$,\e(B
  94         \e$B$"$k$H!"1~Ez$K$O0J2<$N$h$&$J%X%C%@$,IU2C$5$l$^$9!#\e(B</p>
  95
  96         <example>
  97            MyHeader: D=3775428 t=991424704447256 mytext
  98         </example>
  99       </li>
 100     </ol>
 101 </section>
 102
 103 <directivesynopsis>
 104 <name>RequestHeader</name>
 105 <description>HTTP \e$B%j%/%(%9%H%X%C%@$N@_Dj\e(B</description>
 106 <syntax>RequestHeader set|append|add|unset <var>header</var>
 107 [<var>value</var>]</syntax>
 108 <contextlist><context>server config</context><context>virtual host</context>
 109 <context>directory</context><context>.htaccess</context></contextlist>
 110 <override>FileInfo</override>
 111
 112 <usage>
 113     <p>\e$B$3$N%G%#%l%/%F%#%V$O\e(B HTTP \e$B%j%/%(%9%H%X%C%@$rCV49!"DI2C!":o=|$G$-$^$9!#\e(B
 114     \e$B%X%C%@$O%3%s%F%s%H%O%s%I%i$,<B9T$5$l$kD>A0$K<B9T$5$l!"\e(B
 115     \e$BF~$C$FMh$k%X%C%@$rJQ99$9$k$3$H$,2DG=$K$J$C$F$$$^$9!#\e(B
 116     \e$B9T$J$&=hM}$OBh\e(B 1 \e$B0z?t$K$h$j7h$^$j$^$9!#$3$l$K$O0J2<$NCM$r;XDj\e(B
 117     \e$B$9$k$3$H$,$G$-$^$9\e(B:</p>
 118
 119     <dl>
 120     <dt><code>set</code></dt>
 121     <dd>\e$B%j%/%(%9%H%X%C%@$r@_Dj$7$^$9!#F1$8L>A0$N%X%C%@$,B8:_$7$F$$$k$H!"\e(B
 122     \e$B$=$l$rCV$-49$($^$9!#\e(B</dd>
 123
 124     <dt><code>append</code></dt>
 125     <dd>\e$B%j%/%(%9%H%X%C%@$O!"4{$KB8:_$9$kF1$8L>A0$N%X%C%@$KDI2C$5$l$^$9!#\e(B
 126     \e$B?7$7$$CM$,4{B8$N%X%C%@$KDI2C$5$l$k$H$-$K$O!"4{B8$N%X%C%@$N\e(B
 127     \e$B8e$K%3%s%^$G6h@Z$i$l$FDI2C$5$l$^$9!#$3$l$O%X%C%@$KJ#?t$NCM$r\e(B
 128     \e$B;XDj$9$k$H$-$N\e(B HTTP \e$B$NI8=`$NJ}K!$G$9!#\e(B</dd>
 129
 130     <dt><code>add</code></dt>
 131     <dd>\e$B%X%C%@$,4{$KB8:_$7$F$$$k$H$-$G$5$($b!"%j%/%(%9%H%X%C%@$r\e(B
 132     \e$B4{B8$N%X%C%@$KDI2C$7$^$9!#$3$l$K$h$j!"Fs$D\e(B (\e$B$+$=$l0J>e\e(B) \e$B$N\e(B
 133     \e$B%X%C%@$NL>A0$,F1$8$K$J$k$3$H$,$"$j$^$9!#$=$N7k2L!"A[Dj$G$-$J$$\e(B
 134     \e$B$3$H$,5/$3$k2DG=@-$,$"$j$^$9$N$G!"0lHLE*$K$O\e(B <code>append</code> \e$B$NJ}$r\e(B
 135     \e$B;H$&J}$,NI$$$G$7$g$&!#\e(B</dd>
 136
 137     <dt><code>unset</code></dt>
 138     <dd>\e$B$b$7;XDj$5$l$?L>A0$N%j%/%(%9%H%X%C%@$,B8:_$7$F$$$l$P!":o=|$5$l$^$9!#\e(B
 139     \e$BF1$8L>A0$NJ#?t$N%X%C%@$,$"$k$H$-$O!"$9$Y$F:o=|$5$l$^$9!#\e(B</dd>
 140     </dl>
 141
 142     <p>\e$B$3$N0z?t$N8e$K$O%X%C%@L>\e(B (<em>header</em>) \e$B$,B3$-$^$9!#\e(B
 143     \e$B%X%C%@L>$K$O:G8e$K%3%m%s$r4^$a$k$3$H$b$G$-$^$9$,!"L5$/$F$b9=$$$^$;$s!#\e(B
 144     \e$BBgJ8;z>.J8;z$O6hJL$5$l$^$;$s!#\e(B<code>add</code>,
 145     <code>append</code>, <code>set</code> \e$B$N>l9g$O!"\e(B<em>value</em> \e$B$,;0$DL\$N\e(B
 146     \e$B0z?t$H$7$F;XDj$5$l$^$9!#\e(B<em>value</em> \e$B$K6uGr$,$"$k>l9g$OFs=E0zMQId$G\e(B
 147     \e$B0O$`I,MW$,$"$j$^$9!#\e(Bunset \e$B$N>l9g$O!"\e(B<em>value</em> \e$B$O;XDj$7$^$;$s!#\e(B</p>
 148
 149     <p><directive>RequestHeader</directive> \e$B%G%#%l%/%F%#%V$O!"\e(B
 150     fixup \e$B%U%'!<%:$G%j%/%(%9%H$,%O%s%I%i$K07$o$l$kD>A0$K\e(B
 151     \e$B=hM}$5$l$^$9!#$3$l$K$h$j!"%V%i%&%6$d\e(B Apache \e$B$NF~NO%U%#%k%?$K$h$j\e(B
 152     \e$B@8@.$5$l$?%X%C%@$r>e=q$-$7$?$j=$@5$7$?$j$G$-$k$h$&$K$J$C$F$$$^$9!#\e(B</p>
 153 </usage>
 154 </directivesynopsis>
 155
 156 <directivesynopsis>
 157 <name>Header</name>
 158 <description>HTTP \e$B1~Ez%X%C%@$N@_Dj\e(B</description>
 159 <syntax>Header set|append|add|unset|echo  <var>header</var>
 160 [<var>value</var> [env=[!]<var>variable</var>]]</syntax>
 161 <contextlist><context>server config</context><context>virtual host</context>
 162 <context>directory</context><context>.htaccess</context></contextlist>
 163 <override>FileInfo</override>
 164 <usage>
 165     <p>\e$B$3$N%G%#%l%/%F%#%V$O\e(B HTTP \e$B1~Ez%X%C%@$rCV49!"DI2C!":o=|$G$-$^$9!#\e(B
 166     \e$B%X%C%@$O%3%s%F%s%H%O%s%I%i$d=PNO%U%#%k%?$,<B9T$5$l$?D>8e$K<B9T$5$l!"\e(B
 167     \e$B=P$F9T$/%X%C%@$rJQ99$9$k$3$H$,2DG=$K$J$C$F$$$^$9!#\e(B
 168     \e$B9T$J$&=hM}$O:G=i$N0z?t$K$h$j7h$^$j$^$9!#$3$l$K$O0J2<$NCM$r;XDj\e(B
 169     \e$B$9$k$3$H$,$G$-$^$9\e(B:</p>
 170
 171     <dl>
 172     <dt><code>set</code></dt>
 173     <dd>\e$B1~Ez%X%C%@$r@_Dj$7$^$9!#F1$8L>A0$N%X%C%@$,B8:_$9$k>l9g$O$=$l$r\e(B
 174     \e$BCV$-49$($^$9!#\e(B<em>value</em> \e$B$K$O%U%)!<%^%C%HJ8;zNs$r\e(B
 175     \e$B;XDj$9$k$3$H$b$G$-$^$9!#\e(B</dd>
 176
 177     <dt><code>append</code></dt>
 178     <dd>\e$B1~Ez%X%C%@$r4{$KB8:_$9$kF1$8L>A0$N%X%C%@$KDI2C$7$^$9!#\e(B
 179     \e$B?7$7$$CM$,4{B8$N%X%C%@$KDI2C$5$l$k$H$-$K$O!"4{B8$N%X%C%@$N\e(B
 180     \e$B8e$K%3%s%^$G6h@Z$i$l$FDI2C$5$l$^$9!#$3$l$O%X%C%@$KJ#?t$NCM$r\e(B
 181     \e$B;XDj$9$k$H$-$N\e(B HTTP \e$B$NI8=`$NJ}K!$G$9!#\e(B</dd>
 182
 183     <dt><code>add</code></dt>
 184     <dd>\e$B%X%C%@$,4{$KB8:_$7$F$$$k$H$-$G$5$($b!"1~Ez%X%C%@$r\e(B
 185     \e$B4{B8$N%X%C%@$KDI2C$7$^$9!#$3$l$K$h$j!"Fs$D\e(B (\e$B$+$=$l0J>e\e(B) \e$B$N\e(B
 186     \e$B%X%C%@$NL>A0$,F1$8$K$J$k$3$H$,$"$j$^$9!#$=$N7k2L!"A[Dj$G$-$J$$\e(B
 187     \e$B$3$H$,5/$3$k2DG=@-$,$"$j$^$9$N$G!"0lHLE*$K$O\e(B <code>append</code> \e$B$NJ}$r\e(B
 188     \e$B;H$&J}$,NI$$$G$7$g$&!#\e(B</dd>
 189
 190     <dt><code>unset</code></dt>
 191     <dd>\e$B$b$7;XDj$5$l$?L>A0$N1~Ez%X%C%@$,B8:_$7$F$$$l$P!":o=|$5$l$^$9!#\e(B
 192     \e$BF1$8L>A0$N%X%C%@$,J#?t$"$k$H$-$O!"$9$Y$F:o=|$5$l$^$9!#\e(B</dd>
 193
 194     <dt><code>echo</code></dt>
 195     <dd>\e$B;XDj$5$l$?$b$N$HF1$8L>A0$N%j%/%(%9%H%X%C%@$r1~Ez%X%C%@$G\e(B
 196     \e$B$=$N$^$^JV$7$^$9!#\e(B<var>header</var> \e$B$K$O@55,I=8=$b;XDj$G$-$^$9!#\e(B</dd>
 197     </dl>
 198
 199     <p>\e$B$3$N0z?t$N8e$K$O%X%C%@L>\e(B (<var>header</var>) \e$B$,B3$-$^$9!#\e(B
 200     \e$B%X%C%@L>$K$O:G8e$K%3%m%s$r4^$a$k$3$H$b$G$-$^$9$,!"L5$/$F$b9=$$$^$;$s!#\e(B
 201     <code>set</code>, <code>append</code>, <code>add</code>,
 202     <code>unset</code> \e$B$G$OBgJ8;z>.J8;z$O\e(B
 203     \e$B6hJL$5$l$^$;$s!#\e(Becho \e$B$N\e(B <em>header</em> \e$BL>$OBgJ8;z>.J8;z$r6hJL$7!"\e(B
 204     \e$B@55,I=8=$r;XDj$9$k$3$H$b$G$-$^$9!#\e(B</p>
 205
 206     <p><code>add</code>, <code>append</code>,
 207     <code>set</code> \e$B$G$O\e(B <var>value</var> \e$B$r;0$DL\$N\e(B
 208     \e$B0z?t$H$7$F;XDj$7$^$9!#\e(B<var>value</var> \e$B$K6uGr$,$"$k>l9g$OFs=E0zMQId$G\e(B
 209     \e$B0O$`I,MW$,$"$j$^$9!#\e(B<var>value</var> \e$B$OJ8;z$N$_$+$i$J$kJ8;zNs!"\e(B
 210     \e$B%U%)!<%^%C%H;X<(;R$r4^$`J8;zNs!"$b$7$/$ON>J}$+$i$J$kJ8;zNs$r;XDj$G$-$^$9!#\e(B
 211     <var>value</var> \e$B$O0J2<$N%U%)!<%^%C%H;X<(;R$r%5%]!<%H$7$^$9\e(B:</p>
 212
 213     <table>
 214     <tr><td><code>%t</code></td>
 215         <td>\e$B%j%/%(%9%H$r<u$1<h$C$?;~9o$r!"\e(B
 216         Universal Coordinated Time \e$B$G$N;O$^$j$N;~9o\e(B (Jan. 1, 1970) \e$B$+$i7P2a$7$?\e(B
 217         \e$B;~4V$r%^%$%/%mIC$H$7$F8=$7$?$b$N!#CM$N:G=i$K$O\e(B
 218         <code>t=</code> \e$B$,IU2C$5$l$^$9!#\e(B</td></tr>
 219
 220     <tr><td><code>%D</code></td>
 221         <td>\e$B%j%/%(%9%H$r<u$1<h$C$?;~9o$H!"%X%C%@$rAw$j=P$7$?\e(B
 222         \e$B;~4V$H$N:9!#$3$l$O!"%j%/%(%9%H$,B8:_$7$F$$$?4|4V$r8=$7$^$9!#\e(B
 223         \e$BCM$N:G=i$K$O\e(B <code>D=</code> \e$B$,IU2C$5$l$^$9!#\e(B</td></tr>
 224
 225     <tr><td><code>%{FOOBAR}e</code></td>
 226         <td><a href="../env.html">\e$B4D6-JQ?t\e(B</a>
 227         <code>FOOBAR</code> \e$B$NCM$G$9!#\e(B</td></tr>
 228     </table>
 229
 230     <p><directive>Header</directive> \e$B%G%#%l%/%F%#%V$,\e(B
 231     <code>add</code>, <code>append</code>, <code>set</code> \e$B$H$7$F\e(B
 232     \e$B;H$o$l$?$H$-$K$O!"F0:n$r9T$J$&>r7o$r;M$DL\$N0z?t$G;XDj$9$k$3$H$,$G$-$^$9!#\e(B
 233     <code>env=...</code> \e$B0z?t$G;XDj$5$l$?\e(B <a
 234     href="../env.html">\e$B4D6-JQ?t\e(B</a> \e$B$,B8:_$9$k\e(B (\e$B$b$7$/$O\e(B <code>env=!...</code>
 235     \e$B$,;XDj$5$l$F$$$F4D6-JQ?t$,B8:_$7$J$$\e(B) \e$B>l9g$O!"\e(B<directive>Header</directive>
 236     \e$B%G%#%l%/%F%#%V$G;XDj$5$l$?F0:n$,9T$J$o$l$^$9!#$=$&$G$J$$>l9g$O!"\e(B
 237     \e$B%G%#%l%/%F%#%V$O$=$N%j%/%(%9%H$K$O2?$b$7$^$;$s!#\e(B</p>
 238
 239     <p><directive>Header</directive>
 240     \e$B%G%#%l%/%F%#%V$O1~Ez$,%M%C%H%o!<%/$KAw$i$l$kD>A0$K\e(B
 241     \e$B=hM}$5$l$^$9!#$3$l$O!"%X%C%@%U%#%k%?$K$h$jDI2C$5$l$k%X%C%@$r\e(B
 242     \e$B=|$-!"$[$H$s$I$N%X%C%@$r@_Dj$7$?$j>e=q$-$7$?$j$9$k$3$H$,\e(B
 243     \e$B2DG=!"$H$$$&$3$H$G$9!#\e(B</p>
 244 </usage>
 245 </directivesynopsis>
 246
 247 </modulesynopsis>
 248