1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
4        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5              This file is generated from xml source: DO NOT EDIT
6        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7      -->
8<title>mod_include - Apache HTTP サーバ</title>
9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
12<script src="/style/scripts/prettify.js" type="text/javascript">
13</script>
14
15<link href="/images/favicon.ico" rel="shortcut icon" /></head>
16<body>
17<div id="page-header">
18<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p>
19<p class="apache">Apache HTTP サーバ バージョン 2.2</p>
20<img alt="" src="/images/feather.gif" /></div>
21<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
22<div id="path">
23<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン 2.2</a> &gt; <a href="./">モジュール</a></div>
24<div id="page-content">
25<div id="preamble"><h1>Apache モジュール mod_include</h1>
26<div class="toplang">
27<p><span>翻訳済み言語: </span><a href="/en/mod/mod_include.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
28<a href="/ja/mod/mod_include.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
29</div>
30<div class="outofdate">この日本語訳はすでに古くなっている
31            可能性があります。
32            最近更新された内容を見るには英語版をご覧下さい。
33        </div>
34<table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>サーバがパースする html ドキュメント (Server Side Includes)</td></tr>
35<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
36<tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>include_module</td></tr>
37<tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_include.c</td></tr>
38<tr><th><a href="module-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 から出力フィルタとして実装されました。</td></tr></table>
39<h3>概要</h3>
40
41    <p>このモジュールはファイルがクライアントに送られる前に処理するフィルタを
42    提供します。処理の内容は<dfn>要素</dfn>と呼ばれる特別な形式の SGML コメントにより
43    制御されます。これらの要素は条件分岐や、他のファイルや
44    プログラムの出力の取り込み、環境変数の設定や表示を行なうことが
45    できます。</p>
46</div>
47<div id="quickview"><h3 class="directives">ディレクティブ</h3>
48<ul id="toc">
49<li><img alt="" src="/images/down.gif" /> <a href="#ssienableaccess">SSIEnableAccess</a></li>
50<li><img alt="" src="/images/down.gif" /> <a href="#ssiendtag">SSIEndTag</a></li>
51<li><img alt="" src="/images/down.gif" /> <a href="#ssierrormsg">SSIErrorMsg</a></li>
52<li><img alt="" src="/images/down.gif" /> <a href="#ssietag">SSIETag</a></li>
53<li><img alt="" src="/images/down.gif" /> <a href="#ssilastmodified">SSILastModified</a></li>
54<li><img alt="" src="/images/down.gif" /> <a href="#ssistarttag">SSIStartTag</a></li>
55<li><img alt="" src="/images/down.gif" /> <a href="#ssitimeformat">SSITimeFormat</a></li>
56<li><img alt="" src="/images/down.gif" /> <a href="#ssiundefinedecho">SSIUndefinedEcho</a></li>
57<li><img alt="" src="/images/down.gif" /> <a href="#xbithack">XBitHack</a></li>
58</ul>
59<h3>トピック</h3>
60<ul id="topics">
61<li><img alt="" src="/images/down.gif" /> <a href="#enabling">Server-Side Includes を有効にする</a></li>
62<li><img alt="" src="/images/down.gif" /> <a href="#pathinfo">サーバサイドインクルード (SSI) での PATH_INFO</a></li>
63<li><img alt="" src="/images/down.gif" /> <a href="#elements">基本要素</a></li>
64<li><img alt="" src="/images/down.gif" /> <a href="#includevars">Include 変数</a></li>
65<li><img alt="" src="/images/down.gif" /> <a href="#substitution">変数置換</a></li>
66<li><img alt="" src="/images/down.gif" /> <a href="#flowctrl">フロー制御要素</a></li>
67</ul><h3>参照</h3>
68<ul class="seealso">
69<li><code class="directive"><a href="/mod/core.html#options">Options</a></code></li>
70<li><code class="directive"><a href="/mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li>
71<li><a href="/filter.html">フィルタ</a></li>
72<li><a href="/howto/ssi.html">SSI チュートリアル</a></li>
73</ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div>
74<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
75<div class="section">
76<h2><a name="enabling" id="enabling">Server-Side Includes を有効にする</a></h2>
77    
78
79    <p>Server Side Includes は <code>INCLUDES</code>
80    <a href="/filter.html">フィルタ</a> により実装されています。
81    Server-side include のディレクティブを含むドキュメントの拡張子が
82    .shtml の場合、以下のディレクティブでは Apache がそれらを
83    パースして、その結果できるドキュメントに <code>text/html</code> の
84    MIME タイプを割り当てます:</p>
85
86    <div class="example"><p><code>
87      AddType text/html .shtml<br />
88      AddOutputFilter INCLUDES .shtml
89    </code></p></div>
90
91    <p>以下のディレクティブは shtml ファイルのあるディレクトリで指定されている
92    必要があります (通常は <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> セクションで指定しますが、
93    <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> <code>Options</code>
94    が設定されていると、<code>.htaccess</code> ファイルに書くこともできます):</p>
95
96    <div class="example"><p><code>
97      Options +Includes
98    </code></p></div>
99
100    <p>互換性を保つために、<code>server-parsed</code>
101    <a href="/handler.html">ハンドラ</a> も INCLUDES フィルタを
102    有効にします。MIME タイプ <code>text/x-server-parsed-html</code> や
103    <code>text/x-server-parsed-html3</code> のドキュメントに対しても
104    Apache は INCLUDES フィルタを有効にします (出力されるものは
105    MIME タイプ <code>text/html</code> になります)。</p>
106
107    <p>詳しい情報は <a href="/howto/ssi.html">Server Side Includes チュートリアル</a>を参照してください。</p>
108</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
109<div class="section">
110<h2><a name="pathinfo" id="pathinfo">サーバサイドインクルード (SSI) での PATH_INFO</a></h2>
111    
112
113    <p>SSI で処理されるファイルはデフォルトでは <code>PATH_INFO</code>
114    (後続のパス名情報)
115    付きのリクエストを受け入れなくなりました。<code class="directive"><a href="/mod/core.html#acceptpathinfo">AcceptPathInfo</a></code> ディレクティブで
116    <code>PATH_INFO</code> 付きのリクエストを受け入れるようにサーバを
117    設定できます。</p>
118</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
119<div class="section">
120<h2><a name="elements" id="elements">基本要素</a></h2>
121    <p>ドキュメントは、SGML のコメントとして特別なコマンドが埋め込まれた
122    HTML ドキュメントとしてパースされます。コマンドの構文は次のように
123    なっています:</p>
124
125    <div class="example"><p><code>
126      &lt;!--#<var>element</var> <var>attribute</var>=<var>value</var>
127      <var>attribute</var>=<var>value</var> ... --&gt;
128    </code></p></div>
129
130    <p>値 (訳注: value) は二重引用符で囲むのが一般的ですが、
131    シングルクオート (') とバッククオート (`) も使用できます。
132    多くのコマンドは属性-値 (訳注: attribute-value) の組を一つだけ指定できます。
133    コメントの終わり (<code>--&gt;</code>)
134    の前には、SSI の句の一部だと解釈されないようにするために空白を
135    入れてください。最初の <code>&lt;!--#</code> はまとめて<em>一つ</em>の
136    句で、空白をふくんではいけないこと注意してください。</p>
137
138    <p>要素 (訳注: element) を以下の表に示します。</p>
139
140    <table class="bordered">
141    <tr><th>要素</th><th>説明</th></tr>
142    <tr><td><code><a href="#element.config">config</a></code></td>
143        <td>configure output formats</td></tr>
144    <tr><td><code><a href="#element.echo">echo</a></code></td>
145        <td>print variables</td></tr>
146    <tr><td><code><a href="#element.exec">exec</a></code></td>
147        <td>execute external programs</td></tr>
148    <tr><td><code><a href="#element.fsize">fsize</a></code></td>
149        <td>print size of a file</td></tr>
150    <tr><td><code><a href="#element.flastmod">flastmod</a></code></td>
151        <td>print last modification time of a file</td></tr>
152    <tr><td><code><a href="#element.include">include</a></code></td>
153        <td>include a file</td></tr>
154    <tr><td><code><a href="#element.printenv">printenv</a></code></td>
155        <td>print all available variables</td></tr>
156    <tr><td><code><a href="#element.set">set</a></code></td>
157        <td>set a value of a variable</td></tr>
158    </table>
159
160    <p>SSI 要素は <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> 以外のモジュールで
161    定義されることもあります。実際、
162    <code><a href="#element.exec">exec</a></code> 要素は
163    <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> で提供されていて、このモジュールが
164    ロードされる場合にのみ利用可能となります。</p>
165
166    <h3><a name="element.config" id="element.config">config 要素</a></h3>
167      <p>次のコマンドは解析の様々な側面を制御します。属性は次の通りです。</p>
168
169      <dl>
170      <dt><code>echomsg</code> (<em>Apache 2.1 以降</em>)</dt>
171      <dd>指定される値は、<code><a href="#element.echo">echo</a></code>
172      要素が未定義の変数をエコーしようとした際に、
173      クライアントに送られるメッセージになります。
174      <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code> 
175      ディレクティブを上書きします。</dd>
176
177      <dt><code>errmsg</code></dt>
178      <dd>この値が、ドキュメントの解析中にエラーが発生した時に
179      クライアントに送信されるメッセージになります。
180      <code class="directive"><a href="#ssierrormsg">SSIErrorMsg</a></code>
181      ディレクティブを上書きします。</dd>
182
183      <dt><code>sizefmt</code></dt>
184      <dd>この値は、ファイルのサイズを表示する際に使用する
185      フォーマットを設定します。値は バイトカウントの
186      <code>bytes</code>か、Kb や Mb を優先的に使用する
187      <code>abbrec</code> (例えば 1024 バイトは "1K" と表示されます)
188      です。</dd>
189
190      <dt><code>timefmt</code></dt>
191      <dd>この値は <code>strftime(3)</code> ライブラリルーチンが
192      日時をプリントする際に用いられます。</dd>
193      </dl>
194     
195
196    <h3><a name="element.echo" id="element.echo">echo 要素</a></h3>
197      <p>このコマンドは以下で定義されている <a href="#includevars">include
198      変数</a> を表示します。変数が設定されていない場合は <code class="directive"><a href="#ssiundefinedecho">SSIUndefinedEcho</a></code> ディレクティブで
199      決定される結果となります。日付はその時点での <code>timefmt</code> に従って
200      表示されます。属性は次の通りです。</p>
201
202      <dl>
203      <dt><code>var</code></dt>
204      <dd>値は表示する変数の名前です。</dd>
205
206      <dt><code>encoding</code></dt>
207      <dd><p>変数を出力する前に、変数中の特別文字をどのようにエンコードするかを
208      指定します。<code>none</code> に設定されていると、エンコードは行なわれません。
209      <code>url</code> に設定されていると、URL エンコード (%-エンコードとも
210      呼ばれています。これはリンク等の URL の使用に適切です) が
211      行なわれます。<code>echo</code> 要素の開始時は、デフォルトは
212      <code>entity</code> に設定されています。これはエンティティエンコード
213      (段落やテキストなどのブロックレベルの HTML エレメントのコンテキストに
214      適しています) を行ないます。これは <code>encoding</code> 属性
215      を加えることで変更できます。変更は次の <code>encoding</code> 属性か、
216      要素の終了まで効力を持ちます。</p>
217
218      <p><code>encoding</code> 属性はエンコードの変更をしたい <code>var</code> 
219      の<em>前に</em> ある必要があることに注意してください。
220      また、ISO-8859-1 エンコーディングで
221      定義されている特別な文字だけがエンコードされます。
222      別の文字のエンコーディングの場合は、このエンコーディングは
223      望みの結果にならないかもしれません。</p>
224
225      <div class="warning">
226        クロスサイトスクリプティングの問題を避けるために、
227        <em>常に</em>ユーザからのデータをエンコードすべきです。
228      </div>
229      </dd>
230      </dl>
231     
232
233    <h3><a name="element.exec" id="element.exec">exec 要素</a></h3>
234      <p><code>exec</code> コマンドは指定されたシェルコマンドや CGI スクリプトを
235      実行します。<code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> がサーバに組み込まれているいなければ
236      なりません。<code class="directive"><a href="/mod/core.html#options">Options</a></code> 
237      <code>IncludesNOEXEC</code> はこのコマンドを無効にします。
238      使用可能な属性は次の通りです。</p>
239
240      <dl>
241      <dt><code>cgi</code></dt>
242      <dd><p>値は (%-エンコードされた) URL を指定します。パスが
243      スラッシュ (/) で始まらないときは、ドキュメントからの
244      相対パスとして扱われます。このパスで参照されているドキュメントは
245      サーバが CGI スクリプトとして扱っていなくても CGI スクリプトとして
246      起動されます。ただし、スクリプトのあるディレクトリでは
247      (<code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
248      や <code class="directive"><a href="/mod/core.html#options">Options</a></code> <code>ExecCGI</code>
249      によって) CGI スクリプトの使用が許可されている必要があります。</p>
250
251      <p>CGI スクリプトには、クライアントからの元々のリクエストの
252      <code>PATH_INFO</code> とクエリー文字列 (<code>QUERY_STRING</code>) が渡されます。
253      これらは URL パスとして特定<em>できない</em>ものです。
254      スクリプトは標準 <a href="mod_cgi.html">CGI</a> 環境に加えて、include 変数を
255      使用することができます。</p>
256
257      <div class="example"><h3>例</h3><p><code>
258        &lt;!--#exec cgi="/cgi-bin/example.cgi" --&gt;
259      </code></p></div>
260
261      <p>スクリプトが、出力の代わりに <code>Location:</code> ヘッダを返すと、
262      HTML のアンカー (訳注:リンク) に変換されます。</p>
263
264      <p><code>exec cgi</code> よりも、
265      <code><a href="#includevirtual">include virtual</a></code>
266      の方を使うようにしてください。特に、CGI への追加の引数を
267      クエリー文字列を使って渡すことは <code>exec cgi</code> は
268      できませんが、<code>include virtual</code> は以下のようにして
269      可能です。</p>
270
271      <div class="example"><p><code>
272        &lt;!--#include virtual="/cgi-bin/example.cgi?argument=value" --&gt;
273      </code></p></div>
274      </dd>
275
276      <dt><code>cmd</code></dt>
277      <dd><p>サーバは指定された文字列を <code>/bin/sh</code> を使って
278      実行します。コマンドは通常の CGI 変数に加えて <a href="#includevars">include 変数</a>も使うことができます。</p>
279
280      <p>ほとんどの場合、<code><a href="#includevirtual">#include 
281      virtual</a></code> を使う方が <code>#exec cgi</code> や <code>#exec
282      cmd</code> を使うよりも良いです。前者 (<code>#include virtual</code>)
283      は標準の Apache のサブリクエスト機構を使ってファイルやスクリプトの
284      出力を取り込みます。
285      こちらの方がよくテストされメンテナンスされた方法です。</p>
286
287      <p>さらに、Win32 のようないくつかのプラットフォームや、<a href="/suexec.html">suexec</a> を使っている unix では、
288      <code>exec</code> ディレクティブのコマンドに
289      引数を渡したり、コマンドに空白を入れることはできません。
290      ですから、以下のものは unix の suexec でない設定では動作しますが、
291      Win32 や suexec を使っている unix では期待した結果にはなりません:</p>
292
293      <div class="example"><p><code>
294        &lt;!--#exec cmd="perl /path/to/perlscript arg1 arg2" --&gt;
295      </code></p></div>
296      </dd>
297      </dl>
298     
299
300    <h3><a name="element.fsize" id="element.fsize">fsize 要素</a></h3>
301      <p>このコマンドは指定されたファイルの大きさを <code>sizefmt</code> の
302      書式指定に基づいて出力します。属性は次の通りです。</p>
303
304      <dl>
305      <dt><code>file</code></dt>
306      <dd>値は解析されているドキュメントの存在するディレクトリからの
307      相対パスです。</dd>
308
309      <dt><code>virtual</code></dt>
310      <dd> 値は (% エンコードされた) URL-path です。スラッシュ (/) で
311      始まらないときはドキュメントからの相対パスとして扱われます。
312      CGI の出力のサイズはプリント<em>されません</em>。CGI
313      スクリプト自体のサイズがプリントされることに注意してください。</dd>
314      </dl>
315     
316
317    <h3><a name="element.flastmod" id="element.flastmod">flastmod 要素</a></h3>
318      <p>このコマンドは指定されたファイルの最終修正時刻を
319      <code>timefmt</code> 書式指定に従って表示します。
320      指定可能な属性は <code>fsize</code> コマンドと同じです。</p>
321     
322
323    <h3><a name="element.include" id="element.include">include 要素</a></h3>
324      <p>このコマンドは別の文書やファイルのテキストを解析しているファイルに
325      挿入します。挿入されるファイルはアクセス制御の管理下にあります。
326      解析しているファイルの存在するディレクトリに
327      <a href="core.html#options">Options</a> <code>IncludesNOEXEC</code>
328      が設定されている場合、text MIME タイプ (<code>text/plain</code>,
329      <code>text/html</code> 等) のドキュメントのみインクルードが行なわれます。
330      その他の場合は、クエリー文字列も含め、コマンドで指定された
331      完全な URL を使って普通に CGI スクリプトが呼び出されます。</p>
332
333      <p>属性が文書の位置を指定します。include コマンドに与えられたそれぞれの
334      属性に対して挿入作業が行なわれます。有効な属性は次の通りです。</p>
335
336      <dl>
337      <dt><code>file</code></dt>
338      <dd>値は解析されているドキュメントの存在するディレクトリからの
339      相対パスです。
340      <code>../</code> を含んでいたり、絶対パスを指定したりはできません。
341      ですから、ドキュメントルートの外にあるファイルや、ディレクトリ構造で
342      上位にあるファイルを挿入することはできません。
343      常にこの属性よりは、<code>virtual</code> 属性を使うようにしてください。
344      </dd>
345
346      <dt><code><a id="includevirtual" name="includevirtual">virtual</a></code></dt>
347      <dd><p>値は解析されているドキュメントからの (% エンコードされた) URL
348      です。URL にはスキームやホスト名を含めることはできません。パスと、
349      もしあればクエリー文字列を指定できるだけです。スラッシュ (/) から
350      始まらない場合は、ドキュメントからの相対パスとして扱われます。</p>
351
352      <p>URL は属性から作られ、その URL をクライアントがアクセスしたときに
353      出力される内容が解析後の出力に含められます。ですから、挿入される
354      ファイルは入れ子構造にすることができます。</p>
355
356      <p>指定された URL が CGI プログラムであった場合は、
357      プログラムが実行され、その出力が解析しているファイル中の
358      ディレクティブがあった位置に挿入されます。CGI の url に
359      クエリー URL を入れることもできます。</p>
360
361      <div class="example"><p><code>
362        &lt;!--#include virtual="/cgi-bin/example.cgi?argument=value" --&gt;
363      </code></p></div>
364
365      <p>HTML ドキュメントに CGI プログラムの出力を含める方法としては、
366      <code>include virtual</code> の方が <code>exec cgi</code> よりも
367      好ましい方法です。</p>
368      </dd>
369      </dl>
370     
371
372    <h3><a name="element.printenv" id="element.printenv">printenv 要素</a></h3>
373      <p>これは、存在するすべての変数とその値を表示します。Apache 1.3.12 から、
374      特別な文字は出力される前にエンティティエンコード (詳細は <a href="#element.echo"><code>echo</code></a> 要素を参照)
375      されるようになりました。属性はありません。</p>
376
377      <div class="example"><h3>例</h3><p><code>
378        &lt;!--#printenv --&gt;
379      </code></p></div>
380     
381
382    <h3><a name="element.set" id="element.set">set 要素</a></h3>
383      <p>これは変数の値を設定します。属性は次の通りです。</p>
384
385      <dl>
386      <dt><code>var</code></dt>
387      <dd>設定する変数の名前。</dd>
388
389      <dt><code>value</code></dt>      
390      <dd>変数に設定する値。</dd>
391      </dl>
392
393      <div class="example"><h3>例</h3><p><code>
394        &lt;!--#set var="category" value="help" --&gt;
395      </code></p></div>
396     
397</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
398<div class="section">
399<h2><a name="includevars" id="includevars">Include 変数</a></h2>
400    
401
402    <p>標準 CGI 環境の変数に加えて、<code>echo</code> コマンドや、
403    <code>if</code> や <code>elif</code>, それにドキュメントから呼び出される
404    すべてのプログラムから使用できる変数があります。</p>
405
406    <dl>
407      <dt><code>DATE_GMT</code></dt>
408      <dd>グリニッジ標準時による現在時刻。</dd>
409
410      <dt><code>DATE_LOCAL</code></dt>
411      <dd>ローカルの標準時による現在時刻。</dd>
412
413      <dt><code>DOCUMENT_NAME</code></dt>
414      <dd>ユーザがリクエストした (ディレクトリを除いた) ファイル名。</dd>
415
416      <dt><code>DOCUMENT_URI</code></dt>
417      <dd>ユーザがリクエストした (% エンコードされた) URL-path。
418      挿入ファイルが入れ子になっている場合は、解析されている
419     ドキュメントの URL では<em>ない</em>ことに注意してください。</dd>
420
421      <dt><code>LAST_MODIFIED</code></dt>
422      <dd>ユーザがリクエストしたドキュメントの最終修正時刻。</dd>
423
424      <dt><code>QUERY_STRING_UNESCAPED</code></dt>
425      <dd>クエリー文字列がある場合、この変数には (%-デコードされた)
426      クエリー文字列が代入されていて、shell で使用できるように
427      <em>エスケープ</em>されています (<code>&amp;</code>
428      といった特殊文字にはバックスラッシュが直前に置かれます)。</dd>
429    </dl>
430</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
431<div class="section">
432<h2><a name="substitution" id="substitution">変数置換</a></h2>
433
434    <p>変数置換はたいていの場合 SSI ディレクティブの引数として妥当な場所にある
435    引用符で囲まれた文字列中で行なわれます。これに該当するものには、
436    <code>config</code>,
437    <code>exec</code>, <code>flastmod</code>, <code>fsize</code>,
438    <code>include</code>, <code>echo</code>, <code>set</code> の
439    各ディレクティブと、条件分岐用のオペレータへの引数があります。
440    ドル記号はバックスラッシュを使うことで使うことができます:</p>
441
442    <div class="example"><p><code>
443      &lt;!--#if expr="$a = \$test" --&gt;
444    </code></p></div>
445
446    <p>変数名としてみなされる文字列の中で変数への参照を置換する必要があるときは、
447    シェルでの変数置換のように、中括弧で括ることで区別することができます:</p>
448
449    <div class="example"><p><code>
450      &lt;!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" --&gt;
451    </code></p></div>
452
453    <p>この例では、<code>REMOTE_HOST</code> が
454    "<code>X</code>" で <code>REQUEST_METHOD</code> が
455    "<code>Y</code>" のときに変数 <code>Zed</code> を "<code>X_Y</code>"
456    に設定します。</p>
457
458    <p>以下の例では、<code>DOCUMENT_URI</code> が <code>/foo/file.html</code>
459    のときに "in foo" を、<code>/bar/file.html</code> のときに "in bar" を、
460    どちらでもないときには "in neither" を表示します。</p>
461
462    <div class="example"><p><code>
463      &lt;!--#if expr='"$DOCUMENT_URI" = "/foo/file.html"' --&gt;<br />
464      <span class="indent">
465        in foo<br />
466      </span>
467      &lt;!--#elif expr='"$DOCUMENT_URI" = "/bar/file.html"' --&gt;<br />
468      <span class="indent">
469        in bar<br />
470      </span>
471      &lt;!--#else --&gt;<br />
472      <span class="indent">
473        in neither<br />
474      </span>
475      &lt;!--#endif --&gt;
476    </code></p></div>
477</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
478<div class="section">
479<h2><a name="flowctrl" id="flowctrl">フロー制御要素</a></h2>
480    
481
482    <p>基本的なフローコントロール要素は次の通りです。</p>
483
484    <div class="example"><p><code>
485      &lt;!--#if expr="<var>test_condition</var>" --&gt;<br />
486      &lt;!--#elif expr="<var>test_condition</var>" --&gt;<br />
487      &lt;!--#else --&gt;<br />
488      &lt;!--#endif --&gt;
489    </code></p></div>
490
491    <p><code>if</code> 要素はプログラミング言語の
492    if 文と同じように動作します。条件が評価され、結果が真であれば次の
493    <code>elif</code> か <code>else</code> か <code>endif</code>
494    要素までの文字列が出力に挿入されます。</p>
495
496    <p><code>elif</code> や <code>else</code> 文は <var>test_condition</var> 
497    が偽のときにテキストを出力に挿入するために使われます。
498    これらの要素はあってもなくても構いません。</p>
499
500    <p><code>endif</code> 要素は <code>if</code>
501    要素を終了させます。この要素は必須です。</p>
502
503    <p><var>test_condition</var> は以下のどれかです:</p>
504
505    <dl>
506      <dt><code><var>string</var></code></dt>
507      <dd><var>string</var> が空でない場合に真です</dd>
508
509      <dt><code><var>string1</var> = <var>string2</var><br />
510      <var>string1</var> == <var>string2</var><br />
511      <var>string1</var> != <var>string2</var></code></dt>
512
513      <dd><p><var>string1</var> と <var>string2</var> を比較します。
514      <var>string2</var> が <code>/<var>string</var>/</code>
515      という形式であれば、正規表現として比較されます。正規表現は
516      <a href="http://www.pcre.org">PCRE</a> エンジンで実装されていて、
517      <a href="http://www.perl.com">perl 5</a> と同じ構文を使用します。
518      <code>==</code> は単に <code>=</code> の別名で、まったく同じ動作を
519      します。</p>
520
521      <p>正のマッチング (<code>=</code> または <code>==</code>) の場合は、
522      正規表現でグループ分けされたパーツをキャプチャすることができます。
523      キャプチャされた部分は特殊変数 <code>$1</code> .. <code>$9</code>
524      に格納されます。</p>
525
526      <div class="example"><h3>例</h3><p><code>
527        &lt;!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" --&gt;<br />
528        <span class="indent">
529          &lt;!--#set var="session" value="$1" --&gt;<br />
530        </span>
531        &lt;!--#endif --&gt;
532      </code></p></div>
533      </dd>
534
535      <dt><code><var>string1</var> &lt; <var>string2</var><br />
536       <var>string1</var> &lt;= <var>string2</var><br />
537       <var>string1</var> &gt; <var>string2</var><br />
538       <var>string1</var> &gt;= <var>string2</var></code></dt>
539
540      <dd><var>string1</var> と <var>string2</var> を比較します。
541      <em>文字列として</em>比較される (<code>strcmp(3)</code> を使用)
542      ことに注意してください。ですから、文字列 "100" は "20" 
543      よりも小さいことになります。</dd>
544
545      <dt><code>( <var>test_condition</var> )</code></dt>
546      <dd><var>test_condition</var> が真のとき、真</dd>
547
548      <dt><code>! <var>test_condition</var></code></dt>
549      <dd><var>test_condition</var> が偽のとき、真</dd>
550
551      <dt><code><var>test_condition1</var> &amp;&amp;
552        <var>test_condition2</var></code></dt>
553      <dd><var>test_condition1</var> かつ
554      <var>test_condition2</var> が真のとき、真</dd>
555
556      <dt><code><var>test_condition1</var> ||
557        <var>test_condition2</var></code></dt>
558      <dd><var>test_condition1</var> または
559      <var>test_condition2</var> が真のとき、真</dd>
560    </dl>
561
562    <p>"<em>=</em>" と "<em>!=</em>" の方が "<em>&amp;&amp;</em>" より
563    きつく束縛します。"<em>!</em>" の束縛が一番きつくなっています。
564    ですから以下の二つは等価です:</p>
565
566    <div class="example"><p><code>
567      &lt;!--#if expr="$a = test1 &amp;&amp; $b = test2" --&gt;<br />
568      &lt;!--#if expr="($a = test1) &amp;&amp; ($b = test2)" --&gt;
569    </code></p></div>
570
571    <p>真偽値オペレータ <code>&amp;&amp;</code> と <code>||</code>
572    は同じ優先度です。
573    これらのオペレータで一方により強い優先度をつけたい場合には、
574    括弧を使う必要があります。</p>
575
576    <p>変数やオペレータとして認識されないものはすべて文字列として
577    扱われます。文字列は引用符で囲むこともできます: <code>'string'</code>
578    のように。引用符で囲まれていない文字列には空白 (スペースとタブ)
579    を含めることはできません。それらは変数などの句を分離するために
580    使われているからです。複数の文字列が続いているときは、
581    空白を間に入れて一つにくっつけられます。ですから、</p>
582
583    <div class="example"><p><code><var>string1</var>&nbsp;&nbsp;&nbsp;&nbsp;<var>string2</var></code> は <code><var>string1</var>&nbsp;<var>string2</var></code> になります。<br />
584      <br />
585      また、<br />
586      <br />
587      <code>'<var>string1</var>&nbsp;&nbsp;&nbsp;&nbsp;<var>string2</var>'</code> は <code><var>string1</var>&nbsp;&nbsp;&nbsp;&nbsp;<var>string2</var></code>
588      になります。</p></div>
589
590    <div class="note"><h3>真偽値表現の最適化</h3>
591      <p>式がもっと複雑になり、処理の速度低下が顕著になった場合は、
592      評価ルールに従って最適化してみると良いでしょう。</p>
593      <ul>
594      <li>評価は左から右に向かって行われます。</li>
595      <li>二値真偽値オペレータ (<code>&amp;&amp;</code> と <code>||</code>)
596          は、出来る限り短絡評価されます。つまり結果として上記のルールは、
597          <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> が左の評価式を評価します。
598          左側で結果を十分決定できる場合は、評価はそこで停止します。
599          そうでない場合は右側を評価して、左と右の両方から結果を計算します。</li>
600      <li>短絡評価は評価の対象に正規表現が含まれる場合、オフになります。
601          後方参照する変数 (<code>$1</code> .. <code>$9</code>) 
602          を埋めるために、実際に評価する必要があるからです。</li>
603      </ul>
604      <p>特定の式がどのように扱われるかを知りたい場合は、
605      <code>-DDEBUG_INCLUDE</code> コンパイラオプションを付けて
606      <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> をリコンパイルすると良いでしょう。
607      これにより、全てのパースされた式に対して、字句解析情報、
608      パースツリーと、
609      それがどのようにクライアントに送られた出力まで評価されたかを
610      挿入します。</p>
611    </div>
612</div>
613<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
614<div class="directive-section"><h2><a name="SSIEnableAccess" id="SSIEnableAccess">SSIEnableAccess</a> <a name="ssienableaccess" id="ssienableaccess">ディレクティブ</a></h2>
615<table class="directive">
616<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Enable the -A flag during conditional flow control processing.</td></tr>
617<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSIEnableAccess on|off</code></td></tr>
618<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSIEnableAccess off</code></td></tr>
619<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
620<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
621<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
622</table><p>このディレクティブの解説文書は
623            まだ翻訳されていません。英語版をご覧ください。
624            </p></div>
625<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
626<div class="directive-section"><h2><a name="SSIEndTag" id="SSIEndTag">SSIEndTag</a> <a name="ssiendtag" id="ssiendtag">ディレクティブ</a></h2>
627<table class="directive">
628<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>include 要素を終了させる文字列</td></tr>
629<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSIEndTag <var>tag</var></code></td></tr>
630<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSIEndTag "--&gt;"</code></td></tr>
631<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
632<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
633<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
634<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.0.30 以降で利用可能</td></tr>
635</table>
636    <p>このディレクティブは <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> が探す、
637    include 要素の終了を示す文字列を変更します。</p>
638
639    <div class="example"><h3>例</h3><p><code>
640      SSIEndTag "%&gt;"
641    </code></p></div>
642
643
644<h3>参照</h3>
645<ul>
646<li><code class="directive"><a href="#ssistarttag">SSIStartTag</a></code></li>
647</ul>
648</div>
649<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
650<div class="directive-section"><h2><a name="SSIErrorMsg" id="SSIErrorMsg">SSIErrorMsg</a> <a name="ssierrormsg" id="ssierrormsg">ディレクティブ</a></h2>
651<table class="directive">
652<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>SSI のエラーがあったときに表示されるエラーメッセージ</td></tr>
653<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSIErrorMsg <var>message</var></code></td></tr>
654<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSIErrorMsg "[an error occurred while processing this
655directive]"</code></td></tr>
656<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
657<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
658<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
659<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
660<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>バージョン 2.0.30 以降で使用可能</td></tr>
661</table>
662    <p><code class="directive">SSIErrorMsg</code> ディレクティブは <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>
663    がエラーが起こったときに表示するメッセージを変更します。プロダクションサーバでは
664    メッセージがユーザに表示されないようにするために
665    デフォルトエラーメッセージを <code>"&lt;!-- Error --&gt;"</code>
666    に変えるというようなことを考えるかもしれません。</p>
667
668    <p>このディレクティブは <code>&lt;!--#config
669    errmsg=<var>message</var> --&gt;</code> 要素と同じ効果になります。</p>
670
671    <div class="example"><h3>例</h3><p><code>
672      SSIErrorMsg "&lt;!-- Error --&gt;"
673    </code></p></div>
674
675</div>
676<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
677<div class="directive-section"><h2><a name="SSIETag" id="SSIETag">SSIETag</a> <a name="ssietag" id="ssietag">ディレクティブ</a></h2>
678<table class="directive">
679<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Controls whether ETags are generated by the server.</td></tr>
680<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSIETag on|off</code></td></tr>
681<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSIETag off</code></td></tr>
682<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
683<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
684<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
685<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in version 2.2.15 and later.</td></tr>
686</table><p>このディレクティブの解説文書は
687            まだ翻訳されていません。英語版をご覧ください。
688            </p></div>
689<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
690<div class="directive-section"><h2><a name="SSILastModified" id="SSILastModified">SSILastModified</a> <a name="ssilastmodified" id="ssilastmodified">ディレクティブ</a></h2>
691<table class="directive">
692<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Controls whether <code>Last-Modified</code> headers are generated by the
693server.</td></tr>
694<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSILastModified on|off</code></td></tr>
695<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSILastModified off</code></td></tr>
696<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
697<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
698<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
699<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in version 2.2.15 and later.</td></tr>
700</table><p>このディレクティブの解説文書は
701            まだ翻訳されていません。英語版をご覧ください。
702            </p></div>
703<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
704<div class="directive-section"><h2><a name="SSIStartTag" id="SSIStartTag">SSIStartTag</a> <a name="ssistarttag" id="ssistarttag">ディレクティブ</a></h2>
705<table class="directive">
706<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>include 要素を開始する文字列</td></tr>
707<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSIStartTag <var>tag</var></code></td></tr>
708<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSIStartTag "&lt;!--#"</code></td></tr>
709<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
710<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
711<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
712<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>バージョン 2.0.30 以降で使用可能</td></tr>
713</table>
714
715    <p>このディレクティブは <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> が探す、include
716    要素の開始を示す文字列を変更します。</p>
717
718    <p>二つのサーバで (もしかすると別々の段階で) ファイルの出力を解析していて、
719    それぞれに違うコマンドを処理させたい、
720    というようなときにこのオプションを使います。</p>
721
722    <div class="example"><h3>例</h3><p><code>
723      SSIStartTag "&lt;%"<br />
724      SSIEndTag   "%&gt;"
725    </code></p></div>
726
727    <p>上の例のように対応する
728    <code class="directive"><a href="#ssiendtag">SSIEndTag</a></code> を併せて使うと、
729    下に示す例のように SSI ディレクティブを使えます:</p>
730
731    <div class="example"><h3>違う開始と終了のタグを使った SSI ディレクティブ</h3><p><code>
732      &lt;%printenv %&gt;
733    </code></p></div>
734
735<h3>参照</h3>
736<ul>
737<li><code class="directive"><a href="#ssiendtag">SSIEndTag</a></code></li>
738</ul>
739</div>
740<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
741<div class="directive-section"><h2><a name="SSITimeFormat" id="SSITimeFormat">SSITimeFormat</a> <a name="ssitimeformat" id="ssitimeformat">ディレクティブ</a></h2>
742<table class="directive">
743<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>日付けを表す文字列の書式を設定する</td></tr>
744<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSITimeFormat <var>formatstring</var></code></td></tr>
745<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z"</code></td></tr>
746<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
747<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
748<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
749<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
750<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.0.30 以降で使用可能</td></tr>
751</table>
752<p>このディレクティブは <code>DATE</code> 環境変数を echo して日付を表す文字列が
753    表示されるときの書式を変更します。<var>formatstring</var> は
754    C 標準ライブラリの <code>strftime(3)</code> と同じ形式です。</p>
755
756    <p>このディレクティブは <code>&lt;!--#config
757    timefmt=<var>formatstring</var> --&gt;</code> 要素と同じ効果になります。</p>
758
759    <div class="example"><h3>例</h3><p><code>
760      SSITimeFormat "%R, %B %d, %Y"
761    </code></p></div>
762
763    <p>上のディレクティブでは、日付は "22:26, June 14, 2002" という
764    形式で表示されます。</p>
765
766</div>
767<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
768<div class="directive-section"><h2><a name="SSIUndefinedEcho" id="SSIUndefinedEcho">SSIUndefinedEcho</a> <a name="ssiundefinedecho" id="ssiundefinedecho">ディレクティブ</a></h2>
769<table class="directive">
770<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>未定義の変数が echo されたときに表示される文字列</td></tr>
771<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SSIUndefinedEcho <var>string</var></code></td></tr>
772<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SSIUndefinedEcho "(none)"</code></td></tr>
773<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
774<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
775<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
776<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
777<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.0.34 以降で利用可能</td></tr>
778</table>
779    <p>このディレクティブは変数が定義されていないにも関わらず
780    "echo" されたときに <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>
781    が表示する文字列を変更します。</p>
782
783    <div class="example"><h3>例</h3><p><code>
784      SSIUndefinedEcho "&lt;!-- undef --&gt;"
785    </code></p></div>
786
787</div>
788<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
789<div class="directive-section"><h2><a name="XBitHack" id="XBitHack">XBitHack</a> <a name="xbithack" id="xbithack">ディレクティブ</a></h2>
790<table class="directive">
791<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>実行ビットが設定されたファイルの SSI ディレクティブを
792解析する</td></tr>
793<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>XBitHack on|off|full</code></td></tr>
794<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>XBitHack off</code></td></tr>
795<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
796<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Options</td></tr>
797<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
798<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_include</td></tr>
799</table>
800    <p><code class="directive">XBitHack</code> ディレクティブは通常の HTML
801    ドキュメントの解析を制御します。このディレクティブは MIME タイプ
802    <code>text/html</code> と関連付けられているファイルにのみ影響します。
803    <code class="directive">XBitHack</code> は以下の値をとることができます。</p>
804
805    <dl>
806      <dt><code>off</code></dt>
807      <dd>実行可能ファイルに対して特別な扱いをしません。</dd>
808
809      <dt><code>on</code></dt>
810      <dd>ユーザの実行ビットが設定されている <code>text/html</code>
811      ファイルは全てサーバで解析する html ドキュメントとして扱われます。</dd>
812
813      <dt><code>full</code></dt>
814      <dd><code>on</code> と同様ですが、グループ実行ビットもテストします。
815      もしそれが設定されていれば、返されるファイルの <code>Last-modified</code> の
816      日付をファイルの最終修正時刻にします。それが設定されていないときは、
817      last-modified の日付は送られません。このビットを設定すると、
818      クライアントやプロキシがリクエストをキャッシュできるようになります。
819
820      <div class="note"><strong>注意</strong> 他の CGI を <code>#include</code>
821      するかもしれないものや、各アクセスに対して違う出力を生成する
822      (もしくは後のリクエストで変わるかもしれないもの)
823      すべての SSI スクリプトに対してグループ実行ビットが
824      設定されていないことを確認できない場合は、full は使わない方が良い
825      でしょう。</div>
826      </dd>
827    </dl>
828
829    
830</div>
831</div>
832<div class="bottomlang">
833<p><span>翻訳済み言語: </span><a href="/en/mod/mod_include.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
834<a href="/ja/mod/mod_include.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
835</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
836<script type="text/javascript"><!--//--><![CDATA[//><!--
837var comments_shortname = 'httpd';
838var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_include.html';
839(function(w, d) {
840    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
841        d.write('<div id="comments_thread"><\/div>');
842        var s = d.createElement('script');
843        s.type = 'text/javascript';
844        s.async = true;
845        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
846        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
847    }
848    else { 
849        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
850    }
851})(window, document);
852//--><!]]></script></div><div id="footer">
853<p class="apache">Copyright 2013 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
854<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
855if (typeof(prettyPrint) !== 'undefined') {
856    prettyPrint();
857}
858//--><!]]></script>
859</body></html>