1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
4 <!-- English Revision: 1544626:1799456 (outdated) -->
7 Licensed to the Apache Software Foundation (ASF) under one or more
8 contributor license agreements. See the NOTICE file distributed with
9 this work for additional information regarding copyright ownership.
10 The ASF licenses this file to You under the Apache License, Version 2.0
11 (the "License"); you may not use this file except in compliance with
12 the License. You may obtain a copy of the License at
14 http://www.apache.org/licenses/LICENSE-2.0
16 Unless required by applicable law or agreed to in writing, software
17 distributed under the License is distributed on an "AS IS" BASIS,
18 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 See the License for the specific language governing permissions and
20 limitations under the License.
23 <manualpage metafile="directive-dict.xml.meta">
25 <title>ディレクティブの解説に使われる用語</title>
28 <p>この文書は各 Apache <a href="directives.html">設定ディレクティブ</a>
29 を説明するために使われている用語を説明します。</p>
31 <seealso><a href="../configuring.html">設定ファイル</a></seealso>
33 <section id="Description"><title>説明</title>
35 <p>ディレクティブの目的の簡単な説明。</p>
38 <section id="Syntax"><title>構文</title>
40 <p>設定ファイル中のディレクティブの書式を示します。
41 この構文はディレクティブ特有なので、詳細はディレクティブの説明を
42 参照してください。一般的に、ディレクティブ名の後には
43 空白により分割されたいくつかの引数が続きます。
44 引数が空白を含むときは二重引用符 (訳注: ")
45 で囲まれています。 オプショナルな引数は括弧
47 引数が複数の値を取り得る場合は、それらの値は垂直の棒 "|"
49 変更されないテキストはデフォルトのフォントで表示され、置換の必要な
50 引数は<em>強調されて</em>表示されます。
52 引数が繰り返されることを示すために "..."
56 ディレクティブは多くの違う型の引数をとります。いくつか、良く
62 <dd><code>http://www.example.com/path/to/file.html</code>
64 スキーム、ホスト名、パス名(省略可能)を含んでいる完全な
65 Uniform Resource Locator。</dd>
67 <dt><em>URL-path</em></dt>
69 <dd><code>/path/to/file.html</code> のように、スキームと
70 ホスト名の後に続く <em>url</em>
71 の一部。<em>url-path</em> は
73 ウェブからの視点でリソースを表現します。</dd>
75 <dt><em>file-path</em></dt>
77 <dd><code>/usr/local/apache/htdocs/path/to/file.html</code>
79 ルートディレクトリから始まるローカルのファイルシステム上のファイルへのパス。
80 通常、スラッシュで始まらない <em>file-path</em> は <a
81 href="core.html#serverroot">ServerRoot</a>
82 からの相対パスとして 扱われます。</dd>
84 <dt><em>directory-path</em></dt>
86 <dd><code>/usr/local/apache/htdocs/path/to/</code>
88 ルートディレクトリから始まるローカルのファイルシステムのディレクトリへの
91 <dt><em>filename</em></dt>
93 <dd><code>file.html</code> のように、パス情報の付いていない
96 <dt><em>regex</em></dt>
98 <dd>Perl 互換の<glossary ref="regex">正規表現</glossary>です。
99 ディレクティブの定義が <em>regex</em>
100 が何に対してマッチを行なうのかを指定します。</dd>
102 <dt><em>extension</em></dt>
104 <dd>一般的には <em>filename</em>
105 の最後のドットの後の部分です。 しかし、Apache
106 は複数のファイルの拡張子を認識しますので、<em>filename</em>
107 に複数のドットがあると、最初のドットの後の、それぞれのドットで分離された部分が
108 <em>extension</em> (訳注: 拡張子)
109 になります。例えば、<em>filename</em>
110 <code>file.html.en</code>
111 には二つの拡張子があります。<code>.html</code> と
112 <code>.en</code> です。Apache
113 のディレクティブでは、<em>extension</em>
114 はドット付きでも無しでも指定できます。さらに、<em>extension</em>
115 は 大文字小文字を区別しません。</dd>
117 <dt><em>MIME-type</em></dt>
119 <dd><code>text/html</code> のように、スラッシュで分離された
120 主フォーマットと副フォーマットによってファイルの形式を
123 <dt><em>env-variable</em></dt>
125 <dd>Apache の設定により定義される <a
126 href="../env.html">環境変数</a>の名前です。これはオペレーティングシステムの
127 環境変数と同じとは限らないことに注意してください。詳細は <a
128 href="../env.html">環境変数の説明</a>を参照してください。</dd>
132 <section id="Default"><title>デフォルト</title>
135 (<em>すなわち</em>、設定ファイルから
137 ウェブサーバは特定の値に設定されているかのように
138 動作します) がある場合はここに記述されます。
139 デフォルト値の無い場合、ここは "<em>None</em>" と
140 書かれます。ここで書かれているデフォルトはサーバと共に配布されている
143 違う可能性があることに注意してください。</p>
146 <section id="Context"><title>コンテキスト</title>
149 これは、サーバの設定ファイル中のどこでディレクティブが有効なのかを示します。
150 次に示す値が一つ以上カンマ区切りで列挙されています。</p>
156 (<em>例えば</em>、<code>httpd.conf</code>,
157 <code>srm.conf</code>, <code>access.conf</code>)
159 <directive module="core" type="section">VirtualHost</directive> や
160 <directive module="core" type="section">Directory</directive> の中では
161 <strong>使用できない</strong>ことを示します。
162 <code>.htaccess</code>ファイルでの使用は許可されていません。</dd>
167 <directive module="core" type="section">VirtualHost</directive>
168 の中で使用できることを示します。</dd>
173 <directive module="core" type="section">Directory</directive>,
174 <directive module="core" type="section">Location</directive>,
175 <directive module="core" type="section">Files</directive>,
176 <directive module="core" type="section">If</directive>,
177 <directive module="mod_proxy" type="section">Proxy</directive>
179 href="../sections.html">設定セクション</a>
180 で説明されている制限の下で使用できることを示します。</dd>
184 <dd>これは、ディレクトリ<em>毎</em>の
185 <code>.htaccess</code> ファイル内で
186 使用可能であることを示します。 ただ、<a
187 href="#Override">上書き</a>
188 の設定によっては、処理されないかもしれません。</dd>
192 ディレクティブは指示されたコンテキストで<em>のみ</em>許可されます。
193 他の場所で使おうとすると、サーバがそのコンテキストを正しく扱えなく
194 なるような設定エラーが発生するか、サーバがまったく動作しなくなる、
195 <em>すなわち</em>、サーバが起動しなくなるということになります。</p>
198 ディレクティブの有効な位置は、実際は挙げられているコンテキストの
201 "<code>サーバ設定ファイル、.htaccess</code>" で有効だと
202 記されているディレクティブは <code>httpd.conf</code>
203 ファイルと <code>.htaccess</code>
204 ファイルとで有効ですが、 <directive module="core"
205 type="section">Directory</directive>
206 や <directive module="core" type="section">VirtualHost</directive>
210 <section id="Override"><title>上書き</title>
212 <p>このディレクティブの属性は、<code>.htaccess</code>
214 ディレクティブが現れたときに、それの処理を有効にするために
215 どの設定の上書きが必要かを示します。 ディレクティブの
216 <a href="#Context">コンテキスト</a>
217 が、<code>.htaccess</code>
218 ファイル中では許可していない場合は、 この属性は
219 "<em>適用不可</em>" と書かれます。</p>
221 <p>上書きは、<directive module="core">AllowOverride</directive>
224 さらに下位のレベルの <directive module="core">AllowOverride</directive>
225 で修正されない限り、 その配下に対して適用されます。
226 ディレクティブのドキュメントは取り得る上書きの名前も挙げます。</p>
229 <section id="Status"><title>ステータス</title>
231 <p>これはディレクティブが Apache
232 ウェブサーバにどれくらいきつく組み込まれているかを
233 示します。言い換えれば、ディレクティブとその機能を利用するために、
234 モジュールの数を増やして、サーバを再コンパイルする必要があるかもしれない
236 この属性が取り得る値は以下のものです:</p>
241 <dd>"Core" のディレクティブは Apache
243 常に使用可能であることを示します。</dd>
247 <dd>"MPM" のディレクティブは<a
248 href="../mpm.html">マルチプロセッシングモジュール</a>で提供されています。
249 この種類のディレクティブはディレクティブの定義の<a
250 href="#Module">モジュール</a>の行に使っているモジュールの名前が書かれている
256 デフォルトでサーバに組み込まれている標準モジュールの中の一つでサ
257 ポートされていて、わざわざ設定からモジュールを削除したときを除いて、
258 通常では使用可能であることを示します。</dd>
262 <dd>"Extension" のディレクティブは、 Apache
263 サーバの配布物に同梱されているモジュールの一つで提供されているものの、
264 通常ではサーバに組み込まれていないことを示します。
265 ディレクティブとその機能を有効にするには、サーバビルド用の設定ファイルを
267 を再コンパイルする必要があります。</dd>
269 <dt>Experimental</dt>
271 <dd>"Experimental" のディレクティブは、Apache
273 同梱されているものの、試したい場合は自己責任で行なう
274 必要があるということを示します。ディレクティブは、すべてのドキュメントを
275 完全にそろわせるために解説されていますが、サポートされているとは限りません。
276 ディレクティブを提供するモジュールはデフォルトで組み込まれているかも
277 しれませんし、そうでないかもしれません。使用可能かどうかは、
278 ディレクティブとモジュールの説明をしているページの先頭を調べてください。</dd>
282 <section id="Module"><title>モジュール</title>
285 これは単純にディレクティブが定義されているモジュールの名前を記載します。</p>
288 <section id="Compatibility"><title>互換性</title>
292 ディレクティブが導入されたバージョンがここに書かれています。
293 また、ディレクティブが特定のプラットフォームにのみ存在するときも