|
-Related Modules -mod_mime - |
-
-
-Related Directives -<IfDefine> -Include -TypesConfig - |
Apache is configured by placing directives in plain text configuration files. The main
-configuration file is usually called httpd.conf. The
-location of this file is set at compile-time, but may be overridden
-with the -f command line flag. In addition, other
-configuration files may be added using the Include directive. Any
-directive may be placed in any of these configuration files. Changes
-to the main configuration files are only recognized by Apache when it
-is started or restarted.
New with Apache 1.3.13 is a feature where if any configuration -file is actually a directory, Apache will enter that directory -and parse any files (and subdirectories) found there as configuration -files. One possible use for this would be to add VirtualHosts -by creating small configuration files for each host, and placing -them in such a configuration directory. Thus, you can add or -remove VirtualHosts without editing any files at all, simply -adding or deleting them. This makes automating such processes -much easier. - -
-The server also reads a file containing mime document types; the
-filename is set by the TypesConfig directive, and is mime.types by default.
-
-
Apache configuration files contain one directive per line. The -back-slash "\" may be used as the last character on a line to indicate -that the directive continues onto the next line. There must be no -other characters or white space between the back-slash and the end of -the line. - -
Directives in the configuration files are case-insensitive, but -arguments to directives are often case sensitive. Lines which begin -with the hash character "#" are considered comments, and are ignored. -Comments may not be included on a line after a -configuration directive. Blank lines and white space occurring before -a directive are ignored, so you may indent directives for clarity. - -
You can check your configuration files for syntax errors without
-starting the server by using apachectl configtest
-or the -t command line option.
-
-
|
-Related Modules -mod_so - |
-
-Related Directives -AddModule -ClearModuleList -<IfModule> -LoadModule - |
Apache is a modular server. This implies that only the most basic -functionality is included in the core server. Extended features are -available through modules which -can be loaded into Apache. By default, a base set of modules is -included in the server at compile-time. If the server is compiled to -use dynamically loaded modules, then modules -can be compiled separately and added at any time using the LoadModule directive. -Otherwise, Apache must be recompiled to add or remove modules. -Configuration directives may be included conditional on a presence of -a particular module by enclosing them in an <IfModule> block. - -
To see which modules are currently compiled into the server,
-you can use the -l command line option.
-
-
|
-Related Directives -<Directory> -<DirectoryMatch> -<Files> -<FilesMatch> -<Location> -<LocationMatch> -<VirtualHost> - |
Directives placed in the main configuration files apply to the entire
-server. If you wish to change the configuration for only a part of
-the server, you can scope your directives by placing them in
-<Directory>,
-<DirectoryMatch>,
-<Files>,
-<FilesMatch>,
-<Location>,
- and
-<LocationMatch>
-
-sections. These sections limit the application of the directives
-which they enclose to particular filesystem locations or URLs. They
-can also be nested, allowing for very fine grained configuration.
-
-
Apache has the capability to serve many different websites
-simultaneously. This is called Virtual Hosting.
-Directives can also be scoped by placing them inside
-<VirtualHost>
-sections, so that they will only apply to requests for a particular
-website.
-
-
Although most directives can be placed in any of these sections, -some directives do not make sense in some contexts. For example, -directives controlling process creation can only be placed in the main -server context. To find which directives can be placed in which -sections, check the Context of the directive. -For further information, we provide details on How Directory, Location and Files sections -work. - -
|
-Related Directives -AccessFileName -AllowOverride - |
Apache allows for decentralized management of configuration via
-special files placed inside the web tree. The special files are
-usually called .htaccess, but any name can be specified
-in the AccessFileName directive. Directives placed in
-.htaccess files apply to the directory where you place
-the file, and all sub-directories. The .htaccess files
-follow the same syntax as the main configuration files. Since
-.htaccess files are read on every request, changes made
-in these files take immediate effect.
-
-
To find which directives can be placed in .htaccess
-files, check the Context
-of the directive. The server administrator further controls what
-directives may be placed in .htaccess files by
-configuring the AllowOverride
-directive in the main configuration files.
-
-
On startup, Apache saves the process id of the parent httpd process to
-the file logs/httpd.pid. This filename can be changed
-with the PidFile directive. The
-process-id is for use by the administrator in restarting and
-terminating the daemon: on Unix, a HUP or USR1 signal causes the
-daemon to re-read its configuration files and a TERM signal causes it
-to die gracefully; on Windows, use the -k command line option instead.
-For more information see the Stopping and
-Restarting page.
-
-
-If the process dies (or is killed) abnormally, then it will be necessary to -kill the children httpd processes. - -
The server will log error messages to a log file, by default
-logs/error_log on Unix or logs/error.log on
-Windows and OS/2. The filename can be set using the ErrorLog directive; different error
-logs can be set for different virtual hosts.
-
-
The server will typically log each request to a transfer file, by
-default logs/access_log on Unix or
-logs/access.log on Windows and OS/2. The filename can be
-set using a CustomLog
-directive; different transfer logs can be set for different virtual hosts.
-
-
-
-
-
diff --git a/docs/manual/configuring.html.html b/docs/manual/configuring.html.html
new file mode 100644
index 0000000000..461de9960c
--- /dev/null
+++ b/docs/manual/configuring.html.html
@@ -0,0 +1 @@
+
diff --git a/docs/manual/configuring.html.ja.jis b/docs/manual/configuring.html.ja.jis
new file mode 100644
index 0000000000..c1b41e5251
--- /dev/null
+++ b/docs/manual/configuring.html.ja.jis
@@ -0,0 +1,247 @@
+
+
+
|
+関連モジュール +mod_mime + |
+
+
+関連ディレクティブ +<IfDefine> +Include +TypesConfig + |
Apache は ディレクティブ を
+設定ファイルに平文で書くことにより設定します。メインの
+設定ファイルは普通は httpd.conf という名前です。
+このファイルの位置はコンパイル時に設定されますが、コマンドラインの
+-f フラグにより上書きできます。その上、他の設定ファイルが
+Include ディレクティブ
+によって追加されているかもしれません。どのディレクティブも
+これらの設定ファイルのどれにでも入れられます。Apache は起動時か
+再起動時のみメイン設定ファイルの変更を認識します。
Apache 1.3.13 の新しい機能として、設定ファイルが実際はディレクトリで +あるときにはそのディレクトリで見つかったすべてのファイル +(とサブディレクトリ) を解析するというものがあります。利用法としては、 +バーチャルホストを追加するときに、それぞれのホストに対して小さな設定 +ファイルを作り、設定ディレクトリに置くというものが挙げられます。 +こうすると、単にファイルの追加、削除をすることにより全くファイルを +編集することなくバーチャルホストの追加、削除ができます。これは自動化を +ずっと簡単にします。
+ +
+サーバは mime ドキュメントタイプを含んでいるファイルも読み込みます。
+ファイル名は TypesConfig で設定され、デフォルトで mime.types
+になっています。
Apache 設定ファイルは1行に1つのディレクティブからなります。 +バックスラッシュ "\" はディレクティブが次の行に継続していることを +示すために行の最後の文字として使われているかもしれません。 +行の最後とバックスラッシュの間に他の文字や空白があってはいけません。
+ +設定ファイルのディレクティブは大文字小文字を区別しませんが、 +引数にはしばしば区別するものがあります。ハッシュ文字 "#" で始まる行は +コメントと見なされて無視されます。設定ディレクティブの後の行では +コメントが含まれていてはいけません。ディレクティブの +前の空行と空白は無視されますので、わかりやすくするためにディレクティブを +インデントすることができます。
+ +設定ファイルの構文エラーは
+apachectl configtest かコマンドラインオプション
+-t を使って調べられます。
|
+関連モジュール +mod_so + |
+
+関連ディレクティブ +AddModule +ClearModuleList +<IfModule> +LoadModule + |
Apache はモジュール化されたサーバです。コアサーバには +一番基本的な機能だけが含まれています。拡張機能は Apache に +ロードされるモジュールとして +利用可能です。デフォルトではコンパイル時にモジュールの基本セットが +サーバに含まれます。サーバが動的ロードモジュールを +使うようにコンパイルされている場合は、モジュールを別にコンパイルして、 +いつでも LoadModule +ディレクティブを使って追加できます。そうでない場合は、モジュールの +追加や削除をするためには Apache を再コンパイルする必要があります。 +設定ディレクティブは <IfModule> ブロックに +入れることで特定のモジュールが存在するときだけ +設定ファイルに含まれるようにすることができます。
+ +コマンドラインオプション -l を使って
+現時点でどのモジュールがサーバにコンパイルされているかを
+知ることができます。
+
+
|
+関連ディレクティブ +<Directory> +<DirectoryMatch> +<Files> +<FilesMatch> +<Location> +<LocationMatch> +<VirtualHost> + |
メイン設定ファイルにあるディレクティブはサーバ全体に適用されます。
+サーバの一部分の設定だけを変更したい場合は
+<Directory>,
+<DirectoryMatch>,
+<Files>,
+<FilesMatch>,
+<Location>,
+<LocationMatch>
+
+セクションの中に置くことで適用範囲を決められます。これらのセクションは
+その中にあるディレクティブの適用範囲を特定のファイルシステムの位置や
+URL に限定します。非常に細粒度の設定を可能にするために、セクションを
+入れ子にすることもできます。
Apache は同時に多くの違うウェブサイトを扱う能力があります。
+これは バーチャルホスト と呼ばれています。
+特定のウェブサイトにのみ適用されるようにするために、ディレクティブは
+<VirtualHost>
+セクションの中に置くことでも適用範囲を変えることができます。
ほとんどのディレクティブはどのセクションにでも書けますが、 +中にはコンテキストによっては意味をなさないものもあります。例えば、 +プロセスの作成を制御しているディレクティブはメインサーバのコンテキストに +のみ書くことができます。どのディレクティブをどのセクションに書くことが +できるかを知るためにはディレクティブの +コンテキストを調べてください。 +詳しい情報は、Directory, Location, Files セクションの動作法 +にあります。
+ +|
+関連ディレクティブ +AccessFileName +AllowOverride + |
Apache ではウェブツリーの中に置かれた特別なファイルを使って
+非中央集権的な設定管理をできます。その特別なファイルは普通は
+.htaccess という名前で、
+AccessFileName ディレクティブでどんな名前でも指定できます。
+.htaccess ファイルに書かれたディレクティブはファイルを
+置いたディレクトリとその全てのサブディレクトリに適用されます。
+.htaccess ファイルはすべてのリクエストで
+読み込まれるため、変更はすぐに反映されます。
+
+
どのディレクティブが .htaccess ファイルに書けるかを
+調べるには、ディレクティブの
+コンテキスト を調べてください。
+サーバ管理者はさらにメイン設定ファイルの AllowOverride
+を設定することでどのディレクティブを .htaccess ファイルに
+書けるようにするかを制御することができます。
+Apache がログファイルを書いているディレクトリに書き込める人は誰でも +ほぼ確実にサーバが起動された uid のアクセスを取得できます。 +そしてそれは普通 root です。その結果をよくわからずにログが保管されている +ディレクトリに書き込み権限を与えたりしないでください。詳細は +セキュリティ情報を参照してください。
+ +起動時に Apache は親 httpd プロセスのプロセス ID を
+logs/httpd.pid ファイルに保存します。このファイル名は
+PidFile
+ディレクティブで変更することができます。プロセス ID は管理者がデーモンを
+再起動したり終了したりするために使います。Unix では HUP と USR1 シグナルで
+デーモンが設定ファイルを再読み込みします。TERM シグナルはデーモンを
+優雅に終了させます。Windows では、代わりにコマンドラインオプション -k を
+使います。
+詳しい情報は起動と終了を参照してください。
+プロセスが異常終了する (もしくは kill される) と、子 httpd プロセスを +kill する必要があります。
+ +サーバはエラーメッセージをログファイルに記録します。デフォルトは、Unix
+では logs/error_log で Windows と OS/2 では
+logs/error.log です。ファイル名は ErrorLog ディレクティブで設定できます。
+違うバーチャルホスト
+に違うエラーログを設定することができます。
サーバは普通それぞれのリクエストを転送ファイルにログを取ります。
+デフォルトは Unix では logs/access_log で Windows と
+OS/2 では logs/access.log です。ファイル名は
+CustomLog
+ディレクティブをで設定できます。違うバーチャルホストに
+違う転送ログを設定することができます。
|
-Related Modules - -mod_actions -mod_asis -mod_cgi -mod_imap -mod_info -mod_mime -mod_negotiation -mod_status - |
-
-Related Directives - -Action -AddHandler -RemoveHandler -SetHandler - |
-
A "handler" is an internal Apache representation of the action to be -performed when a file is called. Generally, files have implicit -handlers, based on the file type. Normally, all files are simply -served by the server, but certain file types are "handled" -separately.
- -Apache 1.1 adds the ability to use handlers explicitly. Based on -either filename extensions or on location, handlers can be specified -without relation to file type. This is advantageous both because it is -a more elegant solution, and because it also allows for both a type -and a handler to be associated with a file. (See also -Files with Multiple -Extensions.)
- -Handlers can either be built into the server or included in a module, -or they can be added with the Action directive. The built-in -handlers in the standard distribution are as follows:
- -default_handler(), which is the
- handler used by default to handle static content.
- (core)
-The following directives will cause requests for files with the
-html extension to trigger the launch of the
-footer.pl CGI script.
- Action add-footer /cgi-bin/footer.pl - AddHandler add-footer .html -- -
Then the CGI script is responsible for sending the originally
-requested document (pointed to by the PATH_TRANSLATED
-environment variable) and making whatever modifications or additions
-are desired.
The following directives will enable the send-as-is
-handler, which is used for files which contain their own HTTP headers.
-All files in the /web/htdocs/asis/ directory will be
-processed by the send-as-is handler, regardless of their
-filename extensions.
- <Directory /web/htdocs/asis> - SetHandler send-as-is - </Directory> -- -
In order to implement the handler features, an addition has been
-made to the Apache API that you may wish to
-make use of. Specifically, a new record has been added to the
-request_rec structure:
- char *handler --
If you wish to have your module engage a handler, you need only to
-set r->handler to the name of the handler at any time
-prior to the invoke_handler stage of the
-request. Handlers are implemented as they were before, albeit using
-the handler name instead of a content type. While it is not
-necessary, the naming convention for handlers is to use a
-dash-separated word, with no slashes, so as to not invade the media
-type name-space.
|
+関連モジュール + +mod_actions +mod_asis +mod_cgi +mod_imap +mod_info +mod_mime +mod_negotiation +mod_status + |
+
+関連ディレクティブ + +Action +AddHandler +RemoveHandler +SetHandler + |
+
「ハンドラ」とは、ファイルが呼ばれたときに実行される動作の Apache における +内部表現です。通常、ファイルはファイル型に基づいた暗黙の +ハンドラがあります。普通はすべてのファイルは単にサーバに扱われますが、 +ファイルタイプの中には別に「ハンドル」 (訳注: 扱う) されるものもあります。
+ +Apache 1.1 では、ハンドラを明示的に使用する機能が追加されました。 +ファイルの拡張子や置いている場所に基づいて、ファイル型と関係なくハンドラを +指定することができます。これはより優雅な解決法という点と、ファイルに +タイプとハンドラの両方を関連付けることができるという +点で優れています。 (複数の拡張子のあるファイル +も参照してください)。
+ +ハンドラはサーバに組み込んだり、モジュールとして含めたり、 +Action ディレクティブとして +追加したりすることができます。以下は標準配布に組み込まれているハンドラです。
+ +default_handelr() を使ってファイルを送ります。
+ 静的なコンテンツを扱うときにデフォルトで使用されるハンドラです。
+ (core)
+以下のディレクティブによって、拡張子が html であるファイルは
+footer.pl CGI スクリプトを起動するようになります。
+ Action add-footer /cgi-bin/footer.pl + AddHandler add-footer .html ++ +
CGI スクリプトは望ましい修正や追加を行なって、元々要求された文書
+(環境変数 PATH_TRANSLATED で指されています) を送る責任があります。
以下のディレクティブは send-as-is ハンドラを使用する
+ように指示します。このハンドラは自分自身の HTTP ヘッダを持っているファイルに
+使用されます。ここでは、拡張子に関わらず、/web/htdocs/asis
+ディレクトリにある全てのファイルは send-as-is ハンドラによって
+扱われます。
+ <Directory /web/htdocs/asis> + SetHandler send-as-is + </Directory> ++ +
ハンドラの機能を実装するために、利用すると便利かもしれないものが
+Apache API に追加されました。
+詳しく言うと、request_rec 構造体に新しいレコードが
+追加されたということです。
+ char *handler ++
もしモジュールがハンドラに関わりたい場合、やらなければならないことは、
+リクエストが invoke_handler ステージに達する以前に
+r->handler を設定することだけです。
+ハンドラはコンテントタイプの代わりにハンドラ名を使うようになっていること以外は、
+以前と同じように実装されています。必ず要求されているわけではありませんが、
+メディアタイプの名前空間を侵さないように、ハンドラの名前にはスラッシュ
+を含まない、ダッシュ (訳注: "-") で分離された名前を付ける習慣になっています。