ディレクティブの解説に使われる用語
この文書は各 Apache 設定ディレクティブ を説明するために使われている用語を説明します。
参照
説明
ディレクティブの目的の簡単な説明。
構文
設定ファイル中のディレクティブの書式を示します。 この構文はディレクティブ特有なので、詳細はディレクティブの説明を 参照してください。一般的に、ディレクティブ名の後には 空白により分割されたいくつかの引数が続きます。 引数が空白を含むときは二重引用符 (訳注: ") で囲まれています。 オプショナルな引数は括弧 (訳注: []) で囲まれています。 引数が複数の値を取り得る場合は、それらの値は垂直の棒 "|" で 分割されています。 変更されないテキストはデフォルトのフォントで表示され、置換の必要な 引数は強調されて表示されます。 引数の数が変わるディレクティブは最後の 引数が繰り返されることを示すために "..." で終わります。
ディレクティブは多くの違う型の引数をとります。いくつか、良く 使われるものを以下で定義します。
- URL
http://www.example.com/path/to/file.htmlのように、 スキーム、ホスト名、パス名(省略可能)を含んでいる完全な Uniform Resource Locator。- URL-path
/path/to/file.htmlのように、スキームと ホスト名の後に続く url の一部。url-path は ファイルシステムからの視点ではなく、 ウェブからの視点でリソースを表現します。- file-path
/usr/local/apache/htdocs/path/to/file.htmlのように、 ルートディレクトリから始まるローカルのファイルシステム上のファイルへのパス。 通常、スラッシュで始まらない file-path は ServerRoot からの相対パスとして 扱われます。- directory-path
/usr/local/apache/htdocs/path/to/のように、 ルートディレクトリから始まるローカルのファイルシステムのディレクトリへの パス。- filename
file.htmlのように、パス情報の付いていない ファイル名。- regex
- Perl 互換の正規表現です。 ディレクティブの定義が regex が何に対してマッチを行なうのかを指定します。
- extension
- 一般的には filename
の最後のドットの後の部分です。 しかし、Apache
は複数のファイルの拡張子を認識しますので、filename
に複数のドットがあると、最初のドットの後の、それぞれのドットで分離された部分が
extension (訳注: 拡張子)
になります。例えば、filename
file.html.enには二つの拡張子があります。.htmlと.enです。Apache のディレクティブでは、extension はドット付きでも無しでも指定できます。さらに、extension は 大文字小文字を区別しません。 - MIME-type
text/htmlのように、スラッシュで分離された 主フォーマットと副フォーマットによってファイルの形式を 表す方法です。- env-variable
- Apache の設定により定義される 環境変数の名前です。これはオペレーティングシステムの 環境変数と同じとは限らないことに注意してください。詳細は 環境変数の説明を参照してください。
デフォルト
ディレクティブにデフォルト値 (すなわち、設定ファイルから 省略されていても、Apache ウェブサーバは特定の値に設定されているかのように 動作します) がある場合はここに記述されます。 デフォルト値の無い場合、ここは "None" と 書かれます。ここで書かれているデフォルトはサーバと共に配布されている デフォルトの httpd.conf 内に書かれているディレクティブの値と 違う可能性があることに注意してください。
コンテキスト
これは、サーバの設定ファイル中のどこでディレクティブが有効なのかを示します。 次に示す値が一つ以上カンマ区切りで列挙されています。
- サーバ設定ファイル
- これは、サーバ設定ファイル
(例えば、
httpd.conf,srm.conf,access.conf) 内では使用できますが、<VirtualHost>や<Directory>の中では 使用できないことを示します。.htaccessファイルでの使用は許可されていません。 - バーチャルホスト
- これは、サーバ設定ファイルの
<VirtualHost>の中で使用できることを示します。 - ディレクトリ
- これは、サーバ設定ファイルの
<Directory>,<Location>,<Files>,<Proxy>コンテナの中で、 設定セクション で説明されている制限の下で使用できることを示します。 - .htaccess
- これは、ディレクトリ毎の
.htaccessファイル内で 使用可能であることを示します。 ただ、上書き の設定によっては、処理されないかもしれません。
ディレクティブは指示されたコンテキストでのみ許可されます。 他の場所で使おうとすると、サーバがそのコンテキストを正しく扱えなく なるような設定エラーが発生するか、サーバがまったく動作しなくなる、 すなわち、サーバが起動しなくなるということになります。
ディレクティブの有効な位置は、実際は挙げられているコンテキストの
論理和 (訳注: Boolen OR)
になります。言い換えると、
"サーバ設定ファイル、.htaccess" で有効だと
記されているディレクティブは httpd.conf
ファイルと .htaccess
ファイルとで有効ですが、 <Directory>
や <VirtualHost>
の中では使用できません。
上書き
このディレクティブの属性は、.htaccess
ファイル中に
ディレクティブが現れたときに、それの処理を有効にするために
どの設定の上書きが必要かを示します。 ディレクティブの
コンテキスト
が、.htaccess
ファイル中では許可していない場合は、 この属性は
"適用不可" と書かれます。
上書きは、AllowOverride
ディレクティブによって有効にされ、
特定のスコープ(ディレクトリなど)と、
さらに下位のレベルの AllowOverride
で修正されない限り、 その配下に対して適用されます。
ディレクティブのドキュメントは取り得る上書きの名前も挙げます。
ステータス
これはディレクティブが Apache ウェブサーバにどれくらいきつく組み込まれているかを 示します。言い換えれば、ディレクティブとその機能を利用するために、 モジュールの数を増やして、サーバを再コンパイルする必要があるかもしれない ということを示します。 この属性が取り得る値は以下のものです:
- Core
- "Core" のディレクティブは Apache ウェブサーバの基本となるべきものであり、 常に使用可能であることを示します。
- MPM
- "MPM" のディレクティブはマルチプロセッシングモジュールで提供されています。 この種類のディレクティブはディレクティブの定義のモジュールの行に使っているモジュールの名前が書かれている 場合にのみ使用可能です。
- Base
- "Base" のディレクティブは デフォルトでサーバに組み込まれている標準モジュールの中の一つでサ ポートされていて、わざわざ設定からモジュールを削除したときを除いて、 通常では使用可能であることを示します。
- Extension
- "Extension" のディレクティブは、 Apache サーバの配布物に同梱されているモジュールの一つで提供されているものの、 通常ではサーバに組み込まれていないことを示します。 ディレクティブとその機能を有効にするには、サーバビルド用の設定ファイルを 変更して Apache を再コンパイルする必要があります。
- Experimental
- "Experimental" のディレクティブは、Apache 配布物に 同梱されているものの、試したい場合は自己責任で行なう 必要があるということを示します。ディレクティブは、すべてのドキュメントを 完全にそろわせるために解説されていますが、サポートされているとは限りません。 ディレクティブを提供するモジュールはデフォルトで組み込まれているかも しれませんし、そうでないかもしれません。使用可能かどうかは、 ディレクティブとモジュールの説明をしているページの先頭を調べてください。
モジュール
これは単純にディレクティブが定義されているモジュールの名前を記載します。
互換性
ディレクティブが Apache 2 の配布に組み込まれていなかった場合、 ディレクティブが導入されたバージョンがここに書かれています。 また、ディレクティブが特定のプラットフォームにのみ存在するときも ここに書かれています。