mod_include.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: 104991:151405 (outdated) -->

<!--
 Copyright 2002-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_include.xml.meta">

<name>mod_include</name>
<description>$B%5!<%P$,%Q!<%9$9$k(B html $B%I%-%e%a%s%H(B (Server Side Includes)</description>
<status>Base</status>
<sourcefile>mod_include.c</sourcefile>
<identifier>include_module</identifier>
<compatibility>Apache 2.0 $B$+$i=PNO%U%#%k%?$H$7$F<BAu$5$l$^$7$?!#(B</compatibility>

<summary>
    <p>$B$3$N%b%8%e!<%k$O%U%!%$%k$,%/%i%$%"%s%H$KAw$i$l$kA0$K=hM}$9$k%U%#%k%?$r(B
    $BDs6!$7$^$9!#=hM}$NFbMF$O(B<dfn>$BMWAG(B</dfn>$B$H8F$P$l$kFCJL$J7A<0$N(B SGML $B%3%a%s%H$K$h$j(B
    $B@)8f$5$l$^$9!#$3$l$i$NMWAG$O>r7oJ,4t$d!"B>$N%U%!%$%k$d(B
    $B%W%m%0%i%`$N=PNO$N<h$j9~$_!"4D6-JQ?t$N@_Dj$dI=<($r9T$J$&$3$H$,(B
    $B$G$-$^$9!#(B</p>
</summary>
<seealso><directive module="core">Options</directive></seealso>
<seealso><directive module="core">AcceptPathInfo</directive></seealso>
<seealso><a href="../misc/custom_errordocs.html"
      >$B9q:]2=$5$l$?%+%9%?%`%5!<%P%(%i!<%a%C%;!<%8(B</a></seealso>
<seealso><a href="../filter.html">$B%U%#%k%?(B</a></seealso>
<seealso><a href="../howto/ssi.html">SSI $B%A%e!<%H%j%"%k(B</a></seealso>

<section id="enabling">
    <title>Server-Side Includes $B$rM-8z$K$9$k(B</title>

    <p>Server Side Includes $B$O(B <code>INCLUDES</code>
    <a href="../filter.html">$B%U%#%k%?(B</a> $B$K$h$j<BAu$5$l$F$$$^$9!#(B
    Server-side include $B$N%G%#%l%/%F%#%V$r4^$`%I%-%e%a%s%H$N3HD%;R$,(B
    .shtml $B$N>l9g!"0J2<$N%G%#%l%/%F%#%V$G$O(B Apache $B$,$=$l$i$r(B
    $B%Q!<%9$7$F!"$=$N7k2L$G$-$k%I%-%e%a%s%H$K(B <code>text/html</code> $B$N(B
    MIME $B%?%$%W$r3d$jEv$F$^$9(B:</p>

    <example>
      AddType text/html .shtml<br />
      AddOutputFilter INCLUDES .shtml
    </example>

    <p>$B0J2<$N%G%#%l%/%F%#%V$O(B shtml $B%U%!%$%k$N$"$k%G%#%l%/%H%j$G;XDj$5$l$F$$$k(B
    $BI,MW$,$"$j$^$9(B ($BDL>o$O(B <directive module="core" 
    type="section">Directory</directive> $B%;%/%7%g%s$G;XDj$7$^$9$,!"(B
    <directive module="core">AllowOverride</directive> <code>Options</code>
    $B$,@_Dj$5$l$F$$$k$H!"(B<code>.htaccess</code> $B%U%!%$%k$K=q$/$3$H$b$G$-$^$9(B):</p>

    <example>
      Options +Includes
    </example>

    <p>$B8_49@-$rJ]$D$?$a$K!"(B<code>server-parsed</code>
    <a href="../handler.html">$B%O%s%I%i(B</a> $B$b(B INCLUDES $B%U%#%k%?$r(B
    $BM-8z$K$7$^$9!#(BMIME $B%?%$%W(B <code>text/x-server-parsed-html</code> $B$d(B
    <code>text/x-server-parsed-html3</code> $B$N%I%-%e%a%s%H$KBP$7$F$b(B
    Apache $B$O(B INCLUDES $B%U%#%k%?$rM-8z$K$7$^$9(B ($B=PNO$5$l$k$b$N$O(B
    MIME $B%?%$%W(B <code>text/html</code> $B$K$J$j$^$9(B)$B!#(B</p>

    <p>$B>\$7$$>pJs$O(B <a
    href="../howto/ssi.html">Tutorial on Server Side Includes</a>.</p>
</section> <!-- /enabling -->

<section id="pathinfo">
    <title>$B%5!<%P%5%$%I%$%s%/%k!<%I(B (SSI) $B$G$N(B PATH_INFO</title>

    <p>SSI $B$G=hM}$5$l$k%U%!%$%k$O%G%U%)%k%H$G$O(B <code>PATH_INFO</code>
    ($B8eB3$N%Q%9L>>pJs(B)
    $BIU$-$N%j%/%(%9%H$r<u$1F~$l$J$/$J$j$^$7$?!#(B<directive 
    module="core">AcceptPathInfo</directive> $B%G%#%l%/%F%#%V$G(B
    <code>PATH_INFO</code> $BIU$-$N%j%/%(%9%H$r<u$1F~$l$k$h$&$K%5!<%P$r(B
    $B@_Dj$G$-$^$9!#(B</p>
</section> <!-- /pathinfo -->

<section id="elements"><title>$B4pK\MWAG(B</title>
    <p>$B%I%-%e%a%s%H$O!"(BSGML $B$N%3%a%s%H$H$7$FFCJL$J%3%^%s%I$,Kd$a9~$^$l$?(B
    HTML $B%I%-%e%a%s%H$H$7$F%Q!<%9$5$l$^$9!#%3%^%s%I$N9=J8$O<!$N$h$&$K(B
    $B$J$C$F$$$^$9(B:</p>

    <example>
      &lt;!--#<var>element</var> <var>attribute</var>=<var>value</var>
      <var>attribute</var>=<var>value</var> ... --&gt;
    </example>

    <p>$BCM(B ($BLuCm(B: value) $B$OFs=E0zMQId$G0O$`$N$,0lHLE*$G$9$,!"(B
    $B%7%s%0%k%/%*!<%H(B (') $B$H%P%C%/%/%*!<%H(B (`) $B$b;HMQ$G$-$^$9!#(B
    $BB?$/$N%3%^%s%I$OB0@-(B-$BCM(B ($BLuCm(B: attribute-value) $B$NAH$r0l$D$@$1;XDj$G$-$^$9!#(B
    $B%3%a%s%H$N=*$o$j(B (<code>--&gt;</code>)
    $B$NA0$K$O!"(BSSI $B$N6g$N0lIt$@$H2r<a$5$l$J$$$h$&$K$9$k$?$a$K6uGr$r(B
    $BF~$l$F$/$@$5$$!#:G=i$N(B <code>&lt;!--#</code> $B$O$^$H$a$F(B<em>$B0l$D(B</em>$B$N(B
    $B6g$G!"6uGr$r$U$/$s$G$O$$$1$J$$$3$HCm0U$7$F$/$@$5$$!#(B</p>

    <p>$BMWAG(B ($BLuCm(B: element) $B$r0J2<$NI=$K<($7$^$9!#(B</p>

    <table border="1">
    <tr><th>$BMWAG(B</th><th>$B@bL@(B</th></tr>
    <tr><td><code><a href="#element.config">config</a></code></td>
        <td>configure output formats</td></tr>
    <tr><td><code><a href="#element.echo">echo</a></code></td>
        <td>print variables</td></tr>
    <tr><td><code><a href="#element.exec">exec</a></code></td>
        <td>execute external programs</td></tr>
    <tr><td><code><a href="#element.fsize">fsize</a></code></td>
        <td>print size of a file</td></tr>
    <tr><td><code><a href="#element.flastmod">flastmod</a></code></td>
        <td>print last modification time of a file</td></tr>
    <tr><td><code><a href="#element.include">include</a></code></td>
        <td>include a file</td></tr>
    <tr><td><code><a href="#element.printenv">printenv</a></code></td>
        <td>print all available variables</td></tr>
    <tr><td><code><a href="#element.set">set</a></code></td>
        <td>set a value of a variable</td></tr>
    </table>

    <p>SSI $BMWAG$O(B <module>mod_include</module> $B0J30$N%b%8%e!<%k$G(B
    $BDj5A$5$l$k$3$H$b$"$j$^$9!#<B:]!"(B
    <code><a href="#element.exec">exec</a></code> $BMWAG$O(B
    <module>mod_cgi</module> $B$GDs6!$5$l$F$$$F!"$3$N%b%8%e!<%k$,(B
    $B%m!<%I$5$l$k>l9g$K$N$_MxMQ2DG=$H$J$j$^$9!#(B</p>

    <section id="element.config"><title>config $BMWAG(B</title>
      <p>$B<!$N%3%^%s%I$O2r@O$NMM!9$JB&LL$r@)8f$7$^$9!#B0@-$O<!$NDL$j$G$9!#(B</p>

      <dl>
      <dt><code>errmsg</code></dt>
      <dd>$B$3$NCM$,!"%I%-%e%a%s%H$N2r@OCf$K%(%i!<$,H/@8$7$?;~$K(B
      $B%/%i%$%"%s%H$KAw?.$5$l$k%a%C%;!<%8$K$J$j$^$9!#$3$l$O(B
      <directive module="mod_include">SSIErrorMsg</directive>
      $B%G%#%l%/%F%#%V$r>e=q$-$7$^$9!#(B</dd>

      <dt><code>sizefmt</code></dt>
      <dd>$B$3$NCM$O!"%U%!%$%k$N%5%$%:$rI=<($9$k:]$K;HMQ$9$k(B
      $B%U%)!<%^%C%H$r@_Dj$7$^$9!#CM$O(B $B%P%$%H%+%&%s%H$N(B
      <code>bytes</code>$B$+!"(BKb $B$d(B Mb $B$rM%@hE*$K;HMQ$9$k(B
      <code>abbrec</code> ($BNc$($P(B 1024 $B%P%$%H$O(B "1K" $B$HI=<($5$l$^$9(B)
      $B$G$9!#(B</dd>

      <dt><code>timefmt</code></dt>
      <dd>$B$3$NCM$O(B <code>strftime(3)</code> $B%i%$%V%i%j%k!<%A%s$,(B
      $BF|;~$r%W%j%s%H$9$k:]$KMQ$$$i$l$^$9!#(B</dd>
      </dl>
    </section> <!-- /config -->

    <section id="element.echo"><title>echo $BMWAG(B</title>
      <p>$B$3$N%3%^%s%I$O0J2<$GDj5A$5$l$F$$$k(B <a href="#includevars">include
      $BJQ?t(B</a> $B$rI=<($7$^$9!#JQ?t$,@_Dj$5$l$F$$$J$$>l9g$O(B <directive 
      module="mod_include">SSIUndefinedEcho</directive> $B%G%#%l%/%F%#%V$G(B
      $B7hDj$5$l$k7k2L$H$J$j$^$9!#F|IU$O$=$N;~E@$G$N(B <code>timefmt</code> $B$K=>$C$F(B
      $BI=<($5$l$^$9!#B0@-$O<!$NDL$j$G$9!#(B</p>

      <dl>
      <dt><code>var</code></dt>
      <dd>$BCM$OI=<($9$kJQ?t$NL>A0$G$9!#(B</dd>

      <dt><code>encoding</code></dt>
      <dd><p>$BJQ?t$r=PNO$9$kA0$K!"JQ?tCf$NFCJLJ8;z$r$I$N$h$&$K%(%s%3!<%I$9$k$+$r(B
      $B;XDj$7$^$9!#(B<code>none</code> $B$K@_Dj$5$l$F$$$k$H!"%(%s%3!<%I$O9T$J$o$l$^$;$s!#(B
      <code>url</code> $B$K@_Dj$5$l$F$$$k$H!"(BURL $B%(%s%3!<%I(B (%-$B%(%s%3!<%I$H$b(B
      $B8F$P$l$F$$$^$9!#$3$l$O%j%s%/Ey$N(B URL $B$N;HMQ$KE,@Z$G$9(B) $B$,(B
      $B9T$J$o$l$^$9!#(B<code>echo</code> $BMWAG$N3+;O;~$O!"%G%U%)%k%H$O(B
      <code>entity</code> $B$K@_Dj$5$l$F$$$^$9!#$3$l$O%(%s%F%#%F%#%(%s%3!<%I(B
      ($BCJMn$d%F%-%9%H$J$I$N%V%m%C%/%l%Y%k$N(B HTML $B%(%l%a%s%H$N%3%s%F%-%9%H$K(B
      $BE,$7$F$$$^$9(B) $B$r9T$J$$$^$9!#$3$l$O(B <code>encoding</code> $BB0@-(B
      $B$r2C$($k$3$H$GJQ99$G$-$^$9!#JQ99$O<!$N(B <code>encoding</code> $BB0@-$+!"(B
      $BMWAG$N=*N;$^$G8zNO$r;}$A$^$9!#(B</p>

      <p><code>encoding</code> $BB0@-$O%(%s%3!<%I$NJQ99$r$7$?$$(B <code>var</code> 
      $B$N(B<em>$BA0$K(B</em> $B$"$kI,MW$,$"$k$3$H$KCm0U$7$F$/$@$5$$!#(B
      $B$^$?!"(BISO-8859-1 $B%(%s%3!<%G%#%s%0$G(B
      $BDj5A$5$l$F$$$kFCJL$JJ8;z$@$1$,%(%s%3!<%I$5$l$^$9!#(B
      $BJL$NJ8;z$N%(%s%3!<%G%#%s%0$N>l9g$O!"$3$N%(%s%3!<%G%#%s%0$O(B
      $BK>$_$N7k2L$K$J$i$J$$$+$b$7$l$^$;$s!#(B</p>

      <note type="warning">
        $B%/%m%9%5%$%H%9%/%j%W%F%#%s%0$NLdBj$rHr$1$k$?$a$K!"(B
        <em>$B>o$K(B</em>$B%f!<%6$+$i$N%G!<%?$r%(%s%3!<%I$9$Y$-$G$9!#(B
      </note>
      </dd>
      </dl>
    </section> <!-- /echo -->

    <section id="element.exec"><title>exec $BMWAG(B</title>
      <p><code>exec</code> $B%3%^%s%I$O;XDj$5$l$?%7%'%k%3%^%s%I$d(B CGI $B%9%/%j%W%H$r(B
      $B<B9T$7$^$9!#(B<module>mod_cgi</module> $B$,%5!<%P$KAH$_9~$^$l$F$$$k$$$J$1$l$P(B
      $B$J$j$^$;$s!#(B<directive module="core">Option</directive> 
      <code>IncludesNOEXEC</code> $B$O$3$N%3%^%s%I$rL58z$K$7$^$9!#(B
      $B;HMQ2DG=$JB0@-$O<!$NDL$j$G$9!#(B</p>

      <dl>
      <dt><code>cgi</code></dt>
      <dd><p>$BCM$O(B (%-$B%(%s%3!<%I$5$l$?(B) URL $B$r;XDj$7$^$9!#%Q%9$,(B
      $B%9%i%C%7%e(B (/) $B$G;O$^$i$J$$$H$-$O!"%I%-%e%a%s%H$+$i$N(B
      $BAjBP%Q%9$H$7$F07$o$l$^$9!#$3$N%Q%9$G;2>H$5$l$F$$$k%I%-%e%a%s%H$O(B
      $B%5!<%P$,(B CGI $B%9%/%j%W%H$H$7$F07$C$F$$$J$/$F$b(B CGI $B%9%/%j%W%H$H$7$F(B
      $B5/F0$5$l$^$9!#$?$@$7!"%9%/%j%W%H$N$"$k%G%#%l%/%H%j$G$O(B
      (<directive module="mod_alias">ScriptAlias</directive>
      $B$d(B <directive module="core">Option</directive> <code>ExecCGI</code>
      $B$K$h$C$F(B) CGI $B%9%/%j%W%H$N;HMQ$,5v2D$5$l$F$$$kI,MW$,$"$j$^$9!#(B</p>

      <p>CGI $B%9%/%j%W%H$K$O!"%/%i%$%"%s%H$+$i$N85!9$N%j%/%(%9%H$N(B
      <code>PATH_INFO</code> $B$H%/%(%j!<J8;zNs(B (<code>QUERY_STRING</code>) $B$,EO$5$l$^$9!#(B
      $B$3$l$i$O(B URL $B%Q%9$H$7$FFCDj(B<em>$B$G$-$J$$(B</em>$B$b$N$G$9!#(B
      $B%9%/%j%W%H$OI8=`(B <a href="mod_cgi.html">CGI</a> $B4D6-$K2C$($F!"(Binclude $BJQ?t$r(B
      $B;HMQ$9$k$3$H$,$G$-$^$9!#(B</p>

      <example><title>$BNc(B</title>
        &lt;!--#exec cgi="/cgi-bin/example.cgi" --&gt;
      </example>

      <p>$B%9%/%j%W%H$,!"=PNO$NBe$o$j$K(B <code>Location:</code> $B%X%C%@$rJV$9$H!"(B
      HTML $B$N%"%s%+!<(B ($BLuCm!'%j%s%/(B) $B$KJQ49$5$l$^$9!#(B</p>

      <p><code>exec cgi</code> $B$h$j$b!"(B
      <code><a href="#includevirtual">include virtual</a></code>
      $B$NJ}$r;H$&$h$&$K$7$F$/$@$5$$!#FC$K!"(BCGI $B$X$NDI2C$N0z?t$r(B
      $B%/%(%j!<J8;zNs$r;H$C$FEO$9$3$H$O(B <code>exec cgi</code> $B$O(B
      $B$G$-$^$;$s$,!"(B<code>include virtual</code> $B$O0J2<$N$h$&$K$7$F(B
      $B2DG=$G$9!#(B</p>

      <example>
        &lt;!--#include virtual="/cgi-bin/example.cgi?argument=value" --&gt;
      </example>
      </dd>

      <dt><code>cmd</code></dt>
      <dd><p>$B%5!<%P$O;XDj$5$l$?J8;zNs$r(B <code>/bin/sh</code> $B$r;H$C$F(B
      $B<B9T$7$^$9!#%3%^%s%I$ODL>o$N(B CGI $BJQ?t$K2C$($F(B <a
      href="#includevars">include $BJQ?t(B</a>$B$b;H$&$3$H$,$G$-$^$9!#(B</p>

      <p>$B$[$H$s$I$N>l9g!"(B<code><a href="#includevirtual">#include 
      virtual</a></code> $B$r;H$&J}$,(B <code>#exec cgi</code> $B$d(B <code>#exec