mod_include.html.ja.euc-jp

来自「apache服务器源代码（版本号：2.2.2）」· EUC-JP 代码 · 共 791 行 · 第 1/4 页

      <dd><p>恃眶を叫蜗する涟に、恃眶面の泼侍矢机をどのようにエンコ〖ドするかを
      回年します。<code>none</code> に肋年されていると、エンコ〖ドは乖なわれません。
      <code>url</code> に肋年されていると、URL エンコ〖ド (%-エンコ〖ドとも
      钙ばれています。これはリンク霹の URL の蝗脱に努磊です) が
      乖なわれます。<code>echo</code> 妥燎の倡幌箕は、デフォルトは
      <code>entity</code> に肋年されています。これはエンティティエンコ〖ド
      (檬皖やテキストなどのブロックレベルの HTML エレメントのコンテキストに
      努しています) を乖ないます。これは <code>encoding</code> 掳拉
      を裁えることで恃构できます。恃构は肌の <code>encoding</code> 掳拉か、
      妥燎の姜位まで跟蜗を积ちます。</p>

      <p><code>encoding</code> 掳拉はエンコ〖ドの恃构をしたい <code>var</code> 
      の<em>涟に</em> ある涩妥があることに庙罢してください。
      また、ISO-8859-1 エンコ〖ディングで
      年盗されている泼侍な矢机だけがエンコ〖ドされます。
      侍の矢机のエンコ〖ディングの眷圭は、このエンコ〖ディングは
      司みの冯蔡にならないかもしれません。</p>

      <div class="warning">
        クロスサイトスクリプティングの啼玛を闰けるために、
        <em>撅に</em>ユ〖ザからのデ〖タをエンコ〖ドすべきです。
      </div>
      </dd>
      </dl>
     

    <h3><a name="element.exec" id="element.exec">exec 妥燎</a></h3>
      <p><code>exec</code> コマンドは回年されたシェルコマンドや CGI スクリプトを
      悸乖します。<code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> がサ〖バに寥み哈まれているいなければ
      なりません。<code class="directive"><a href="../mod/core.html#option">Option</a></code> 
      <code>IncludesNOEXEC</code> はこのコマンドを痰跟にします。
      蝗脱材墙な掳拉は肌の奶りです。</p>

      <dl>
      <dt><code>cgi</code></dt>
      <dd><p>猛は (%-エンコ〖ドされた) URL を回年します。パスが
      スラッシュ (/) で幌まらないときは、ドキュメントからの
      陵滦パスとして胺われます。このパスで徊救されているドキュメントは
      サ〖バが CGI スクリプトとして胺っていなくても CGI スクリプトとして
      弹瓢されます。ただし、スクリプトのあるディレクトリでは
      (<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
      や <code class="directive"><a href="../mod/core.html#option">Option</a></code> <code>ExecCGI</code>
      によって) CGI スクリプトの蝗脱が钓材されている涩妥があります。</p>

      <p>CGI スクリプトには、クライアントからの傅」のリクエストの
      <code>PATH_INFO</code> とクエリ〖矢机误 (<code>QUERY_STRING</code>) が畔されます。
      これらは URL パスとして泼年<em>できない</em>ものです。
      スクリプトは筛洁 <a href="mod_cgi.html">CGI</a> 茨董に裁えて、include 恃眶を
      蝗脱することができます。</p>

      <div class="example"><h3>毋</h3><p><code>
        &lt;!--#exec cgi="/cgi-bin/example.cgi" --&gt;
      </code></p></div>

      <p>スクリプトが、叫蜗の洛わりに <code>Location:</code> ヘッダを手すと、
      HTML のアンカ〖 (条庙¨リンク) に恃垂されます。</p>

      <p><code>exec cgi</code> よりも、
      <code><a href="#includevirtual">include virtual</a></code>
      の数を蝗うようにしてください。泼に、CGI への纳裁の苞眶を
      クエリ〖矢机误を蝗って畔すことは <code>exec cgi</code> は
      できませんが、<code>include virtual</code> は笆布のようにして
      材墙です。</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>