mod_expires.xml.ja

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?xml version="1.0" encoding="iso-2022-jp"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
<!-- English Revision: 151405 -->

<!--
 Copyright 2004 The Apache Software Foundation

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_expires.xml.meta">

<name>mod_expires</name>
<description>$B%f!<%6$N;XDj$7$?4p=`$K4p$E$$$?(B <code>Expires</code> $B$H(B
<code>Cache-Control</code> HTTP $B%X%C%@$N@8@.(B</description>
<status>Extension</status>
<sourcefile>mod_expires.c</sourcefile>
<identifier>expires_module</identifier>

<summary>
    <p>$B$3$N%b%8%e!<%k$O%5!<%P1~Ez$N(B <code>Expires</code> HTTP $B%X%C%@(B
    $B$H(B <code>Cache-Control</code> $B%X%C%@$N(B <code>max-age</code> $B%G%#%l%/%F%#%V$N(B
    $B@_Dj$r@)8f$7$^$9!#85$N%U%!%$%k$,:n@.$5$l$?;~9o$^$?$O(B
    $B%/%i%$%"%s%H$N%"%/%;%9;~9o$N$I$A$i$+$K4p$E$$$F4|8B@Z$lF|$r(B
    $B@_Dj$9$k$3$H$,$G$-$^$9!#(B</p>

    <p>$B$3$l$i$N%X%C%@$O%/%i%$%"%s%H$KJ8=q$N(B
    $BM-8z@-$H7QB3@-$r;X<($7$^$9!#J8=q$,%-%c%C%7%e$5$l$?>l9g$K$O!"(B
    $B;XDj;~9o$KC#$9$k$^$G$O!"85$N>l=j$+$i<hF@$9$kBe$o$j$K(B
    $B%-%c%C%7%e$5$l$F$$$k$b$N$r;H$&$3$H$,$G$-$^$9!#$=$N8e$O!"(B
    $B%-%c%C%7%e$K$"$k%3%T!<$O4|8B@Z$l(B (expired) $B$GL58z$G$"$k$H$5$l!"(B
    $B85$N>l=j$+$i?7$7$$$b$N$r<hF@$9$kI,MW$,$"$j$^$9!#(B</p>

    <p><code>max-age</code> $B0J30(B (<a
    href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">RFC
    2616 section 14.9</a> $B;2>H(B) $B$N(B <code>Cache-Control</code> $B$N%G%#%l%/%F%#%V$r(B
    $BA`:n$9$k$K$O(B <directive
    module="mod_headers">Header</directive> $B%G%#%l%/%F%#%V$r(B
    $B;H$&$3$H$,$G$-$^$9!#(B</p></summary>

<section id="AltSyn"><title>$BBeBX4|4V;XDj9=J8(B</title>
   
    <p><directive module="mod_expires">ExpiresDefault</directive> $B%G%#%l%/%F%#%V$H(B
    <directive module="mod_expires">ExpiresByType</directive> $B%G%#%l%/%F%#%V$O(B
    $B0J2<$N$h$jFI$_0W$$9=J8$r;H$C$FDj5A$9$k$3$H$,$G$-$^$9(B:</p>

    <example>
      ExpiresDefault "&lt;base&gt; [plus] {&lt;num&gt;
      &lt;type&gt;}*"<br />
      ExpiresByType type/encoding "&lt;base&gt; [plus]
      {&lt;num&gt; &lt;type&gt;}*"
    </example>

    <p>&lt;base&gt; $B$O0J2<$N$I$l$+$G$9(B:</p>

    <ul>
      <li><code>access</code></li>

      <li><code>now</code> ('<code>access</code>' $B$HEy2A(B)</li>

      <li><code>modification</code></li>
    </ul>

    <p><code>plus</code> $B%-!<%o!<%I$O>JN,2DG=$G$9!#(B&lt;num&gt;
    $B$O(B (<code>atoi()</code> $B$,<u$1IU$1$k(B) $B@0?tCM!"(B
    &lt;type&gt; $B$O0J2<$N$I$l$+$G$9(B:</p>

    <ul>
      <li><code>years</code></li>
      <li><code>months</code></li>
      <li><code>weeks</code></li>
      <li><code>days</code></li>
      <li><code>hours</code></li>
      <li><code>minutes</code></li>
      <li><code>seconds</code></li>
    </ul>

    <p>$BNc$($P!"0J2<$N%G%#%l%/%F%#%V$O$I$l$b%G%U%)%k%H$GJ8=q$,%"%/%;%9$N(B 1 $B%v7n8e$K(B
    $B4|8B$,@Z$l$k$h$&$K$9$k$?$a$K;H$($^$9(B:</p>

    <example>
      ExpiresDefault "access plus 1 month"<br />
      ExpiresDefault "access plus 4 weeks"<br />
      ExpiresDefault "access plus 30 days"
    </example>

    <p>$B4|8B@Z$l;~9o$O$$$/$D$+(B
    '&lt;num&gt; &lt;type&gt;' $B@a$rDI2C$9$k$3$H$G$h$j:Y$+$/(B
    $B@)8f$9$k$3$H$,$G$-$^$9(B:</p>

    <example>
      ExpiresByType text/html "access plus 1 month 15
      days 2 hours"<br />
      ExpiresByType image/gif "modification plus 5 hours 3
      minutes"
    </example>

    <p>$B=$@5;~9o$K4p$E$$$?@_Dj$r;HMQ$7$F$$$k>l9g!"(BExpires $B%X%C%@$O(B
    $B%G%#%9%/$N%U%!%$%k0J30$N%3%s%F%s%D$K$O(B<strong>$BDI2C$5$l$J$$(B</strong>$B$3$H$KCm0U(B
    $B$7$F$/$@$5$$!#$=$N$h$&$J%3%s%F%s%D$K$O=$@5;~9o$OB8:_$7$J$$$+$i$G$9!#(B</p>
</section>

<directivesynopsis>
<name>ExpiresActive</name>
<description><code>Expires</code> $B%X%C%@$N@8@.$rM-8z$K$9$k(B</description>
<syntax>ExpiresActive On|Off</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>$B$3$N%G%#%l%/%F%#%V$OBP1~$9$k%I%-%e%a%s%H$NNN0h$G(B
    <code>Expires</code> $B$H(B <code>Cache-Control</code>$B%X%C%@$r(B
    $BM-8z$K$9$k$+L58z$K$9$k$+$r7h$a$^$9!#(B
    ($BNc$($P!"(B<code>.htaccess</code> $B%U%!%$%k$G$O$=$N%G%#%l%/%H%j$N(B
    $BJ8=q$N$_$KE,MQ$5$l$k$H$$$&$3$H$G$9!#(B) <code>Off</code> $B$K(B
    $B@_Dj$5$l$?>l9g$OBP1~NN0h$G$=$l$i$N%X%C%@$O(B
    $B@8@.$5$l$^$;$s(B (<code>.htaccess</code> $B$,%5!<%P@_Dj%U%!%$%k$N@_Dj$r(B
    $B>e=q$-$9$k!"$H$$$&$h$&$J2<0L%l%Y%k$G$N>e=q$-$,$5$l$F$$$J$1$l$P(B)$B!#(B
    <code>On</code> $B$K@_Dj$5$l$F$$$l$P!"%X%C%@$O(B <directive
    module="mod_expires">ExpiresByType</directive> $B%G%#%l%/%F%#%V$H(B
    <directive module="mod_expires">ExpiresDefault</directive> $B%G%#%l%/%F%#%V(B
    $B$N4p=`$K=>$C$FJ8=q$K%X%C%@$rDI2C$7$^$9(B ($B3F%G%#%l%/%F%#%V;2>H(B)$B!#(B</p>

    <p>$B$3$N%G%#%l%/%F%#%V$O(B <code>Expires</code> $B$H(B
    <code>Cache-Control</code> $B%X%C%@$NB8:_$r(B
    $BJ]>Z$9$k$o$1$G$O$J$$$3$H$KCm0U$7$F$/$@$5$$!#4p=`$,K~$?$5$l$F(B
    $B$$$J$$>l9g$O%X%C%@$ODI2C$5$l$:!"7k2L$H$7$F$3$N%G%#%l%/%F%#%V$,(B
    $B;XDj$5$l$F$$$J$+$C$?$+$N$h$&$K$5$(8+$($k$3$H$K$J$j$^$9!#(B</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExpiresByType</name>
<description>MIME $B%?%$%W$K$h$C$F@_Dj$5$l$k(B <code>Expires</code> $B%X%C%@$NCM(B</description>
<syntax>ExpiresByType <var>MIME-type</var>
<var>&lt;code&gt;seconds</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>$B$3$N%G%#%l%/%F%#%V$O;XDj$5$l$?%?%$%W$N%I%-%e%a%s%H(B
    (<em>$BNc$($P(B</em> <code>text/html</code>)
    $B$KBP$7$F@8@.$5$l$k(B <code>Expires</code> $B%X%C%@$H(B <code>Cache-Control</code>
    $B%X%C%@$N(B <code>max-age</code> $B%G%#%l%/%F%#%V$NCM$rDj5A$7$^$9!#(B
    $BFs$DL\$N0z?t$O4|8B@Z$l$NF|;~$r@8@.$9$k$?$a$N4p=`;~9o$KDI2C$5$l$k(B
    $BIC?t$r@_Dj$7$^$9!#(B<code>Cache-Control:
    max-age</code> $B$O4|8B@Z$l$N;~9o$+$i%j%/%(%9%H;~9o$r0z$$$?$b$N$rIC$G(B
    $BI=$9$3$H$G@8@.$5$l$^$9!#(B</p>

    <p>$B4p=`;~9o$O%U%!%$%k$N:G=*=$@5;~9o$+!"%/%i%$%"%s%H$N%I%-%e%a%s%H$X$N(B
    $B%"%/%;%9;~9o$G$9!#$I$A$i$r;H$&$Y$-$+$O(B <code><var>&lt;code&gt;</var></code>
    $B$K$h$C$F;XDj$7$^$9!#(B<code>M</code> $B$O4p=`;~9o$H$7$F(B
    $B%U%!%$%k$N:G=*=$@5;~9o$r$H$$$&0UL#$G!"(B<code>A</code> $B$O%/%i%$%"%s%H$N(B
    $B%"%/%;%9;~9o$r;H$&$H$$$&0UL#$K$J$j$^$9!#(B</p>

    <p>$B8z2L$K$OHyL/$J0c$$$,$"$j$^$9!#(B<code>M</code> $B$,;HMQ$5$l$?>l9g$O!"(B
    $B$9$Y$F$N%-%c%C%7%e$K$"$k8=:_$N%I%-%e%a%s%H%-%c%C%7%e$OF1;~$K4|8B$,(B
    $B@Z$l$^$9!#$3$l$OF1$8(B URL $B$KKh=5>o$KCV$+$l$kJs$;$N$h$&$J$b$N$K$O(B
    $BHs>o$KM-8z$G$9!#(B<code>A</code> $B$,;HMQ$5$l$?>l9g$O!"4|8B@Z$l$N(B
    $B;~4V$O3F%/%i%$%"%s%H$h$C$F0[$J$j$^$9!#$3$l$O$"$^$jJQ99$5$l$J$$(B
    $B2hA|%U%!%$%k$J$I!"FC$K4XO"$9$k%I%-%e%a%s%H72$,$9$Y$FF1$82hA|$r(B
    $B;2>H$9$k$H$-(B (<em>$B$9$J$o$A(B</em>$B2hA|$,Hf3SE*C;$$4|4VFb$K7+$jJV$7(B
    $B%"%/%;%9$5$l$k$H$-(B) $B$KM-8z$G$9!#(B</p>

    <example><title>$BNc(B:</title>
      # enable expirations<br />
      ExpiresActive On<br />
      # expire GIF images after a month in the client's cache<br />
      ExpiresByType image/gif A2592000<br />
      # HTML documents are good for a week from the<br />
      # time they were changed<br />
      ExpiresByType text/html M604800
    </example>

    <p>$B$3$N%G%#%l%/%F%#%V$O(B <code>ExpiresActive On</code> $B$,;XDj$5$l$F$$$k(B
    $B$H$-$N$_M-8z$G$"$k$3$H$KCm0U$7$F$/$@$5$$!#$3$l$O!"(B
    $B;XDj$5$l$?(B MIME $B%?%$%W$KBP$7$F(B<em>$B$N$_(B</em> <directive
    module="mod_expires">ExpiresDefault</directive> $B%G%#%l%/%F%#%V$G(B
    $B@_Dj$5$l$?4|8B@Z$l4|F|$r>e=q$-$7$^$9!#(B</p>

    <p>$B$3$NJ8=q$NA0$NJ}$G@bL@$5$l$F$$$k(B<a href="#AltSyn">$BBeBX9=J8(B</a>$B$r(B
    $B;H$C$F4|8B@Z$l4|F|$N7W;;J}K!$r;XDj$9$k$3$H$b$G$-$^$9!#(B</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExpiresDefault</name>
<description>$B4|8B@Z$l4|F|$r7W;;$9$k%G%U%)%k%H%"%k%4%j%:%`(B</description>
<syntax>ExpiresDefault <var>&lt;code&gt;seconds</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>$B$3$N%G%#%l%/%F%#%V$OBP1~$9$kHO0O$N$9$Y$F$N%I%-%e%a%s%H$KBP$7$F(B
    $B%G%U%)%k%H$N4|8B@Z$l4|F|$N7W;;%"%k%4%j%:%`$r@_Dj$7$^$9!#(B<directive
    module="mod_expires">ExpiresByType</directive> $B%G%#%l%/%F%#%V$K$h$C$F(B
    $B%?%$%WKh$K>e=q$-$9$k$3$H$,$G$-$^$9!#0z?t$N9=J8$O$=$N%G%#%l%/%F%#%V$N(B
    $B@bL@$r;2>H$7$F$/$@$5$$!#$^$?!"(B<a href="#AltSyn">$BBeBX9=J8(B</a>$B$b(B
    $B;2>H$7$F$/$@$5$$!#(B</p>
</usage>
</directivesynopsis>
</modulesynopsis>