mod_include.html.ja.euc-jp

最新apache的源代码

      材墙です。</p>

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

      <dt><code>cmd</code></dt>
      <dd><p>サ〖バは回年された矢机误を <code>/bin/sh</code> を蝗って
      悸乖します。コマンドは奶撅の CGI 恃眶に裁えて <a href="#includevars">include 恃眶</a>も蝗うことができます。</p>

      <p>ほとんどの眷圭、<code><a href="#includevirtual">#include 
      virtual</a></code> を蝗う数が <code>#exec cgi</code> や <code>#exec
      cmd</code> を蝗うよりも紊いです。涟荚 (<code>#include virtual</code>)
      は筛洁の Apache のサブリクエスト怠菇を蝗ってファイルやスクリプトの
      叫蜗を艰り哈みます。
      こちらの数がよくテストされメンテナンスされた数恕です。</p>

      <p>さらに、Win32 のようないくつかのプラットフォ〖ムや、<a href="../suexec.html">suexec</a> を蝗っている unix では、
      <code>exec</code> ディレクティブのコマンドに
      苞眶を畔したり、コマンドに鄂球を掐れることはできません。
      ですから、笆布のものは unix の suexec でない肋年では瓢侯しますが、
      Win32 や suexec を蝗っている unix では袋略した冯蔡にはなりません:</p>

      <div class="example"><p><code>
        &lt;!--#exec cmd="perl /path/to/perlscript arg1 arg2" --&gt;
      </code></p></div>
      </dd>
      </dl>
     

    <h3><a name="element.fsize" id="element.fsize">fsize 妥燎</a></h3>
      <p>このコマンドは回年されたファイルの络きさを <code>sizefmt</code> の
      今及回年に答づいて叫蜗します。掳拉は肌の奶りです。</p>

      <dl>
      <dt><code>file</code></dt>
      <dd>猛は豺老されているドキュメントの赂哼するディレクトリからの
      陵滦パスです。</dd>

      <dt><code>virtual</code></dt>
      <dd> 猛は (% エンコ〖ドされた) URL-path です。スラッシュ (/) で
      幌まらないときはドキュメントからの陵滦パスとして胺われます。
      CGI の叫蜗のサイズはプリント<em>されません</em>。CGI
      スクリプト极挛のサイズがプリントされることに庙罢してください。</dd>
      </dl>
     

    <h3><a name="element.flastmod" id="element.flastmod">flastmod 妥燎</a></h3>
      <p>このコマンドは回年されたファイルの呵姜饯赖箕癸を
      <code>timefmt</code> 今及回年に骄って山绩します。
      回年材墙な掳拉は <code>fsize</code> コマンドと票じです。</p>
     

    <h3><a name="element.include" id="element.include">include 妥燎</a></h3>
      <p>このコマンドは侍の矢今やファイルのテキストを豺老しているファイルに
      赁掐します。赁掐されるファイルはアクセス扩告の瓷妄布にあります。
      豺老しているファイルの赂哼するディレクトリに
      <a href="core.html#options">Option</a> <code>IncludesNOEXEC</code>
      が肋年されている眷圭、text MIME タイプ (<code>text/plain</code>,
      <code>text/html</code> 霹) のドキュメントのみインクル〖ドが乖なわれます。
      その戮の眷圭は、クエリ〖矢机误も崔め、コマンドで回年された
      窗链な URL を蝗って舍奶に CGI スクリプトが钙び叫されます。</p>

      <p>掳拉が矢今の疤弥を回年します。include コマンドに涂えられたそれぞれの
      掳拉に滦して赁掐侯度が乖なわれます。铜跟な掳拉は肌の奶りです。</p>

      <dl>
      <dt><code>file</code></dt>
      <dd>猛は豺老されているドキュメントの赂哼するディレクトリからの
      陵滦パスです。
      <code>../</code> を崔んでいたり、冷滦パスを回年したりはできません。
      ですから、ドキュメントル〖トの嘲にあるファイルや、ディレクトリ菇陇で
      惧疤にあるファイルを赁掐することはできません。
      撅にこの掳拉よりは、<code>virtual</code> 掳拉を蝗うようにしてください。
      </dd>

      <dt><code><a id="includevirtual" name="includevirtual">virtual</a></code></dt>
      <dd><p>猛は豺老されているドキュメントからの (% エンコ〖ドされた) URL
      です。URL にはスキ〖ムやホスト叹を崔めることはできません。パスと、
      もしあればクエリ〖矢机误を回年できるだけです。スラッシュ (/) から
      幌まらない眷圭は、ドキュメントからの陵滦パスとして胺われます。</p>

      <p>URL は掳拉から侯られ、その URL をクライアントがアクセスしたときに
      叫蜗される柒推が豺老稿の叫蜗に崔められます。ですから、赁掐される
      ファイルは掐れ灰菇陇にすることができます。</p>

      <p>回年された URL が CGI プログラムであった眷圭は、
      プログラムが悸乖され、その叫蜗が豺老しているファイル面の
      ディレクティブがあった疤弥に赁掐されます。CGI の url に
      クエリ〖 URL を掐れることもできます。</p>

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

      <p>HTML ドキュメントに CGI プログラムの叫蜗を崔める数恕としては、
      <code>include virtual</code> の数が <code>exec cgi</code> よりも
      攻ましい数恕です。</p>
      </dd>
      </dl>
     

    <h3><a name="element.printenv" id="element.printenv">printenv 妥燎</a></h3>
      <p>これは、赂哼するすべての恃眶とその猛を山绩します。Apache 1.3.12 から、
      泼侍な矢机は叫蜗される涟にエンティティエンコ〖ド (拒嘿は <a href="#element.echo"><code>echo</code></a> 妥燎を徊救)
      されるようになりました。掳拉はありません。</p>

      <div class="example"><h3>毋</h3><p><code>
        &lt;!--#printenv --&gt;
      </code></p></div>
     

    <h3><a name="element.set" id="element.set">set 妥燎</a></h3>
      <p>これは恃眶の猛を肋年します。掳拉は肌の奶りです。</p>

      <dl>
      <dt><code>var</code></dt>
      <dd>肋年する恃眶の叹涟。</dd>

      <dt><code>value</code></dt>      
      <dd>恃眶に肋年する猛。</dd>
      </dl>

      <div class="example"><h3>毋</h3><p><code>
        &lt;!--#set var="category" value="help" --&gt;
      </code></p></div>
     
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="includevars" id="includevars">Include 恃眶</a></h2>
    

    <p>筛洁 CGI 茨董の恃眶に裁えて、<code>echo</code> コマンドや、
    <code>if</code> や <code>elif</code>, それにドキュメントから钙び叫される
    すべてのプログラムから蝗脱できる恃眶があります。</p>

    <dl>
      <dt><code>DATE_GMT</code></dt>
      <dd>グリニッジ筛洁箕による附哼箕癸。</dd>

      <dt><code>DATE_LOCAL</code></dt>
      <dd>ロ〖カルの筛洁箕による附哼箕癸。</dd>

      <dt><code>DOCUMENT_NAME</code></dt>
      <dd>ユ〖ザがリクエストした (ディレクトリを近いた) ファイル叹。</dd>

      <dt><code>DOCUMENT_URI</code></dt>
      <dd>ユ〖ザがリクエストした (% エンコ〖ドされた) URL-path。
      赁掐ファイルが掐れ灰になっている眷圭は、豺老されている
     ドキュメントの URL では<em>ない</em>ことに庙罢してください。</dd>

      <dt><code>LAST_MODIFIED</code></dt>
      <dd>ユ〖ザがリクエストしたドキュメントの呵姜饯赖箕癸。</dd>

      <dt><code>QUERY_STRING_UNESCAPED</code></dt>
      <dd>クエリ〖矢机误がある眷圭、この恃眶には (%-デコ〖ドされた)
      クエリ〖矢机误が洛掐されていて、shell で蝗脱できるように
      <em>エスケ〖プ</em>されています (<code>&amp;</code>
      といった泼检矢机にはバックスラッシュが木涟に弥かれます)。</dd>
    </dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="substitution" id="substitution">恃眶弥垂</a></h2>

    <p>恃眶弥垂はたいていの眷圭 SSI ディレクティブの苞眶として屡碰な眷疥にある
    苞脱射で跋まれた矢机误面で乖なわれます。これに澈碰するものには、
    <code>config</code>,
    <code>exec</code>, <code>flastmod</code>, <code>fsize</code>,
    <code>include</code>, <code>echo</code>, <code>set</code> の
    称ディレクティブと、掘凤尸呆脱のオペレ〖タへの苞眶があります。
    ドル淡规はバックスラッシュを蝗うことで蝗うことができます:</p>

    <div class="example"><p><code>
      &lt;!--#if expr="$a = \$test" --&gt;
    </code></p></div>

    <p>恃眶叹としてみなされる矢机误の面で恃眶への徊救を弥垂する涩妥があるときは、
    シェルでの恃眶弥垂のように、面崇柑で崇ることで惰侍することができます:</p>

    <div class="example"><p><code>
      &lt;!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" --&gt;
    </code></p></div>

    <p>この毋では、<code>REMOTE_HOST</code> が
    "<code>X</code>" で <code>REQUEST_METHOD</code> が
    "<code>Y</code>" のときに恃眶 <code>Zed</code> を "<code>X_Y</code>"
    に肋年します。</p>

    <p>笆布の毋では、<code>DOCUMENT_URI</code> が <code>/foo/file.html</code>
    のときに "in foo" を、<code>/bar/file.html</code> のときに "in bar" を、
    どちらでもないときには "in neither" を山绩します。</p>

    <div class="example"><p><code>
      &lt;!--#if expr='"$DOCUMENT_URI" = "/foo/file.html"' --&gt;<br />
      <span class="indent">
        in foo<br />
      </span>
      &lt;!--#elif expr='"$DOCUMENT_URI" = "/bar/file.html"' --&gt;<br />
      <span class="indent">
        in bar<br />
      </span>
      &lt;!--#else --&gt;<br />
      <span class="indent">
        in neither<br />
      </span>
      &lt;!--#endif --&gt;
    </code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flowctrl" id="flowctrl">フロ〖扩告妥燎</a></h2>
    

    <p>答塑弄なフロ〖コントロ〖ル妥燎は肌の奶りです。</p>

    <div class="example"><p><code>
      &lt;!--#if expr="<var>test_condition</var>" --&gt;<br />
      &lt;!--#elif expr="<var>test_condition</var>" --&gt;<br />
      &lt;!--#else --&gt;<br />
      &lt;!--#endif --&gt;
    </code></p></div>

    <p><code>if</code> 妥燎はプログラミング咐胳の
    if 矢と票じように瓢侯します。掘凤が删擦され、冯蔡が靠であれば肌の
    <code>elif</code> か <code>else</code> か <code>endif</code>
    妥燎までの矢机误が叫蜗に赁掐されます。</p>

    <p><code>elif</code> や <code>else</code> 矢は <var>test_condition</var> 
    が刀のときにテキストを叫蜗に赁掐するために蝗われます。
    これらの妥燎はあってもなくても菇いません。</p>

    <p><code>endif</code> 妥燎は <code>if</code>
    妥燎を姜位させます。この妥燎は涩寇です。</p>

    <p><var>test_condition</var> は笆布のどれかです:</p>

    <dl>
      <dt><code><var>string</var></code></dt>
      <dd><var>string</var> が鄂でない眷圭に靠です</dd>

      <dt><code><var>string1</var> = <var>string2</var><br />
      <var>string1</var> == <var>string2</var><br />
      <var>string1</var> != <var>string2</var></code></dt>

      <dd><p><var>string1</var> と <var>string2</var> を孺秤します。
      <var>string2</var> が <code>/<var>string</var>/</code>
      という妨及であれば、赖惮山附として孺秤されます。赖惮山附は
      <a href="http://www.pcre.org">PCRE</a> エンジンで悸刘されていて、
      <a href="http://www.perl.com">perl 5</a> と票じ菇矢を蝗脱します。
      <code>==</code> は帽に <code>=</code> の侍叹で、まったく票じ瓢侯を
      します。</p>

      <p>赖のマッチング (<code>=</code> または <code>==</code>) の眷圭は、
      赖惮山附でグル〖プ尸けされたパ〖ツをキャプチャすることができます。