core.xml.ja revision e797af4d7b0cada1278d72d6c8ac77210ef78632
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<?xml version="1.0" encoding="UTF-8" ?>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
6b26240dca29e026900a83d51c75ca230a072a16Thiemo Wiedemeyer<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<!-- English Revision: 669847:904853 (outdated) -->
98890889ffb2e8f6f722b00e265a211f13b5a861Corneliu-Claudiu Prodescu
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<!--
2eeec5240b424984e3ee26296da1eeab6c6d739eChristian Maeder Licensed to the Apache Software Foundation (ASF) under one or more
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer contributor license agreements. See the NOTICE file distributed with
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer this work for additional information regarding copyright ownership.
7520452bb30b5abbd471f82352fc4c1c937e02c5Till Mossakowski The ASF licenses this file to You under the Apache License, Version 2.0
7520452bb30b5abbd471f82352fc4c1c937e02c5Till Mossakowski (the "License"); you may not use this file except in compliance with
7520452bb30b5abbd471f82352fc4c1c937e02c5Till Mossakowski the License. You may obtain a copy of the License at
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer http://www.apache.org/licenses/LICENSE-2.0
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer Unless required by applicable law or agreed to in writing, software
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer distributed under the License is distributed on an "AS IS" BASIS,
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer See the License for the specific language governing permissions and
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer limitations under the License.
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder-->
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<modulesynopsis metafile="core.xml.meta">
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<name>core</name>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<description>常に使用可能な Apache HTTP サーバのコア機能</description>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<status>Core</status>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
b0adcc203b4267d5535b430372935a5f36726db1Simon Ulbricht<directivesynopsis>
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder<name>AcceptFilter</name>
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder<description>プロトコルを Listen しているソケットの最適化を設定する</description>
abea93ed557b22ea833e1524ee5ca11afc12208aSimon Ulbricht<syntax>AcceptFilter <var>protocol</var> <var>accept_filter</var></syntax>
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder<contextlist><context>server config</context></contextlist>
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross<compatibility>2.1.5 以降</compatibility>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer<usage>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer <p>Listen しているソケットに対して、OS が固有に持っているプロトコルについての最適化を
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer 有効にするディレクティブです。大前提となる条件は、データが受信されるか
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer HTTP リクエスト全体がバッファされるかするまで、カーネルがサーバプロセスに
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer ソケットを送らないようになっている、ということです。現在サポートされているのは、
331603b37dec12e37e2e1df9634ef0f2c5c73ddfThiemo Wiedemeyer <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&amp;sektion=9">
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer FreeBSD の Accept Filter</a> と Linux のプリミティブな
1a389234e68da7c3d087b038307ed8c66fc6dc32Thiemo Wiedemeyer <code>TCP_DEFER_ACCEPT</code> のみです。</p>
f059d29e63508be7316ac161428eee7fc804736eChristian Maeder
1c039dc13801bb9c90ad6a1bac0e56af19fd2fbfMihai Codescu <p>FreeBSD のデフォルト値は :</p>
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder <example>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer AcceptFilter http httpready <br/>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer AcceptFilter https dataready
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer </example>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
3a6decfd748f532d5cb03fbcb7a42fa37b0faab3Christian Maeder <p><code>httpready</code> Accept Filter は HTTP リクエスト全体を、
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer カーネルレベルでバッファリングします。リクエスト全体を受信し終わると、
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer その後サーバプロセスにそれを送ります。詳細については <a
1842453990fed8a1bd7a5ac792d7982c1d2bfcd5Christian Maeder href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&amp;sektion=9">accf_http(9)</a>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer を参照してください。HTTPS のリクエストは暗号化されているので <a
c208973c890b8f993297720fd0247bc7481d4304Christian Maeder href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&amp;sektion=9">accf_data(9)</a>
b6a59f004903ac7bc96323ee3ef09c01fd221157Christian Maeder フィルタのみが使用されます。</p>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
55c5e901b5c3466300009135585bc70bd576dcb6Christian Maeder <p>Linux でのデフォルト値は :</p>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <example>
ec25781c1180ea07f66b48c34f93cf5634e9277cChristian Maeder AcceptFilter http data <br/>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer AcceptFilter https data
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer </example>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <p>Linux の <code>TCP_DEFER_ACCEPT</code> は HTTP リクエストのバッファリングを
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder サポートしていません。<code>none</code> 以外の値で
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <code>TCP_DEFER_ACCEPT</code> が有効になります。詳細については Linux
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer man ページ <a
d1066b8fb69179973dcab47154858d77e72760a7Thiemo Wiedemeyer href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">tcp(7)</a>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer を参照してください。</p>
4e9e95ba35a68f3c767bc0b23ebf9e904e442517Christian Maeder
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p>引数に <code>none</code> を指定すると、プロトコルに対する全ての Accept
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer Filter が無効になります。<code>nntp</code> といった、先にサーバにデータを
3587928ae948e8505f5af052dd4dc7cd97b6638eChristian Maeder 送る必要のあるプロトコルに有効です :</p>
a7e5c17a679fa2dae5998cd04c7e9e06c05c8164Christian Maeder <example>AcceptFilter nntp none</example>
f9e0b18852b238ddb649d341194e05d7200d1bbeChristian Maeder
697e63e30aa3c309a1ef1f9357745111f8dfc5a9Christian Maeder</usage>
1e3aca4178372af672efb237d16087c603fe5564Christian Maeder</directivesynopsis>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
4b136ad539bd9f4e115dff4eee4d552a42d4437eChristian Maeder<directivesynopsis>
f456529a89bfb620d39e5fd5b0a53b24643db96dDominik Luecke<name>AcceptPathInfo</name>
a79266feb130561fa1a95ae0429d0574f625f6ceChristian Maeder<description>後に続くパス名情報を受け付けるリソースの指定</description>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<syntax>AcceptPathInfo On|Off|Default</syntax>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<default>AcceptPathInfo Default</default>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<contextlist><context>server config</context>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<context>virtual host</context><context>directory</context>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<context>.htaccess</context></contextlist>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<override>FileInfo</override>
0d0278c34a374b29c2d6c58b39b8b56e283d48e8Christian Maeder<compatibility>Apache 2.0.30 以降で使用可能</compatibility>
2028dc2c091bb60343e15985948a59b955276cbfChristian Maeder
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<usage>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
16e45483b5ce48f0b92d01c817242a8c9b8bae02Christian Maeder <p>このディレクティブは実際のファイル名 (もしくは存在するディレクトリの
ddc662fdf0207eae2034d7b68ae5e2225c575207Thiemo Wiedemeyer 存在しないファイル) の後に続くパス名情報があるリクエストを受け付けるか
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 拒否するかを制御します。続きのパス名情報はスクリプトには <code>PATH_INFO</code>
28ca54b0d63d1d26a991711c8c7e85c474994715Christian Maeder 環境変数として利用可能になります。</p>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <p>例えば、<code>/test/</code> が、<code>here.html</code> というファイル
02a84229da51532505a93fc2abfca1ccf81b4446Razvan Pascanu 一つのみがあるディレクトリを指しているとします。そうすると、
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <code>/test/here.html/more</code> と <code>/test/nothere.html/more</code>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer へのリクエストは両方とも <code>/more</code> を <code>PATH_INFO</code> とします。</p>
331603b37dec12e37e2e1df9634ef0f2c5c73ddfThiemo Wiedemeyer
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <p><directive>AcceptPathInfo</directive> ディレクティブに指定可能な
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer 三つの引数は:</p>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer
331603b37dec12e37e2e1df9634ef0f2c5c73ddfThiemo Wiedemeyer <dl>
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer <dt><code>Off</code></dt><dd>リクエストは存在するパスにそのまま
331603b37dec12e37e2e1df9634ef0f2c5c73ddfThiemo Wiedemeyer マップされる場合にのみ受け付けられます。ですから、上の例の
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <code>/test/here.html/more</code> のように、本当のファイル名の
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer 後にパス名情報が続くリクエストには 404 NOT FOUND エラーが返ります。</dd>
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer
331603b37dec12e37e2e1df9634ef0f2c5c73ddfThiemo Wiedemeyer <dt><code>On</code></dt><dd>前の方のパスが存在するファイルにマップする場合は
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer リクエストが受け付けられます。上の例の <code>/test/here.html/more</code>
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer は <code>/test/here.html</code> が有効なファイルにマップすれば
d71a37fb09bce02af6c98e7a5ab0aa5639058e4fThiemo Wiedemeyer 受け付けられます。</dd>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <dt><code>Default</code></dt><dd>続きのパス名情報の扱いはリクエストの
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <a href="/handler.html">ハンドラ</a>で決まります。
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu 普通のファイルのためのコアハンドラのデフォルトは <code>PATH_INFO</code> を拒否します。
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <a href="mod_cgi.html">cgi-script</a> や <a
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer href="mod_isapi.html">isapi-handler</a> のようにスクリプトを扱うハンドラは
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer 一般的にデフォルトで <code>PATH_INFO</code> を受け付けます。</dd>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer </dl>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <p><code>AcceptPathInfo</code> の主な目的はハンドラの <code>PATH_INFO</code> を
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer 受け付けるか拒否するかの選択を上書きできるようにすることです。
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer 例えば、これは例えば <a href="mod_include.html">INCLUDES</a> のような
e49fd57c63845c7806860a9736ad09f6d44dbaedChristian Maeder <a href="/filter.html">フィルタ</a>を使って <code>PATH_INFO</code> に
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer 基づいてコンテンツを生成しているときに必要になります。</p>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer
0b8b26a22f136a9b2a8e99d655f6fe6b0b96008cThiemo Wiedemeyer <example>
0b8b26a22f136a9b2a8e99d655f6fe6b0b96008cThiemo Wiedemeyer &lt;Files "mypaths.shtml"&gt;<br />
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <indent>
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer Options +Includes<br />
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer SetOutputFilter INCLUDES<br />
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer AcceptPathInfo On<br />
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer </indent>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder &lt;/Files&gt;
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer </example>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer</usage>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer</directivesynopsis>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<directivesynopsis>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<name>AccessFileName</name>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<description>分散設定ファイルの名前</description>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<syntax>AccessFileName <var>filename</var> [<var>filename</var>] ...</syntax>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<default>AccessFileName .htaccess</default>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<contextlist><context>server config</context><context>virtual host</context>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer</contextlist>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer<usage>
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <p>リクエストを処理するとき、サーバはディレクトリに
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer 対して分散設定ファイルが<a href="#allowoverride">有効になっていれば</a>、
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer そのドキュメントへの
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer パス上にある全てのディレクトリから、ここで指定された名前の一覧の中で
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer 最初に見つかったファイルをそれぞれ設定ファイルとして読み込みます。例えば:</p>
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <example>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder AccessFileName .acl
0b8b26a22f136a9b2a8e99d655f6fe6b0b96008cThiemo Wiedemeyer </example>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <p>という設定があると、以下のようにして無効にされていない限り、
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer ドキュメント <code>/usr/local/web/index.html</code>
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer を返す前に、サーバは <code>/.acl</code>, <code>/usr/.acl</code>,
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <code>/usr/local/.acl</code>, <code>/usr/local/web/.acl</code> から
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer ディレクティブを読み込みます。</p>
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <example>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer &lt;Directory /&gt;<br />
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <indent>
d71a37fb09bce02af6c98e7a5ab0aa5639058e4fThiemo Wiedemeyer AllowOverride None<br />
d71a37fb09bce02af6c98e7a5ab0aa5639058e4fThiemo Wiedemeyer </indent>
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer &lt;/Directory&gt;
d71a37fb09bce02af6c98e7a5ab0aa5639058e4fThiemo Wiedemeyer </example>
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer</usage>
39a2520d13a7d43f0c0fa71b94255c3f7c500005Christian Maeder<seealso><directive module="core">AllowOverride</directive></seealso>
39a2520d13a7d43f0c0fa71b94255c3f7c500005Christian Maeder<seealso><a href="/configuring.html">設定ファイル</a></seealso>
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer<seealso><a href="/howto/htaccess.html">.htaccess ファイル</a></seealso>
d71a37fb09bce02af6c98e7a5ab0aa5639058e4fThiemo Wiedemeyer</directivesynopsis>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<directivesynopsis>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<name>AddDefaultCharset</name>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<description>レスポンスのコンテントタイプが <code>text/plain</code> あるいは
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<code>text/html</code> の場合に追加するデフォルトの charset パラメータ</description>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<syntax>AddDefaultCharset On|Off|<var>charset</var></syntax>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<default>AddDefaultCharset Off</default>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<contextlist><context>server config</context>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<context>virtual host</context><context>directory</context>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer<context>.htaccess</context></contextlist>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer<override>FileInfo</override>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer
92e96be605537638d75e9d3023ab698bd89cf889Thiemo Wiedemeyer<usage>
92e96be605537638d75e9d3023ab698bd89cf889Thiemo Wiedemeyer <p>レスポンスのコンテントタイプが <code>text/plain</code>
fa1bf658051ac503f27ff1b59edb093398eed6edThiemo Wiedemeyer あるいは <code>text/html</code>
fa1bf658051ac503f27ff1b59edb093398eed6edThiemo Wiedemeyer の場合に限りますが、レスポンスに追加するメディアタイプの文字セットパラメータ
fa1bf658051ac503f27ff1b59edb093398eed6edThiemo Wiedemeyer (文字エンコーディングの名前) のデフォルト値を、このディレクティブで指定します。
d24317c8197e565e60c8f41309de246249c1e57eChristian Maeder これはレスポンス <transnote>レスポンスの HTML</transnote> 内で <code>META</code>
fa1bf658051ac503f27ff1b59edb093398eed6edThiemo Wiedemeyer 要素で指定された、どのような文字セットも無効にしますが、
92e96be605537638d75e9d3023ab698bd89cf889Thiemo Wiedemeyer 最終的な挙動はユーザのクライアント側の設定で決まります。
92e96be605537638d75e9d3023ab698bd89cf889Thiemo Wiedemeyer この機能は <code>AddDefaultCharset Off</code> という設定で無効になります。
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <code>AddDefaultCharset On</code> にすれば、
0d0278c34a374b29c2d6c58b39b8b56e283d48e8Christian Maeder Apache 内部のデフォルト文字セット <code>iso-8859-1</code> に設定されます。
92e96be605537638d75e9d3023ab698bd89cf889Thiemo Wiedemeyer その他 <var>charset</var> に指定できる値であれば、どんな値でも使えます。
92e96be605537638d75e9d3023ab698bd89cf889Thiemo Wiedemeyer 指定する値は、MIME メディアタイプとして使われる
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer <a href="http://www.iana.org/assignments/character-sets">IANA
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer に登録されている文字セット名</a>のうちの一つにすべきです。
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer 例えば:</p>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer <example>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer AddDefaultCharset utf-8
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer </example>
aa21e7aa42fef563dea0cc77edbde76f66cdbe88Thiemo Wiedemeyer
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <p><directive>AddDefaultCharset</directive> を使うときは、全てのテキストリソースが
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer 指定する文字エンコードになっていると分かっていて、かつ、
d9f20cf968e246ec283f0c09f60af4b47b174398Thiemo Wiedemeyer リソースの個々に文字セットを指定するのが大変な場合のみです。
d9f20cf968e246ec283f0c09f60af4b47b174398Thiemo Wiedemeyer 例を挙げると、レガシーな CGI スクリプトなどの、動的に生成される
d9f20cf968e246ec283f0c09f60af4b47b174398Thiemo Wiedemeyer コンテンツを含むリソースに文字セットパラメータを追加する場合で、
d9f20cf968e246ec283f0c09f60af4b47b174398Thiemo Wiedemeyer ユーザの入力データが出力に入り、クロスサイトスクリプティングが
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder 引き起こされうる場合です。デフォルト文字セットをセットしたとしても、
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder ブラウザの "文字エンコードの自動選択" 機能が有効になっているユーザを
d9f20cf968e246ec283f0c09f60af4b47b174398Thiemo Wiedemeyer 守ることにはならないので、もちろんより良い解決策は単にスクリプトを修正
d9f20cf968e246ec283f0c09f60af4b47b174398Thiemo Wiedemeyer (あるいは削除) することです。</p>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer</usage>
39a2520d13a7d43f0c0fa71b94255c3f7c500005Christian Maeder<seealso><directive module="mod_mime">AddCharset</directive></seealso>
4014fb09362f3e38a91d7bb11b1484a4790e9297Thiemo Wiedemeyer</directivesynopsis>
da1f9fa9339a0115d0559411929835bcff74e5f5Thiemo Wiedemeyer
39a2520d13a7d43f0c0fa71b94255c3f7c500005Christian Maeder<directivesynopsis>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<name>AddOutputFilterByType</name>
da1f9fa9339a0115d0559411929835bcff74e5f5Thiemo Wiedemeyer<description>MIME-type に出力フィルタを割り当てる</description>
da1f9fa9339a0115d0559411929835bcff74e5f5Thiemo Wiedemeyer<syntax>AddOutputFilterByType <var>filter</var>[;<var>filter</var>...] <var>MIME-type</var>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder[<var>MIME-type</var>] ...</syntax>
4014fb09362f3e38a91d7bb11b1484a4790e9297Thiemo Wiedemeyer<contextlist><context>server config</context>
da1f9fa9339a0115d0559411929835bcff74e5f5Thiemo Wiedemeyer<context>virtual host</context><context>directory</context>
4014fb09362f3e38a91d7bb11b1484a4790e9297Thiemo Wiedemeyer<context>.htaccess</context></contextlist>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<override>FileInfo</override>
3e3efd4ce838940032e875e6d08712a177c9c1d0Thiemo Wiedemeyer<compatibility>Apache 2.0.33 以降で使用可能; Apache 2.1 以降非推奨</compatibility>
3e3efd4ce838940032e875e6d08712a177c9c1d0Thiemo Wiedemeyer
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<usage>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <p>このディレクティブは応答の <glossary ref="mime-type">MIME タイプ</glossary> に応じて出力<a
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder href="/filter.html">フィルタ</a>を使用するようにします。
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder しかし後述する問題のため、このディレクティブは非推奨です。
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder 同等の機能は <module>mod_filter</module> で実現可能です。</p>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer <p>次の例は <module>mod_deflate</module> の <code>DEFLATE</code> フィルタを
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer 使っています。<code>text/html</code> と <code>text/plain</code> の
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder すべての出力 (静的なものも動的なものも) をクライアントに送られる前に
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer 圧縮します。</p>
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer <example>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder AddOutputFilterByType DEFLATE text/html text/plain
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer </example>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer <p>複数のフィルタでコンテンツを処理させたいときは、それぞれの名前をセミコロンで
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder 分ける必要があります。各フィルタに対して
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer <directive>AddOutputFilterByType</directive> を一つずつ書くこともできます。</p>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <p>次の例は <code>text/html</code> のスクリプトのすべての出力を
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder まず <code>INCLUDES</code> フィルタで処理し、さらに <code>DEFLATE</code> フィルタにかけます。</p>
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <example>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder &lt;Location /cgi-bin/&gt;<br />
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <indent>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer Options Includes<br />
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder </indent>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder &lt;/Location&gt;
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer </example>
80df5ce65c2bad7a0643106e524fe33cdcfab5b6Thiemo Wiedemeyer
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <note type="warning"><title>注:</title>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <p><directive>AddOutputFilterByType</directive> ディレクティブにより
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder 有効にしたフィルタは場合によっては、部分的もしくは完全に適用されないことが
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder あります。例えば、<glossary ref="mime-type">MIME タイプ</glossary> が決定できないときには
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <directive module="core">DefaultType</directive> の設定が同じだったとしても、
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <directive module="core">DefaultType</directive> 設定を使うようになります。</p>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <p>しかし、確実にフィルタが適用されるようにしたいときは、リソースに
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer 明示的にコンテントタイプを割り当てることができます。これには例えば
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer <directive module="mod_mime">AddType</directive> ディレクティブや
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer <directive module="core">ForceType</directive> ディレクティブを使います。
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer (nphでない) CGI スクリプトでコンテントタイプを設定するというものでも
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer 大丈夫です。</p>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder </note>
788bd3c33ec5aaeb90a1932c341ff837116410cfThiemo Wiedemeyer</usage>
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<seealso><directive module="core">SetOutputFilter</directive></seealso>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<seealso><a href="/filter.html">フィルタ</a></seealso>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer</directivesynopsis>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<directivesynopsis>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<name>AllowEncodedSlashes</name>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<description>URL 中の符号化されたパス分離文字が先に伝えられるのを許可するかどうかを
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder決定する</description>
370e81d7af7821f0ac6ee0643613e87a727841e7Thiemo Wiedemeyer<syntax>AllowEncodedSlashes On|Off</syntax>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<default>AllowEncodedSlashes Off</default>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<contextlist><context>server config</context><context>virtual host</context>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder</contextlist>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<compatibility>Apache 2.0.46 以降で使用可能</compatibility>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder
545d0cd78159cade346b579d06052638b19b0f72Thiemo Wiedemeyer<usage>
1a389234e68da7c3d087b038307ed8c66fc6dc32Thiemo Wiedemeyer <p><directive>AllowEncodedSlashes</directive> ディレクティブは符号化された
1a389234e68da7c3d087b038307ed8c66fc6dc32Thiemo Wiedemeyer パス分離文字 (<code>/</code> は <code>%2F</code>、さらにシステムによっては
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer <code>\</code> に対応する <code>%5C</code>) が存在する URL の使用を
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer 許可するかどうかを決定します。通常はそのような URL は 404 (Not found) エラー
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu で拒否されます。</p>
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <p><directive>AllowEncodedSlashes</directive> <code>On</code> による
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu パス分離文字の使用は、<code>PATH_INFO</code> と合わせて
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu 使うときに一番役に立ちます。</p>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <note><title>注</title>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <p>符号化されたスラッシュを許可することは、<em>復号</em>をすることを
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu 意味<em>しません</em>。<code>%2F</code> や (関係するシステムでの)
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <code>%5C</code> は、他の部分が復号された URL の中でもそのままの形式で
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer 残されます。</p>
1a389234e68da7c3d087b038307ed8c66fc6dc32Thiemo Wiedemeyer </note>
1a389234e68da7c3d087b038307ed8c66fc6dc32Thiemo Wiedemeyer</usage>
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer<seealso><directive module="core">AcceptPathInfo</directive></seealso>
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer</directivesynopsis>
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer
8836fa284a241af325aa6f41234b5130b26ec4f9Thiemo Wiedemeyer<directivesynopsis>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer<name>AllowOverride</name>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer<description><code>.htaccess</code> で許可されるディレクティブの種類</description>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer<syntax>AllowOverride All|None|<var>directive-type</var>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer[<var>directive-type</var>] ...</syntax>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu<default>AllowOverride All</default>
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder<contextlist><context>directory</context></contextlist>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder<usage>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <p>サーバが (<directive
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer module="core">AccessFileName</directive> によって指定された)
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <code>.htaccess</code> ファイルを見つけた時、そのファイルの中で
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 宣言されたどのディレクティブがより前に定義された設定ディレクティブを
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 上書きできるかを知る必要があります。</p>
109b67ffce2bad83667e2f4a319d2d7f380f91afThiemo Wiedemeyer
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <note><title>&lt;Directory&gt; セクションでのみ使用可能</title>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer <directive>AllowOverride</directive> は正規表現無しの<directive
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer type="section" module="core">Directory</directive>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer セクションでのみ有効で、<directive type="section"
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer module="core">Location</directive> や <directive
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer module="core" type="section">DirectoryMatch</directive>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer や <directive type="section"
2a9702a373738717c83824512bd9389b5870fc92Christian Maeder module="core">Files</directive> セクションでは無効です。
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer </note>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p>このディレクティブを <code>None</code> に設定すると、<a href="#accessfilename">.htaccess</a> ファイルは完全に
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer 無視されます。
f39c70229e74147a02d15bd45c05a0b1b325532dChristian Maeder この場合、サーバはファイルシステムの <code>.htaccess</code> ファイルを読むことを
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 試みさえしません。</p>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
d1066b8fb69179973dcab47154858d77e72760a7Thiemo Wiedemeyer <p>このディレクティブが <code>All</code> に設定されている時には、
d1066b8fb69179973dcab47154858d77e72760a7Thiemo Wiedemeyer <code>.htaccess</code> という <a
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder href="directive-dict.html#Context">コンテキスト</a> を持つ
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 全てのディレクティブが利用できます。</p>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p><var>directive-type</var> には、以下のディレクティブ群の
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer キーワードのどれかを指定します。</p>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <dl>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <dt>AuthConfig</dt>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <dd>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer 認証に関するディレクティブの使用を許可する (<directive
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer module="mod_authn_dbm">AuthDBMGroupFile</directive>,
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder <directive module="mod_authn_dbm">AuthDBMUserFile</directive>,
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <directive module="mod_authz_groupfile">AuthGroupFile</directive>,
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <directive module="mod_authn_core">AuthName</directive>,
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <directive module="mod_authn_core">AuthType</directive>, <directive
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer module="mod_authn_file">AuthUserFile</directive>, <directive
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer module="mod_authz_core">Require</directive> <em>など</em>)。</dd>
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <dt>FileInfo</dt>
28ca54b0d63d1d26a991711c8c7e85c474994715Christian Maeder
1e3aca4178372af672efb237d16087c603fe5564Christian Maeder <dd>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer ドキュメントタイプを制御するためのディレクティブの使用を許可する (<directive
370e81d7af7821f0ac6ee0643613e87a727841e7Thiemo Wiedemeyer module="core">DefaultType</directive>, <directive
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer module="core">ErrorDocument</directive>, <directive
28ca54b0d63d1d26a991711c8c7e85c474994715Christian Maeder module="core">ForceType</directive>, <directive
3d3889e0cefcdce9b3f43c53aaa201943ac2e895Jonathan von Schroeder module="mod_negotiation">LanguagePriority</directive>,
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <directive module="core">SetHandler</directive>, <directive
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer module="core">SetInputFilter</directive>, <directive
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer module="core">SetOutputFilter</directive>,
c5f9e2f0598f061c50c7f097add808c0ec7d1feaLoredana Mihaela Diaconu <module>mod_mime</module> の Add* と Remove*
c5f9e2f0598f061c50c7f097add808c0ec7d1feaLoredana Mihaela Diaconu ディレクティブ<em>など</em>),
c5f9e2f0598f061c50c7f097add808c0ec7d1feaLoredana Mihaela Diaconu ドキュメントのメタデータ (<directive
966a6c024c828387023fccb0cd0049f78687e5dcThiemo Wiedemeyer module="mod_headers">Header</directive>, <directive
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu module="mod_headers">RequestHeader</directive>, <directive
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder module="mod_setenvif">SetEnvIf</directive>, <directive
1e3aca4178372af672efb237d16087c603fe5564Christian Maeder module="mod_setenvif">SetEnvIfNoCase</directive>, <directive
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer module="mod_setenvif">BrowserMatch</directive>, <directive
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer module="mod_usertrack">CookieExpires</directive>, <directive
966a6c024c828387023fccb0cd0049f78687e5dcThiemo Wiedemeyer module="mod_usertrack">CookieDomain</directive>, <directive
966a6c024c828387023fccb0cd0049f78687e5dcThiemo Wiedemeyer module="mod_usertrack">CookieStyle</directive>, <directive
79d103748927615310322af6f7806c7cef11a802Christian Maeder module="mod_usertrack">CookieTracking</directive>, <directive
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer module="mod_usertrack">CookieName</directive>),
4eefbf3ad21b510729d5423d08de513b310e9cd0Loredana Mihaela Diaconu <module>mod_rewrite</module> のディレクティブ <directive
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer module="mod_rewrite">RewriteEngine</directive>, <directive
4b136ad539bd9f4e115dff4eee4d552a42d4437eChristian Maeder module="mod_rewrite">RewriteOptions</directive>, <directive
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder module="mod_rewrite">RewriteBase</directive>, <directive
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu module="mod_rewrite">RewriteCond</directive>, <directive
c5f9e2f0598f061c50c7f097add808c0ec7d1feaLoredana Mihaela Diaconu module="mod_rewrite">RewriteRule</directive>) と
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <module>mod_actions</module> の
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder <directive module="mod_actions">Action</directive>
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder ディレクティブ。
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder </dd>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer <dt>Indexes</dt>
966a6c024c828387023fccb0cd0049f78687e5dcThiemo Wiedemeyer
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer <dd>
e49fd57c63845c7806860a9736ad09f6d44dbaedChristian Maeder ディレクトリインデックスを制御するためのディレクティブの使用を許可する
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer (<directive
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder module="mod_autoindex">AddDescription</directive>,
4b136ad539bd9f4e115dff4eee4d552a42d4437eChristian Maeder <directive module="mod_autoindex">AddIcon</directive>, <directive
c40b7badd217089d8a256dabdf8f7d4e219ca215Thiemo Wiedemeyer module="mod_autoindex">AddIconByEncoding</directive>,
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <directive module="mod_autoindex">AddIconByType</directive>,
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder <directive module="mod_autoindex">DefaultIcon</directive>, <directive
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder module="mod_dir">DirectoryIndex</directive>, <directive
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder module="mod_autoindex">FancyIndexing</directive>, <directive
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder module="mod_autoindex">HeaderName</directive>, <directive
38122cbf09ad3dcc31a826cc4093f630515a5cfcChristian Maeder module="mod_autoindex">IndexIgnore</directive>, <directive
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder module="mod_autoindex">IndexOptions</directive>, <directive
3587928ae948e8505f5af052dd4dc7cd97b6638eChristian Maeder module="mod_autoindex">ReadmeName</directive>
3587928ae948e8505f5af052dd4dc7cd97b6638eChristian Maeder <em>など</em>)。</dd>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder <dt>Limit</dt>
1e3aca4178372af672efb237d16087c603fe5564Christian Maeder
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer <dd>
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer ホストへのアクセス制御を行うためのディレクティブの使用を許可する (<directive
66b035879accdc5f8337726173f800286a87fd78Christian Maeder module="mod_authz_host">Allow</directive>, <directive
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder module="mod_authz_host">Deny</directive>, <directive
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder module="mod_authz_host">Order</directive>).</dd>
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <dt>Options[=<var>Option</var>,...]</dt>
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <dd>
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder 特定のディレクトリにおける機能を指定するためのディレクティブの使用を許可する
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer (<directive module="core">Options</directive> と
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <directive module="mod_include">XBitHack</directive>)。
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <directive module="core">Options</directive> で設定するオプション
1937dccb04b363364f7a7de17fdaae1d70583af9Christian Maeder を、(空白を含めない) コンマ区切りのリストにして等号の後に続けることで
1937dccb04b363364f7a7de17fdaae1d70583af9Christian Maeder 設定できます。</dd>
1937dccb04b363364f7a7de17fdaae1d70583af9Christian Maeder </dl>
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder <p>例:</p>
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder <example>
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder AllowOverride AuthConfig Indexes
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder </example>
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder <p>上の例では <code>AuthConfig</code> と <code>Indexes</code> のどちらにも
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder 属さないディレクティブはすべて内部サーバエラーを引き起こします。</p>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer</usage>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
83263d411f611d9902ef4d98c93be6ad9361c833Christian Maeder<seealso><directive module="core">AccessFileName</directive></seealso>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<seealso><a href="/configuring.html">設定ファイル</a></seealso>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer<seealso><a href="/howto/htaccess.html">.htaccess ファイル</a></seealso>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer</directivesynopsis>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<directivesynopsis>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<name>CGIMapExtension</name>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<description>CGI スクリプトのインタープリタの位置を調べるための手法</description>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<syntax>CGIMapExtension <var>cgi-path</var> <var>.extension</var></syntax>
1937dccb04b363364f7a7de17fdaae1d70583af9Christian Maeder<contextlist><context>directory</context><context>.htaccess</context>
c1d06b3018b34ede2b3fb6c7fe2ad28cd5ce5b68Christian Maeder</contextlist>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<override>FileInfo</override>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<compatibility>NetWare のみ</compatibility>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<usage>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p>このディレクティブは Apache が CGI スクリプトを実行するための
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer インタープリタを探す方法を制御します。
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer 例えば、<code>CGIMapExtension sys:\foo.nlm .foo</code> と設定すると
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <code>.foo</code> という拡張子のすべての CGI スクリプトは FOO インタープリタに
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer 渡されます。</p>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer</usage>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer</directivesynopsis>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<directivesynopsis>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<name>ContentDigest</name>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<description><code>Content-MD5</code> HTTP 応答ヘッダの生成を有効にする</description>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<syntax>ContentDigest On|Off</syntax>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<default>ContentDigest Off</default>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<contextlist><context>server config</context><context>virtual host</context>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<context>directory</context><context>.htaccess</context>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer</contextlist>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<override>Options</override>
c1d06b3018b34ede2b3fb6c7fe2ad28cd5ce5b68Christian Maeder<status>Experimental</status>
c1d06b3018b34ede2b3fb6c7fe2ad28cd5ce5b68Christian Maeder
1937dccb04b363364f7a7de17fdaae1d70583af9Christian Maeder<usage>
1937dccb04b363364f7a7de17fdaae1d70583af9Christian Maeder <p>このディレクティブは、RFC1864 及び RFC2616 において定義されている
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer <code>Content-MD5</code> ヘッダーの生成を有効にします。</p>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <p>MD5 は、任意長のデータの「メッセージダイジェスト」(「指紋」
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer と表現されることもある) を計算するアルゴリズムで、
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer データの変更があった場合には非常に高い信頼度でメッセージダイジェストに変更が
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer 反映されます。</p>
a2af8492313011f78cbedbfd302dc12150b9f7efChristian Maeder
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p><code>Content-MD5</code> ヘッダは、エンドツーエンドで
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer エンティティボディーに含まれるメッセージの完全性チェック
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer (Message Integrity Check - MIC)を提供します。
a7e5c17a679fa2dae5998cd04c7e9e06c05c8164Christian Maeder このヘッダを調べることで、プロキシやクライアントは、
c1d06b3018b34ede2b3fb6c7fe2ad28cd5ce5b68Christian Maeder 途中経路におけるエンティティボディの予期せぬ変更などを
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 検出することができます。ヘッダの例:</p>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder
c41a1c38edbd787d8fd12b9b5f11b73a37dafe0fChristian Maeder <example>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
a7e5c17a679fa2dae5998cd04c7e9e06c05c8164Christian Maeder </example>
260bfc3b7dc8ed037b7d98ee044302415db6fcd7Christian Maeder
c41a1c38edbd787d8fd12b9b5f11b73a37dafe0fChristian Maeder <p>リクエスト毎にメッセージダイジェストを計算する (値はキャッシュされません)
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer ことから、
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer サーバパフォーマンスが低下することについて注意してください。</p>
a7e5c17a679fa2dae5998cd04c7e9e06c05c8164Christian Maeder
260bfc3b7dc8ed037b7d98ee044302415db6fcd7Christian Maeder <p><code>Content-MD5</code >は、<module>core</module> 機能により処理された
c41a1c38edbd787d8fd12b9b5f11b73a37dafe0fChristian Maeder ドキュメントを送るときのみ有効であり、
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer SSI ドキュメントや CGI スクリプトの出力、バイトレンジを指定した
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer 応答の場合にはこのヘッダは付与されません。
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer </p>
dbd5da92be2bc4a8afcaa21980a5f59831037171Thiemo Wiedemeyer</usage>
dbd5da92be2bc4a8afcaa21980a5f59831037171Thiemo Wiedemeyer</directivesynopsis>
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer
eb600800c6f539148144444c14bf6354b6eaf0ceChristian Maeder<directivesynopsis>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht<name>DefaultType</name>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht<description>サーバがコンテントタイプを決定できないときに
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht送られる MIME コンテントタイプ</description>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht<syntax>DefaultType <var>MIME-type|none</var></syntax>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht<default>DefaultType text/plain</default>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<contextlist><context>server config</context><context>virtual host</context>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer<context>directory</context><context>.htaccess</context>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht</contextlist>
3587928ae948e8505f5af052dd4dc7cd97b6638eChristian Maeder<override>FileInfo</override>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht<compatibility>引数 <code>none</code> は Apache 2.2.7 以降で利用可能</compatibility>
3587928ae948e8505f5af052dd4dc7cd97b6638eChristian Maeder<usage>
cc31ad5864570db2fc7b2cb3e04810c8727d145aChristian Maeder <p>サーバは、<glossary ref="mime-type">MIME タイプ</glossary>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer のマップからは決定できないドキュメントの送信を要求されることがあります。</p>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p>サーバは、ドキュメントのコンテントタイプをクライアントに通知するべきです。
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer サーバで通常の方法ではこれが判定できない場合は、
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <code>DefaultType</code> で指定されたタイプを利用します。
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer 例:</p>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht <example>
3587928ae948e8505f5af052dd4dc7cd97b6638eChristian Maeder DefaultType image/gif
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht </example>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht <p>これは <code>.gif</code> という拡張子がファイル名に含まれていない
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht 多くの GIF 画像が含まれているディレクトリに適しているでしょう。</p>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht <p>サーバでも管理者でも判定することができない (例えばプロクシの) 場合、
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht 誤った情報を与えるよりは MIME タイプの指定がない状態が望ましいことも
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht あります。この場合は次のようにします :</p>
9cfd9e8213e51ea282e68509183fb023aba59491Simon Ulbricht <example>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer DefaultType None
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer </example>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p><code>DefaultType None</code> は httpd-2.2.7
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer 以降でのみ利用できます。</p>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer <p><directive module="core">ForceType</directive> ディレクティブと
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer 違って、このディレクティブはデフォルトの MIME タイプを提供するだけで
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer あることに注意してください。ファイル名の拡張子を含め、
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer メディアタイプを決定できる他の MIME タイプの定義があれば
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer このデフォルトは上書きされます。</p>
f7b9d64160c23654b7288a3b0ee3e2b95af3e752Thiemo Wiedemeyer</usage>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer</directivesynopsis>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer
95cb954c00f873306bf1a60b62d3209d3cff4102Christian Maeder<directivesynopsis>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer<name>Define</name>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer<description>変数の存在を宣言する</description>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer<syntax>Define <var>parameter-name</var></syntax>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer<contextlist><context>server config</context></contextlist>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer<usage>
56f49c2883b1da5b18c57ca94457b2c4757a28d3Markus Gross <p><program>httpd</program> の <code>-D</code>
56f49c2883b1da5b18c57ca94457b2c4757a28d3Markus Gross 引数と同じものです。</p>
56f49c2883b1da5b18c57ca94457b2c4757a28d3Markus Gross <p>このディレクティブを使うと、スタートアップスクリプトに
56f49c2883b1da5b18c57ca94457b2c4757a28d3Markus Gross 記載されている <code>-D</code> 引数を書き換える必要なく、
039763ad866bb92d1818e09d1e5a0491af5af3d9Christian Maeder <directive module="core" type="section">IfDefine</directive>
039763ad866bb92d1818e09d1e5a0491af5af3d9Christian Maeder セクションを切り替えることができます。</p>
039763ad866bb92d1818e09d1e5a0491af5af3d9Christian Maeder</usage>
039763ad866bb92d1818e09d1e5a0491af5af3d9Christian Maeder</directivesynopsis>
cc8cec541a2ff37538daa477997ec8040ab257acChristian Maeder
cc8cec541a2ff37538daa477997ec8040ab257acChristian Maeder<directivesynopsis type="section">
56f49c2883b1da5b18c57ca94457b2c4757a28d3Markus Gross<name>Directory</name>
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer<description>指定のファイルシステムのディレクトリとサブディレクトリとのみに
0cdeccb66730b876f73bddd2705ddc62e180320dThiemo Wiedemeyer適用されるディレクティブを囲む</description>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<syntax>&lt;Directory <var>directory-path</var>&gt;
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder... &lt;/Directory&gt;</syntax>
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross<contextlist><context>server config</context><context>virtual host</context>
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross</contextlist>
eb600800c6f539148144444c14bf6354b6eaf0ceChristian Maeder
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross<usage>
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross <p>指定されたディレクトリとそのサブディレクトリにのみ
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross ディレクティブを適用させるためには、
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <directive type="section">Directory</directive> と
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <code>&lt;/Directory&gt;</code> を対として、ディレクティブ群を囲います。
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer その中には、ディレクトリコンテキストで許可された全てのディレクティブを
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer 利用できます。
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <var>directive-path</var> は、フルパスもしくは Unix のシェル形式の
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer ワイルドカードを指定します。
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <code>?</code> は任意の 1 文字、<code>*</code> は任意の文字列にマッチします。
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross シェルにおける指定同様、文字の範囲を <code>[]</code> で指定できます。
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer ワイルドカードは `/' 文字にはマッチしませんので、
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <code>/home/user/public_html</code> には
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <code>&lt;Directory /*/public_html&gt;</code> はマッチしませんが、
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <code>&lt;Directory /home/*/public_html&gt;</code> はマッチします。
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer 例:</p>
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer
92d79cd0ad22cf74b345e1381d806ffc364d9ea1Thiemo Wiedemeyer <example>
eb600800c6f539148144444c14bf6354b6eaf0ceChristian Maeder &lt;Directory /usr/local/httpd/htdocs&gt;<br />
9a9860760c6f30558e5e60049692b6fc63904590Markus Gross <indent>
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder Options Indexes FollowSymLinks<br />
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder </indent>
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder &lt;/Directory&gt;
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder </example>
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder <note>
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder <p><var>directory-path</var> 引数には注意してください: その引数は
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder Apache がファイルをアクセスするために使うファイルシステムのパスに
888fefaddbeb8d75a861b1d689b191b44d1853e1Thiemo Wiedemeyer そのままマッチする必要があります。ある <code>&lt;Directory&gt;</code> に
9b01b265715d725c17d51619d297bbb97f37d1b5Thiemo Wiedemeyer 適用されるディレクティブは、別のシンボリックリンクをたどったりして
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder 同じディレクトリを違うパスでアクセスした場合には適用されません。</p>
4b136ad539bd9f4e115dff4eee4d552a42d4437eChristian Maeder </note>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
521045d36343cd17dd217a81d4b9422ad6ab6a07Christian Maeder <p><code>~</code> という文字を
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder 付加することで<glossary ref="regex">正規表現</glossary>を利用することもできます。
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder 例えば:</p>
28ca54b0d63d1d26a991711c8c7e85c474994715Christian Maeder
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder <example>
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder &lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder </example>
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder <p>といった指定の場合、<code>/www/</code> 以下にある数字
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder 3 文字のディレクトリにマッチします。</p>
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder
611c5a1783d95809487402fc94cb466aa4c7f300Markus Gross <p>もし複数の (正規表現以外の) <directive type="section"
611c5a1783d95809487402fc94cb466aa4c7f300Markus Gross >Directory</directive>セクションが
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder ドキュメントを含むディレクトリ (やその上位ディレクトリのどれか) とマッチしたならば、
eb600800c6f539148144444c14bf6354b6eaf0ceChristian Maeder <a
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder href="#accessfilename">.htaccess</a> ファイルのディレクティブも読み込みつつ、
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder 短いパスから順に適用されます。
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder 例えば、</p>
28ca54b0d63d1d26a991711c8c7e85c474994715Christian Maeder
28ca54b0d63d1d26a991711c8c7e85c474994715Christian Maeder <example>
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder &lt;Directory /&gt;<br />
8618f6dc90d5392c661114468b47c71e4ae4e9beChristian Maeder <indent>
d7aa4e1cbe00f7f3add4da911673b3b176b140c3Thiemo Wiedemeyer AllowOverride None<br />
eb600800c6f539148144444c14bf6354b6eaf0ceChristian Maeder </indent>
f456529a89bfb620d39e5fd5b0a53b24643db96dDominik Luecke &lt;/Directory&gt;<br />
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder <br />
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder &lt;Directory /home/&gt;<br />
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder <indent>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder AllowOverride FileInfo<br />
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder </indent>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder &lt;/Directory&gt;
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder </example>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder <p>と設定し、ドキュメント <code>/home/web/dir/doc.html</code> への
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder アクセスがあった場合には以下のように動作します:</p>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder <ul>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder <li><code>AllowOverride None</code> が適用される。
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder (<code>.htaccess</code> ファイルは無効になる)</li>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <li><code>AllowOverride FileInfo</code> が適用される
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder (<code>/home</code> ディレクトリに対して)。</li>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder <li><code>/home/.htaccess</code>, <code>/home/web/.htaccess</code>,
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu <code>/home/web/dir/.htaccess</code> の順にそれらのファイル中の
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu FileInfo ディレクティブが適用される。</li>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer </ul>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <p>正規表現は、通常のセクションがすべて適用されるまで
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu 考慮されません。
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu その後、全ての正規表現が設定ファイルに現れた順で試されます。
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu 例えば、以下のような場合に</p>
8bdd8707c8e341f1fc57fcbf884520bfe06a5028Christian Maeder
f059d29e63508be7316ac161428eee7fc804736eChristian Maeder <example>
f059d29e63508be7316ac161428eee7fc804736eChristian Maeder &lt;Directory ~ abc$&gt;<br />
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <indent>
53e76316f409f6b1b57ed3d2e5cb9cfe1cb511e5Thiemo Wiedemeyer # ... directives here ...<br />
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer </indent>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer &lt;/Directory&gt;
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer </example>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <p>正規表現のセクションはすべての通常の <directive
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer type="section">Directory</directive> と
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <code>.htaccess</code> の適用が終わるまで考慮されません。
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer その後で、正規表現は <code>/home/abc/public_html/abc</code> にマッチし、
1e3aca4178372af672efb237d16087c603fe5564Christian Maeder 対応する <directive type="section">Directory</directive> が適用されます。</p>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <p><strong>Apache のデフォルトでは <code>&lt;Directory /&gt;</code> へのアクセスは
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <code>Allow from All</code> になっていることに注意してください。
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer これは、URL からマップされたどのファイルでも Apache は送るということです。
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer これは以下のようにして変更することが推奨されています。</strong></p>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <example>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer &lt;Directory /&gt;<br />
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <indent>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer Order Deny,Allow<br />
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer Deny from All<br />
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer </indent>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer &lt;/Directory&gt;
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer </example>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <p><strong>そしてアクセスを<em>可能にしたい</em>ディレクトリに対して
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer 個別に設定すればよいでしょう。
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer このあたりについては、<a
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer href="/misc/security_tips.html">セキュリティに関するコツ</a>を
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer 参照してください。</strong></p>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer
1e3aca4178372af672efb237d16087c603fe5564Christian Maeder <p>ディレクトリセクションは <code>httpd.conf</code> ファイルに書きます。
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <directive type="section">Directory</directive>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer ディレクティブは入れ子にすることができず、
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer <directive module="core" type="section">Limit</directive> や <directive
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer module="core" type="section">LimitExcept</directive> セクションの中にも
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer 記述できません。</p>
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer
b021998bf955c87c7cdcc69f0667dc2880b3ce1fThiemo Wiedemeyer</usage>
c7e03d0708369f944b6f235057b39142a21599f2Mihai Codescu<seealso>リクエストを受けた際にこれらの異なるセクションが
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer 組み合わされる方法については <a href="/sections.html">
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer</directivesynopsis>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer<directivesynopsis type="section">
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu<name>DirectoryMatch</name>
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder<description>正規表現にマッチするファイルシステムのディレクトリと
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanuサブディレクトリとのみに適用されるディレクティブを囲む</description>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer<syntax>&lt;DirectoryMatch <var>regex</var>&gt;
a79266feb130561fa1a95ae0429d0574f625f6ceChristian Maeder... &lt;/DirectoryMatch&gt;</syntax>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<contextlist><context>server config</context><context>virtual host</context>
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer</contextlist>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu<usage>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer <p><directive module="core" type="section">Directory</directive>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer ディレクティブと同様に、<directive type="section">DirectoryMatch</directive>
93eeaffa1087fc6eae3f19b8ca5affb7802799fdThiemo Wiedemeyer と <code>&lt;/DirectoryMatch&gt;</code> は指定されたディレクトリと
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer そのサブディレクトリにのみ適用されるディレクティブ群を囲います。
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer しかし、このディレクティブは引数として<glossary
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer ref="regex">正規表現</glossary>をとります。例えば:</p>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer <example>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer &lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}"&gt;
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer </example>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <p>は <code>/www/</code> 以下にある数字 3 文字のディレクトリにマッチします。</p>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder</usage>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu<seealso>通常の <directive type="section">Directory</directive> と正規表現の指定が
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu適用される順番については <directive type="section"
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanumodule="core">Directory</directive></seealso>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder<seealso>リクエストを受けた際にこれらの異なるセクションが
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer 組み合わされる方法については <a href="/sections.html">
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder</directivesynopsis>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer<directivesynopsis>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu<name>DocumentRoot</name>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer<description>ウェブから見えるメインのドキュメントツリーになる
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyerディレクトリ</description>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<syntax>DocumentRoot <var>directory-path</var></syntax>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<default>DocumentRoot /usr/local/apache/htdocs</default>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<contextlist><context>server config</context><context>virtual host</context>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer</contextlist>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<usage>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer <p>このディレクティブは、<program>httpd</program>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer がファイルを提供するディレクトリを設定します。
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer <directive module="mod_alias">Alias</directive> のようなディレクティブにマッチしない場合には、
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer ドキュメントの (訳注:ファイルシステム上の) パスを生成するために、
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer リクエストされた URL のパス部分をドキュメントルートに付与します。
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer 例:</p>
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <example>
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder DocumentRoot /usr/web
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer </example>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer <p>この場合、
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer <code>http://www.my.host.com/index.html</code> へのアクセスがあれば
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer <code>/usr/web/index.html</code> が返されます。
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer <var>directory-path</var> が絶対パスでない場合は、
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer <directive module="core">ServerRoot</directive>
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder からの相対パスとみなされます。</p>
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder <p><directive>DocumentRoot</directive> は最後のスラッシュ無しで
71654489020a03cf6ce9f2947f3da26a996f9c32Razvan Pascanu 指定する必要があります。</p>
a4e6fb26100f53e3b1e9f5b97c2e0a0c129294e5Christian Maeder</usage>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer<seealso><a href="/urlmapping.html#documentroot">URL をファイルシステムの位置に
1ac36418f204bbe56f4cd951a979180721758999Christian Maederマップする</a></seealso>
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder</directivesynopsis>
44c1fff98bd6c54db237bef5030657d3f47058a5Thiemo Wiedemeyer
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder<directivesynopsis>
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder<name>EnableMMAP</name>
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder<description>配送中にファイルを読み込むためにメモリマッピングを
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer使うかどうか</description>
32d98ca5e560cf6c1062a0463be4c350af32bed5Thiemo Wiedemeyer<syntax>EnableMMAP On|Off</syntax>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer<default>EnableMMAP On</default>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer<contextlist><context>server config</context><context>virtual host</context>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<context>directory</context><context>.htaccess</context>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer</contextlist>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer<override>FileInfo</override>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer<usage>
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer <p>このディレクティブは配送中にファイルの内容を読み込む必要があるときに
84ba39232a012abf2085c8a421ebce6abc52d56eThiemo Wiedemeyer <program>httpd</program> がメモリマッピングを使うかどうかを制御します。
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer デフォルトでは、
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer 例えば、<module>mod_include</module> を使って SSI ファイルを配送
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder するときのように、ファイルの途中のデータをアクセスする必要があるときには
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder Apache は OS がサポートしていればファイルをメモリにマップします。</p>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder <p>
8f5219469b89a15dc6d4c2c30463775975f5841cRazvan Pascanu このメモリマップは性能の向上を持たらすことがあります。
239991d3955da0cfb760af4d506069446e1676b7Christian Maeder しかし、環境によっては運用上の問題を防ぐためにメモリマッピングを
1ac36418f204bbe56f4cd951a979180721758999Christian Maeder 使用しないようにした方が良い場合もあります:</p>
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer
7ae38566aaf40710cd83ffa3ba25655c4ad22741Thiemo Wiedemeyer <ul>
66fd8f017efdb8a6c862c3f1856dfaef90865dd5Thiemo Wiedemeyer <li>マルチプロセッサシステムの中にはメモリマッピングをすると
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <program>httpd</program> の性能が落ちるものがあります。</li>
ea76e25262c3325f293fbdd6560f180ca18f9be4Thiemo Wiedemeyer <li>NFS マウントされた <directive module="core">DocumentRoot</directive>
f5b31c8df89d0c8898cfabe0bd6c671e8285c0f1Christian Maeder では、<program>httpd</program> がメモリマップしている間にファイルが削除されたり
79d103748927615310322af6f7806c7cef11a802Christian Maeder 短くなったりしたときに起こるセグメンテーションフォールトのために
<program>httpd</program> がクラッシュする可能性があります。</li>
</ul>
<p>これらの問題に当てはまるサーバの設定の場合は、以下のようにして
ファイルの配送時のメモリマッピングを使用不可にしてください:</p>
<example>
EnableMMAP Off
</example>
<p>NFS マウントされたファイルには、問題のあるファイルにのみ明示的に
この機能を使用不可にします:</p>
<example>
&lt;Directory "/path-to-nfs-files"&gt;
<indent>
EnableMMAP Off
</indent>
&lt;/Directory&gt;
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>EnableSendfile</name>
<description>ファイルのクライアントへの配送時にカーネルの sendfile サポートを
使うかどうか</description>
<syntax>EnableSendfile On|Off</syntax>
<default>EnableSendfile On</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility>バージョン 2.0.44 以降で使用可能</compatibility>
<usage>
<p>このディレクティブはクライアントにファイルの内容を送るときに
<program>httpd</program> がカーネルの
sendfile サポートを使うかどうかを制御します。デフォルトでは、
例えば静的なファイルの配送のように、リクエストの処理にファイルの
途中のデータのアクセスを必要としないときには、Apache は OS が
サポートしていればファイルを読み込むことなく sendfile を使って
ファイルの内容を送ります。</p>
<p>sendfile は read と send を別々に行なうことと、バッファの割り当てを
回避します。しかし、プラットフォームやファイルシステムの中には
運用上の問題を避けるためにこの機能を使用不可にした方が良い場合があります:</p>
<ul>
<li>プラットフォームの中にはビルドシステムが検知できなかった、壊れた
sendfile のサポートが存在するものがあります。これは特に
バイナリが別のマシンでビルドされ、壊れた sendfile のあるマシンに
移動したときに起こります。</li>
<li>Linux では、sendfile を用いると、
IPv6 使用時に存在する特定ネットワークカードの TCP-checksum
オフロードのバグを踏んでしまいます。</li>
<li>Itanium 上の Linux では、sendfile では 2GB 以上の
ファイルを扱うことができません。</li>
<li>ネットワークマウントされた <directive module="core">DocumentRoot</directive>
(例えば NFS や SMB)
では、カーネルは自身のキャッシュを使ってネットワークからのファイルを
送ることができないことがあります。</li>
</ul>
<p>これらの問題に当てはまるサーバの設定の場合は、以下のようにして
この機能を使用不可にしてください:</p>
<example>
EnableSendfile Off
</example>
<p>NFS や SMB マウントされたファイルには、問題のあるファイルにのみ明示的に
この機能を使用不可にします:</p>
<example>
&lt;Directory "/path-to-nfs-files"&gt;
<indent>
EnableSendfile Off
</indent>
&lt;/Directory&gt;
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ErrorDocument</name>
<description>エラーが発生したときにサーバがクライアントに送るもの</description>
<syntax>ErrorDocument <var>error-code document</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility>Apache 2.0 ではテキストをクウォートする構文が以前のバージョンから
変わっています。</compatibility>
<usage>
<p>問題やエラーが発生したときの動作として、
Apache には以下の四つのうち一つの動作を設定することができます。</p>
<ol>
<li>Apache 標準の簡単なエラーメッセージを表示</li>
<li>自分で指定したメッセージを表示</li>
<li>問題やエラーの処理をする為に、自サーバ内の
<var>URL-path</var> へリダイレクト</li>
<li>問題やエラーの処理をする為に、外部の <var>URL</var> へリダイレクト</li>
</ol>
<p>最初のものがデフォルトの動作で、2 番目から 4 番目は、
<directive>ErrorDocument</directive>ディレクティブにより、
HTTP のレスポンスコードと、メッセージか URL を指定することで設定します。
Apache が問題もしくはエラーに関する追加情報を提供することがあります。</p>
<p>URL の場合は、スラッシュで始まる (/) ローカルの web-path (
<directive module="core">DocumentRoot</directive> からの相対パス
) か、クライアントが解決できる完全な URL を指定します。
もしくは、ブラウザに表示されるメッセージを指定できます。
例:</p>
<example>
ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
ErrorDocument 401 /subscription_info.html<br />
ErrorDocument 403 "Sorry can't allow you access today"
</example>
<p>加えて、特別な値 <code>default</code> を使って Apache に
ハードコードされている簡単なメッセージを指定することができます。
通常は必要ではありませんが、<code>default</code> を使うと
既存の <directive>ErrorDocument</directive> ディレクティブの設定を
継承するところで、Apache のハードコードされた簡単なメッセージに
戻すことができます。</p>
<example>
ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
&lt;Directory /web/docs&gt;<br />
<indent>
ErrorDocument 404 default<br />
</indent>
&lt;/Directory&gt;
</example>
<p>リモート URL (例えば、頭に <code>http</code> と付与した方法) を
<directive>ErrorDocument</directive> に指定するとき、
たとえ文書が同じサーバにあろうとも、ドキュメントがどこにあるかを通知するために、
Apache はリダイレクトをクライアントに送出するということに、注意してください。
これにはいろいろと関連して起こる問題があります。
中でも最も重要なのは、クライアントは元々のエラーステータスコードを受け取らず、
代わりにリダイレクトのステータスコードを受け取るということです。
これにより、ステータスコードを使って URL が有効であるかどうかを決定しようとする
ウェブロボットやその他クライアントを、混乱させるかもしれません。
さらに、<code>ErrorDocument 401</code> にリモートの URL を指定すると、
クライアントは 401 というステータスコードを受け取らないため、
パスワードをユーザーに入力要求しなければならないことがわかりません。
従って、<strong><code>ErrorDocument 401</code> というディレクティブを使う場合は、
必ずローカルな文書を参照しなければなりません。</strong></p>
<p>Microsoft Internet Explorer (MSIE) はデフォルトではサーバが生成したエラーメッセージが
「小さすぎる」ときには無視をして自分自身の「やさしい」エラーメッセージで
置換します。サイズのしきい値はエラーの種類によって異なりますが、
一般的にはエラーの文書を 512 バイトよりも大きくすると、MSIE は
サーバが生成したエラーを隠さずに表示します。詳しい情報は Microsoft
Knowledge Base の記事 <a
href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>
にあります。</p>
<p>ほとんどのエラーメッセージを上書きすることができますが、特定の状況下では
<directive module="core">ErrorDocument</directive> の設定にかかわらず
内蔵のメッセージが使われます。
特に、不正な形式のリクエストが検出された場合、通常のリクエスト処理は
即座に中止され、内蔵のエラーメッセージが返されます。
この処置は不正なリクエストによって引き起こされる、セキュリティ問題から
守るために必要な措置です。</p>
<p>2.0 より前のバージョンでは、対になっていない二重引用符を
先頭に付けることによりメッセージであることを指定していました。</p>
</usage>
<seealso><a href="/custom-error.html">カスタマイズ可能な
エラー応答のドキュメンテーション</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ErrorLog</name>
<description>サーバがエラーをログ収集する場所</description>
<syntax> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</syntax>
<default>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>ErrorLog</directive> ディレクティブは、
サーバに生じたさまざまなエラーを
記録する為のファイルの名前を設定します。
<var>file-path</var> が絶対パスでないときは、<directive
module="core">ServerRoot</directive> からの相対パスとみなされます。</p>
<example><title>例</title>
ErrorLog /var/log/httpd/error_log
</example>
<p><var>file-path</var> がパイプ (|) から始まる場合は、
エラーログを処理するために実行されるコマンドが
指定されていると解釈されます。</p>
<example><title>例</title>
ErrorLog "|/usr/local/bin/httpd_errors"
</example>
<p>ファイル名の変わりに <code>syslog</code> と指定することによって、
システムがサポートしていれば syslogd(8) を利用したロギングが有効になります。
デフォルトでは、<code>local7</code> ファシリティとなりますが、
<code>syslog:<var>facility</var></code> といった形で記述することにより、
通常 syslog(1) のドキュメントで説明されているファシリティの一つを使うように
することができます。</p>
<example><title>例</title>
ErrorLog syslog:user
</example>
<p>セキュリティ:
ログファイルを格納するディレクトリが、サーバを起動したユーザ以外の
ユーザによって書き込める場合にセキュリティが破られる可能性があることに
関する詳細は <a
href="/misc/security_tips.html#serverroot">セキュリティに関するコツ</a> を
参照してください。</p>
<note type="warning"><title>注</title>
<p>Unix 以外のプラットフォームでファイルのパスを入力するときは、
プラットフォームがバックスラッシュの使用を許していたとしても、
確実にスラッシュのみが使用されるように注意してください。一般的には、
設定ファイル全般でスラッシュのみを使う方が良いでしょう。</p>
</note>
</usage>
<seealso><directive module="core">LogLevel</directive></seealso>
<seealso><a href="/logs.html">Apache ログファイル</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>FileETag</name>
<description>ETag HTTP 応答ヘッダを作成するために使用される
ファイルの属性</description>
<syntax>FileETag <var>component</var> ...</syntax>
<default>FileETag INode MTime Size</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<usage>
<p>
<directive>FileETag</directive> ディレクティブは
ドキュメントがファイルに基づいたものであるときに、
<code>ETag</code> (エンティティタグ) 応答ヘッダフィールドを作成するときに使用する
ファイルの属性を設定します。 (<code>ETag</code> の値はネットワークの帯域を節約するための
キャッシュの管理で使われます。) Apache 1.3.22 以前では、<code>ETag</code> の値は
<em>常に</em>ファイルの inode, サイズ、最終修正時刻 (mtime) から作成
されていました。<directive>FileETag</directive> ディレクティブにより、これらのどれを使うかを
選ぶことができます。認識されるキーワードは:
</p>
<dl>
<dt><strong>INode</strong></dt>
<dd>ファイルの inode 番号を計算に使います</dd>
<dt><strong>MTime</strong></dt>
<dd>ファイルの最終修正時刻を使います</dd>
<dt><strong>Size</strong></dt>
<dd>ファイルの中身のバイト数を使います</dd>
<dt><strong>All</strong></dt>
<dd>使用可能なすべてのフィールドを使います。
これは <example>FileETag INode MTime Size</example> と等価です。</dd>
<dt><strong>None</strong></dt>
<dd>ドキュメントがファイルに基づいたものでも、<code>ETag</code> フィールドを
応答に付加しません</dd>
</dl>
<p><code>INode</code>, <code>MTime</code>, <code>Size</code> キーワードには
<code>+</code> や <code>-</code> を前に付けて
指定することもできます。この場合は、より広い範囲から継承された
デフォルトの設定に変更を加えるようになります。そのような接頭辞の
無いキーワードを指定すると、即座に継承した設定を無効にします。</p>
<p>あるディレクトリの設定に
<code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code> があり、
サブディレクトリの設定に <code>FileETag&nbsp;-INode</code> があるときは、
そのサブディレクトリの設定は (設定が上書きされなければサブディレクトリの
サブディレクトリにも継承されます) <code>FileETag&nbsp;MTime&nbsp;Size</code>
と同じになります。</p>
<note type="warning"><title>警告</title>
WebDAV を使っていて、<module>mod_dav_fs</module> をストレージプロバイダとして
使っているような Directory や Location では、デフォルト値を変更しないでください。
<module>mod_dav_fs</module> では、条件付リクエストでの比較演算に
<code>INode&nbsp;MTime&nbsp;Size</code>
の固定フォーマットを使っています。
<directive>FileETag</directive> で <code>ETag</code> フォーマットを
変更してしまうと、条件付リクエストでうまく動作しなくなります。
</note>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>Files</name>
<description>マッチするファイル名に適用されるディレクティブを囲む</description>
<syntax>&lt;Files <var>filename</var>&gt; ... &lt;/Files&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p><directive type="section">Files</directive> ディレクティブは、
その中にあるディレクティブの適用範囲をファイル名で制限します。
<directive module="core"
type="section">Directory</directive> ディレクティブや <directive
module="core" type="section">Location</directive> ディレクティブと
同じような機能を持ちます。
これは、<code>&lt;/Files&gt;</code> ディレクティブと対に
なっていなければなりません。
このセクション中のディレクティブは、ベース名 (ファイル名の最後の部分)
が指定されたファイル名にマッチするすべてのオブジェクトに適用されます。
<directive type="section">Files</directive> セクションは
<directive type="section">Directory</directive> セクションと
<code>.htaccess</code> が読み込まれた後、
<directive type="section">Location</directive> セクションよりは先に
設定ファイルに現れた順に適用されます。
<directive type="section">Files</directive> は、
<directive type="section">Directory</directive> セクション内に
ネストさせることができ、
ファイルシステムの一部にのみ限定して適用させることができます。</p>
<p><var>filename</var> 引数は、ファイル名かワイルドカード文字列
で、ワイルドカードでは <code>?</code> は一つの文字、<code>*</code> は任意の文字列にマッチします。
<code>~</code> という文字を付加することで<glossary ref="regex">正規表現</glossary>を使うこともできます。
例えば、</p>
<example>
&lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
</example>
<p>とすることにより、一般的なインターネットの画像フォーマットにマッチします。
ただし、
<directive module="core" type="section">FilesMatch</directive> を使う方が
推奨されています。</p>
<p>ちなみに、<directive module="core" type="section"
>Directory</directive> と <directive module="core" type="section"
>Location</directive> セクションとは異なり、
<directive type="section">Files</directive>
は <code>.htaccess</code> ファイル内で利用することができます。
これにより、ユーザがファイル毎にアクセスの制御を行なうことができるように
なっています。</p>
</usage>
<seealso>リクエストを受けた際にこれらの異なるセクションが
組み合わされる方法については <a href="/sections.html">
&lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
</directivesynopsis>
<directivesynopsis type="section">
<name>FilesMatch</name>
<description>正規表現にマッチするファイル名に適用される
ディレクティブを囲む</description>
<syntax>&lt;FilesMatch <var>regex</var>&gt; ... &lt;/FilesMatch&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p><directive type="section">FilesMatch</directive> ディレクティブは、
<directive module="core" type="section">Files</directive>
ディレクティブ同様にその中にあるディレクティブの適用範囲をファイル名で制限します。ただし、
このディレクティブには<glossary ref="regex">正規表現</glossary>を指定します。
例えば:</p>
<example>
&lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
</example>
<p>は一般的なインターネットの画像形式にマッチします。</p>
</usage>
<seealso>リクエストを受けた際にこれらの異なるセクションが
組み合わされる方法については <a href="/sections.html">
&lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ForceType</name>
<description>すべてのマッチするファイルが指定の MIME コンテントタイプで
送られるようにする</description>
<syntax>ForceType <var>MIME-type</var>|None</syntax>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility>Apache 2.0 で core に移動</compatibility>
<usage>
<p><code>.htaccess</code> や <directive type="section" module="core"
>Directory</directive> セクション、
<directive type="section" module="core">Location</directive> セクション、
<directive type="section" module="core">Files</directive> セクションに
書かれた場合、このディレクティブはそこにあるすべてのファイルが
<var>MIME-type</var>
で指定されたコンテントタイプとして扱われるようにします。たとえば、
GIF ファイルばかりのディレクトリがあって、すべてのファイルを <code>.gif</code>
で終わらせたくはないときに、以下のものを使用します:</p>
<example>
ForceType image/gif
</example>
<p><directive module="core">DefaultType</directive> と違って
このディレクティブはメディアタイプを決めることができるかもしれない
ファイルの拡張子も含め、すべての MIME タイプの関連付けを
上書きすることに注意してください。</p>
<p><code>None</code> という値を使うことで <directive>ForceType</directive> の
設定を無効にできます:</p>
<example>
# force all files to be image/gif:<br />
&lt;Location /images&gt;<br />
<indent>
ForceType image/gif<br />
</indent>
&lt;/Location&gt;<br />
<br />
# but normal mime-type associations here:<br />
&lt;Location /images/mixed&gt;<br />
<indent>
ForceType None<br />
</indent>
&lt;/Location&gt;
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>HostnameLookups</name>
<description>クライアントの IP アドレスの DNS ルックアップを
有効にする</description>
<syntax>HostnameLookups On|Off|Double</syntax>
<default>HostnameLookups Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
<usage>
<p>このディレクティブは、ホスト名をログ収集できるように
DNS ルックアップを有効にします
(さらに、CGI/SSI に <code>REMOTE_HOST</code> 変数として渡します)。
<code>Double</code>を指定した場合、2 重の逆引きを行ないます。
つまり、逆引きの後に、その結果に対して正引きを行ないます。正引きの
結果の IP アドレスの中にオリジナルのアドレスと一致するものがなければ
なりません。("tcpwrappers" の用語では <code>PARANOID</code> と呼ばれています。)</p>
<p><module>mod_authz_host</module> でホスト名によるアクセス
制御を行なう場合には、
設定の如何によらず 2 重の逆引きが実行されます。
これは、セキュリティを保つために必要です。
<code>HostnameLookups Double</code> を設定しない限り、
他の部分はこの 2 重逆引きの結果を使うことはできません。
例えば、<code>HostnameLookups On</code> と設定してある状態で、
ホスト名によるアクセス制限を行なったオブジェクトへの
リクエストを受けたとすると、2 重の逆引きが成功するか否かによらず、
<code>REMOTE_HOST</code> には通常の逆引き結果が渡されます。</p>
<p>ディレクティブのデフォルトは
本当に逆引きを必要としているわけではないサイトの
ネットワークトラフィックを低減させるために、<code>Off</code> になっています。
ルックアップによる余計な遅延がなくなるため、
エンドユーザにとっても良いでしょう。
DNS のルックアップには、かなりの時間が必要となる場合が多く、
負荷の高いサイトではこのディレクティブは <code>Off</code> にすべきです。
なお、<var>/support</var> ディレクトリに含まれ、デフォルトでは
インストールディレクトリの <code>bin</code> サブディレクトリに
インストールされる <program>logresolve</program> ユーティリティにより、
Apache の動作とは別に、ログに残されている IP アドレスからホスト名を
ルックアップすることが可能です。</p>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>If</name>
<description>実行時、リクエストが条件を満たした場合にのみ適用される
ディレクティブを包含する</description>
<syntax>&lt;If <var>expression</var>&gt; ... &lt;/If&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p><directive type="section">If</directive> ディレクティブは
実行時に式を評価し、条件式が真になるときにのみ
内包するディレクティブを適用します。
例えば</p>
<example>
&lt;If "$req{Host} = ''"&gt;
</example>
<p>上記例は <var>Host:</var> ヘッダの存在しない HTTP/1.0 のリクエストに
マッチします。</p>
</usage>
<seealso><a href="/sections.html">どのように &lt;Directory&gt;, &lt;Location&gt;,
&lt;Files&gt; セクションが動作するか</a> では、リクエストを受けたときに、
これらの異なるセクションがどのように組み合わさるかについて記載されています。
<directive type="section">If</directive> は
<directive type="section">Files</directive>
と同じ処理順と用法になっています。</seealso>
</directivesynopsis>
<directivesynopsis type="section">
<name>IfDefine</name>
<description>起動時にテストが真であるときのみに処理されるディレクティブを
囲む</description>
<syntax>&lt;IfDefine [!]<var>parameter-name</var>&gt; ...
&lt;/IfDefine&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p><code>&lt;IfDefine <var>test</var>&gt;...&lt;/IfDefine&gt;</code>
セクションは、
ディレクティブを条件付きで指定するために利用します。
<directive type="section">IfDefine</directive> セクションに
含まれるディレクティブは、<var>test</var>が
定義されているときのみ処理されます。
もし <var>test</var> が定義されていなければ、
開始と終了の指定の間のディレクティブは無視されます。</p>
<p><directive type="section">IfDefine</directive> セクションディレクティブに
指定する <var>test</var> は、
次の二つの形式のうちの一つをとります:</p>
<ul>
<li><var>parameter-name</var></li>
<li><code>!</code><var>parameter-name</var></li>
</ul>
<p>前者の場合には、<var>parameter-name</var> と名付けられたパラメータが
定義されていれば開始と終了の間のディレクティブが処理されます。
後者の場合は逆で、<em>parameter-name</em> が指定されて<strong>いない</strong>
場合に処理されます。</p>
<p><var>parameter-name</var> 引数は、サーバを起動する際に
<program>httpd</program> のコマンドラインに
<code>-D<var>parameter</var></code> という形で指定するか
あるいは <directive module="core">Define</directive>
ディレクティブで指定されると定義されます。 </p>
<p><directive type="section">IfDefine</directive> セクションは
入れ子にすることができ、複数のパラメータによるテストをするために使用できます。
例:</p>
<example>
httpd -DReverseProxy -DUseCache -DMemCache ...<br />
<br />
# httpd.conf<br />
&lt;IfDefine ReverseProxy&gt;<br />
<indent>
LoadModule proxy_module modules/mod_proxy.so<br />
LoadModule proxy_http_module modules/mod_proxy_http.so<br />
&lt;IfDefine UseCache&gt;<br />
<indent>
LoadModule cache_module modules/mod_cache.so<br />
&lt;IfDefine MemCache&gt;<br />
<indent>
LoadModule mem_cache_module modules/mod_mem_cache.so<br />
</indent>
&lt;/IfDefine&gt;<br />
&lt;IfDefine !MemCache&gt;<br />
<indent>
LoadModule disk_cache_module modules/mod_disk_cache.so<br />
</indent>
&lt;/IfDefine&gt;
</indent>
&lt;/IfDefine&gt;
</indent>
&lt;/IfDefine&gt;
</example>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>IfModule</name>
<description>モジュールの存在するかしないかに応じて処理される
ディレクティブを囲む</description>
<syntax>&lt;IfModule [!]<var>module-file</var>|<var>module-identifier</var>&gt; ...
&lt;/IfModule&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<compatibility>モジュール識別子はバージョン 2.1 以降で使用可能。</compatibility>
<usage>
<p><code>&lt;IfModule <var>test</var>&gt;...&lt;/IfModule&gt;</code>
セクションは、モジュールが存在するときに処理されるディレクティブを
指定するために利用します。
<directive type="section">IfModule</directive> セクションに
含まれるディレクティブは、<var>test</var>
で指定するモジュールが組み込まれているときのみ処理されます。
もし <var>test</var> が組み込まれていなければ、開始と終了の間のディレクティブ
は無視されます。</p>
<p><directive type="section">IfModule</directive> セクションディレクティブに
指定する <var>test</var> は、
次の二つの形式のうちの一つをとります。</p>
<ul>
<li><var>module</var></li>
<li>!<var>module</var></li>
</ul>
<p>前者の場合は、<var>module</var> と名付けられたモジュールが
Apache に組み込まれていれば
(コンパイル済みのものと、<directive
module="mod_so">LoadModule</directive> を利用して
動的に読み込んだものの両方)、
開始と終了の間のディレクティブが処理されます。
後者の場合は逆で、<var>module</var> が組み込まれて<strong>いない</strong>
場合に処理されます。</p>
<p><var>module</var> 引数は、モジュール識別子か
コンパイルをした時のモジュールのファイル名です。
例えば、<code>rewrite_module</code> は識別子で
<code>mod_rewrite.c</code> はファイル名です。
モジュールが複数のソースファイルから構成されている場合は、文字列
<code>STANDARD20_MODULE_STUFF</code> があるファイルの名前を
使ってください。</p>
<p><directive type="section">IfModule</directive> セクションは
入れ子にすることが可能であり、
複数のモジュールのテストを行なうために使用できます。</p>
<note>特定のモジュールの存在に関わらず動作する
設定ファイルの原本が必要なときにのみこのセクションを使用してください。
通常の動作では、ディレクティブを
<directive type="section">IfModule</directive> セクションの中に
入れる必要はありません。</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>Include</name>
<description>サーバ設定ファイル中から他の設定ファイルを取り込む</description>
<syntax>Include <var>file-path</var>|<var>directory-path</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context>
</contextlist>
<compatibility>ワイルドカードによるマッチは 2.0.41 以降で使用可能</compatibility>
<usage>
<p>このディレクティブにより、サーバの設定ファイルから
他の設定ファイルをインクルードすることができます。</p>
<p>複数のファイルをアルファベット順に一度に読み込むために、
シェル形式 (<code>fnmatch</code>) のワイルドカード文字を使うことができます。
さらに、<directive>Include</directive> にディレクトリを指定した場合は、
ディレクトリとそのサブディレクトリ内の全てのファイルを
アルファベット順に読み込んで、設定ファイルとして処理します。
しかし、ディレクトリ全体を読み込むのはお勧めできません。
ふとしたことから <code>httpd</code> が読み込みに失敗するような
一時ファイルをディレクトリに残してしまうようなことがよくあるからです。</p>
<p>指定するファイルパスは絶対パスか、
<directive module="core">ServerRoot</directive> ディレクトリからの
相対パスか、のどちらかです。</p>
<p>例:</p>
<example>
Include /usr/local/apache2/conf/ssl.conf<br />
Include /usr/local/apache2/conf/vhosts/*.conf
</example>
<p><directive module="core">ServerRoot</directive> からの相対パスの場合は:</p>
<example>
Include conf/ssl.conf<br />
Include conf/vhosts/*.conf
</example>
</usage>
<seealso><program>apachectl</program></seealso>
</directivesynopsis>
<directivesynopsis>
<name>KeepAlive</name>
<description>HTTP の持続的な接続を有効にする</description>
<syntax>KeepAlive On|Off</syntax>
<default>KeepAlive On</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>HTTP/1.0 の Keep-Alive 拡張と HTTP/1.1 の持続的接続の機能は、
複数のリクエストが同じ TCP の接続で送られる、長時間持続する
HTTP セッションを提供します。たくさんの画像が
含まれる HTML ドキュメントでは場合によっては遅延時間が 50% 短縮される結果も
でています。Keep-Alive 接続を有効にするには
<code>KeepAlive On</code> と設定します。</p>
<p>HTTP/1.0 に対応したクライアントの際には、
クライアントより特に要求があった場合のみ Keep-Alive 接続となります。
さらに、HTTP/1.0 クライアントでは、コンテンツの容量が先に
(訳注: 要求に対して応答を返す前に) わかる場合のみ Keep-Alive
接続を利用できます。
これは、CGI の出力や SSI のページ、
サーバが生成したディレクトリのリストのような動的コンテンツを
HTTP/1.0 クライアントに送る場合には Keep-Alive 接続を使えないことを意味します。
HTTP/1.1 に対応したクライアントの際には、
特に指定されない限りはデフォルトとして持続的な接続が行なわれます。
クライアントが要求すれば、コンテンツの容量を判別できないものを
持続的な接続を通して送るために、チャンクエンコーディングが用いられます。</p>
<p>クライアントが Keep-Alive コネクションを使用している場合、
そのコネクションを通してどれだけたくさんのリクエストが処理されても、
それは「リクエスト」1 つとして、MaxRequestsPerChild ディレクティブでは
数えられます。</p>
</usage>
<seealso><directive module="core">MaxKeepAliveRequests</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>KeepAliveTimeout</name>
<description>持続的な接続で次のリクエストが来るまでサーバが待つ時間</description>
<syntax>KeepAliveTimeout <var>seconds</var></syntax>
<default>KeepAliveTimeout 5</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>接続を閉じる前に、Apache が次のリクエストを何秒待つかを指定します。
リクエストを受け付けた後は、<directive
module="core">Timeout</directive> ディレクティブによって
指定されたタイムアウト値が使われます。</p>
<p><directive>KeepAliveTimeout</directive> を大きな値に設定すると、
負荷の高いサーバにおいてはパフォーマンスの問題を引き起こす場合があります。
タイムアウトが長ければ長いほど、より多くのサーバプロセスが
活性でないクライアントからの接続の終了を待ち続けることになります。</p>
<p>名前ベースのバーチャルホストコンテキストでは、
<directive module="core">NameVirtualHost</directive>
のセットの中で最初に定義されたバーチャルホストの値
(デフォルトホスト) が使われます。
その他の値は無視されます。</p>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>Limit</name>
<description>囲いの中にあるアクセス制御の適用を特定の HTTP メソッドのみに
制限する</description>
<syntax>&lt;Limit <var>method</var> [<var>method</var>] ... &gt; ...
&lt;/Limit&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p>アクセス制御は、通常<strong>全ての</strong>アクセスメソッドに対して
影響し、普通はこれが望ましい挙動です。
<strong>そうしたことから、大部分の場合にはアクセス制御に関わるディレクティブを
<directive type="section">Limit</directive> セクション内に
書くべきではありません。 </strong></p>
<p><directive type="section">Limit</directive> ディレクティブの
目的は、アクセス制御の範囲を
指定された HTTP メソッドに限定するためです。
それ以外のメソッドは、<directive type="section">Limit</directive> で囲われたアクセス制御の
<strong>影響を受けません</strong>。
以下の例は、<code>POST</code>, <code>PUT</code>, <code>DELETE</code> のメソッドに対してのみアクセスの制御を行ない、
それ以外のメソッドについては制限しません:</p>
<example>
&lt;Limit POST PUT DELETE&gt;<br />
<indent>
Require valid-user<br />
</indent>
&lt;/Limit&gt;
</example>
<p>メソッド名には以下の中から一つ以上を列挙することができます:
<code>GET</code>,
<code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
<code>CONNECT</code>, <code>OPTIONS</code>,
<code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
<code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
<code>LOCK</code>, <code>UNLOCK</code>. <strong>メソッド名は
大文字小文字を区別します。</strong> <code>GET</code> を指定した場合には
<code>HEAD</code> リクエストにも制限がかかります。<code>TRACE</code>
メソッドに制限をかけることはできません
(<directive type="section" module="core">TraceEnable</directive> 参照)。</p>
<note type="warning">アクセス制御が目的の場合は
<directive type="section" module="core">Limit</directive>
セクションの代わりに <directive type="section"
module="core">LimitExcept</directive> セクションを使用した方が良いでしょう。
<directive type="section" module="core">LimitExcept</directive>
セクションでは不特定のメソッドに対しても防御できるからです。</note>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>LimitExcept</name>
<description>指定されたもの以外の HTTP メソッドにアクセス制御を
制限する</description>
<syntax>&lt;LimitExcept <var>method</var> [<var>method</var>] ... &gt; ...
&lt;/LimitExcept&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p><directive type="section">LimitExcept</directive> と
<code>&lt;/LimitExcept&gt;</code> は、引数に
<strong>含まれていない</strong>
HTTP のアクセスメソッドに適用するためのアクセス制御
ディレクティブを括るために利用します。
つまり、<directive type="section" module="core"
>Limit</directive> セクションの反対の動作をし、
標準のメソッドと標準外や未認識のメソッドの場合の両方を設定できます。
<directive type="section" module="core">Limit</directive> のドキュメントも
併せて参照してください。</p>
<p>例:</p>
<example>
&lt;LimitExcept POST GET&gt;<br />
<indent>
Require valid-user<br />
</indent>
&lt;/LimitExcept&gt;
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LimitInternalRecursion</name>
<description>内部リダイレクトと入れ子になったサブリクエストの最大数を決定する</description>
<syntax>LimitInternalRecursion <var>number</var> [<var>number</var>]</syntax>
<default>LimitInternalRecursion 10</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>Apache 2.0.47 以降で使用可能</compatibility>
<usage>
<p>内部リダイレクトは例えば <directive>Action</directive> ディレクティブを
使っているときに起こります。<directive>Action</directive> ディレクティブは
元々のリクエストを CGI スクリプトに内部リダイレクトを行ないます。
サブリクエストはいくつかの URI に対して、リクエストされたときに
何が起こるかを調べるための Apache の機構です。例えば、<module>mod_dir</module>
は <directive module="mod_dir">DirectoryIndex</directive> ディレクティブ
がリストするファイルを調べるためにサブリクエストを使います。</p>
<p><directive>LimitInternalRecursion</directive> は内部リダイレクトや
サブリクエストが無限ループに陥ったときのサーバクラッシュを防ぎます。
普通、そのようなループは設定に失敗したときに発生します。</p>
<p>このディレクティブは、リクエスト毎に評価される、二つの違う限界値を
設定します。最初の <var>number</var> は、起こり得る
内部リクエストの最大値を設定します。二つめの <var>number</var> は
サブリクエストが入れ子にできる深さを設定します。<var>number</var> を
一つだけ指定したときは、両方の限界値にその値が設定されます。</p>
<example><title>例</title>
LimitInternalRecursion 5
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LimitRequestBody</name>
<description>クライアントから送られる HTTP リクエストのボディの
総量を制限する</description>
<syntax>LimitRequestBody <var>bytes</var></syntax>
<default>LimitRequestBody 0</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p>このディレクティブは、リクエストボディに許されるバイト数、<var>bytes</var>
を 0 (無制限を意味します) から 2147483647 (2GB) までの数値で指定します。</p>
<p><directive>LimitRequestBody</directive> ディレクティブは、
ディレクティブが書かれたコンテキスト
(サーバ全体、ディレクトリ、ファイル、ロケーション) 内で
許容する HTTP リクエストメッセージボディのサイズに制限をかけることができます。
クライアントのリクエストがその制限値を越えていれば、
サーバはリクエストを処理せずにエラーを返します。
普通のリクエストメッセージボディのサイズは、リソースの種類や
許可されているメソッドによって大きく変わります。
CGI スクリプトは、よく情報を受信するために
メッセージボディを使います。
<code>PUT</code> メソッドの実装は、このディレクティブの値として
少なくともあるリソースに対してサーバが受け付けようとする
表現の大きさほどの値を必要とします。</p>
<p>このディレクティブは、
管理者にクライアントからの異常なリクエストを制御できるようにし、
何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
<p>ある場所へのファイルアップロードを許可する場合に、
アップロードできるファイルのサイズを 100K に制限したければ、
以下のように指定します:</p>
<example>
LimitRequestBody 102400
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LimitRequestFields</name>
<description>クライアントからの HTTP リクエストのヘッダフィールドの数を
制限する</description>
<syntax>LimitRequestFields <var>number</var></syntax>
<default>LimitRequestFields 100</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p><var>number</var> には、0 (無制限を意味します) から 32767
までの整数を指定します。
デフォルト値は、定数 <code>DEFAULT_LIMIT_REQUEST_FIELDS</code>
によりコンパイル時に定義されます (配布時には 100 と指定されています)。</p>
<p><directive>LimitRequestBody</directive> ディレクティブは、
サーバ管理者が HTTP リクエスト中において許可するリクエストヘッダフィールド数を
指定します。
サーバはこの値には通常のクライアントからのリクエストに含まれるであろう
フィールドの数より大きな値が必要とします。
クライアントにより使われた要求ヘッダーフィールドの数が
20 を超えることはほとんどありませんが、
これは種々のクライアントの実装によって変わり、
詳細なコンテントネゴシエーションをするためのブラウザの設定までにも
影響されることがあります。
オプションの HTTP 拡張はリクエストヘッダフィールドを使って表される場合が
多くあります。</p>
<p>このディレクティブは、
管理者にクライアントからの異常なリクエストを制御できるようにし、
何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。
リクエストのフィールドが多過ぎることを意味するエラー応答が
普通のクライアントに返されるような時はこの値を増やしてください。</p>
<p>例:</p>
<example>
LimitRequestFields 50
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LimitRequestFieldSize</name>
<description>クライアントからの HTTP リクエストのヘッダの
サイズを制限する</description>
<syntax>LimitRequestFieldSize <var>bytes</var></syntax>
<default>LimitRequestFieldSize 8190</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>このディレクティブは、HTTP リクエストヘッダ一つで受付ける
バイト数 <var>bytes</var> を指定します。</p>
<p><directive>LimitRequestFieldSize</directive> ディレクティブは、
HTTP リクエストヘッダで許容されるサイズを増減させることができます。
サーバは、このディレクティブの値として、
一般的なクライアントからリクエストが送られた際に、そのリクエストに
付属しているどのヘッダフィールドについても、
十分足りる大きさになっていなければなりません。
一般的なリクエストヘッダのサイズといっても、その大きさは個々の
クライアントの実装によって大きく異なり、
詳細なコンテントネゴシエーションをサポートするかどうかの、
ブラウザの設定にも影響されたりします。
SPNEGO 認証ヘッダでは 12392 バイトにまで及ぶことすらあります。</p>
<p>このディレクティブは、
管理者にクライアントからの異常なリクエストを制御できるようにし、
何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
<p>例:</p>
<example>
LimitRequestFieldSize 4094
</example>
<note>通常はデフォルトから変更する必要はありません。</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LimitRequestLine</name>
<description>クライアントからの HTTP リクエスト行のサイズを制限する</description>
<syntax>LimitRequestLine <var>bytes</var></syntax>
<default>LimitRequestLine 8190</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>このディレクティブは、HTTP リクエスト行内で許容されるバイト数
<var>bytes</var> を指定します。</p>
<p><directive>LimitRequestLine</directive> ディレクティブにより、
クライアントからの HTTP リクエスト行の許容サイズを増減できます。
リクエスト行は、HTTPメソッド、URI、プロトコルバージョンから成っており、
<directive>LimitRequestLine</directive> はサーバへのリクエストに対して
許容するリクエスト URI の長さを制限することになります。
サーバは、<code>GET</code> リクエストのクエリ部分も含めて、リソースの名前が入るに足る
大きさを必要とします。</p>
<p>このディレクティブは、
管理者にクライアントからの異常なリクエストを制御できるようにし、
何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
<p>例:</p>
<example>
LimitRequestLine 4094
</example>
<note>通常はデフォルトから変更する必要はありません。</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LimitXMLRequestBody</name>
<description>XML 形式のリクエストのボディのサイズを制限する</description>
<syntax>LimitXMLRequestBody <var>bytes</var></syntax>
<default>LimitXMLRequestBody 1000000</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>All</override>
<usage>
<p>XML 形式のリクエストのボディの最大値を (バイト単位で) 制限します。
値に <code>0</code> を指定するとチェックを無効にします。</p>
<p>例:</p>
<example>
LimitXMLRequestBody 0
</example>
</usage>
</directivesynopsis>
<directivesynopsis type="section">
<name>Location</name>
<description>囲んだディレクティブをマッチする URL のみに適用</description>
<syntax>&lt;Location
<var>URL-path</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive type="section">Location</directive> ディレクティブは、
URL により中に書かれたディレクティブの適用範囲を制限します。
<directive type="section" module="core">Directory</directive>
ディレクティブと似ていて、
<code>&lt;/Location&gt;</code> ディレクティブで終了する
サブセクションを開始します。
<directive type="section">Location</directive> セクションは、
<directive type="section" module="core">Directory</directive> セクションと
<code>.htaccess</code> の読み込みの後、
<directive type="section" module="core">Files</directive> セクションを
適用した後に、設定ファイルに現れた順に処理されます。</p>
<p><directive type="section">Location</directive> セクションは
完全にファイルシステムと関連せずに動作します。このことから導かれる
結果にはいつくか注意する点があります。最も重要なものは、
ファイルシステムの位置へのアクセス制御に <directive
type="section">Location</directive> ディレクティブを使うべきではない
ということです。複数の URL がファイルシステムの同じ位置にマップされる
可能がありますので、そのようなアクセス制御は回避されてしまう可能性が
あります。</p>
<note><title>いつ <directive
type="section">Location</directive> を使うか</title>
<p><directive type="section">Location</directive> ディレクティブは
ファイルシステム外のコンテンツにディレクティブを適用するときに
使用してください。ファイルシステムに存在するコンテンツに対しては、
<directive
type="section" module="core">Directory</directive> と <directive
type="section" module="core">Files</directive> を使ってください。
例外は、<code>&lt;Location /&gt;</code> で、これはサーバ全体に対して
設定を適用する簡単な方法です。</p>
</note>
<p>全ての (プロキシ以外の) リクエストに対し、
URL は <code>/path/</code> という、
接頭辞 <code>http://servername</code> を含まない形でマッチします。
プロキシリクエストの場合には、<code>scheme://servername/path</code>
という接頭辞を含む形でマッチし、接頭辞を含めて指定する必要があります。</p>
<p>URL にはワイルドカードを利用することができます。
<code>?</code> は任意の一文字、<code>*</code> は任意の文字列にマッチします。
どちらのワイルドカードも URL パス中の / にはマッチしません。</p>
<p><code>~</code> という文字を追加することで、<glossary ref="regex">正規表現</glossary>を
利用することもできます。
例えば:</p>
<example>
&lt;Location ~ "/(extra|special)/data"&gt;
</example>
<p>は URL に <code>/extra/data</code> か <code>/special/data</code> という文字列が
含まれている場合にマッチします。
<directive type="section" module="core"
>LocationMatch</directive> ディレクティブは
<directive type="section">Location</directive> の正規表現
版とまったく同じ動作をします。</p>
<p><directive type="section">Location</directive> 機能は、<directive
module="core">SetHandler</directive> ディレクティブと
組合わせて利用すると特に便利です。
例えば、<code>example.com</code> のブラウザからのみステータスの参照を有効にしたければ、
次のようにすれば良いでしょう。</p>
<example>
&lt;Location /status&gt;<br />
<indent>
SetHandler server-status<br />
Order Deny,Allow<br />
Deny from all<br />
Allow from .example.com<br />
</indent>
&lt;/Location&gt;
</example>
<note><title>/ (スラッシュ) に関する注</title>
<p>スラッシュ文字は、URL 内に現れる場所に応じて変化する
特別な意味を持っています。
ファイルシステムにおいて利用する場合には複数のスラッシュでも一つの
スラッシュとして扱われることが多いですが、
(<em>すなわち</em>、<code>/home///foo</code> は
<code>/home/foo</code> と同じいったように)
URL においては必ずしもそうなるわけではありません。
<directive type="section" module="core">LocationMatch</directive>
ディレクティブや正規表現を利用した
<directive type="section">Location</directive> ディレクティブで、
複数のスラッシュにマッチさせたいときには、、明示的に記述する
必要があります。</p>
<p>例えば、<code>&lt;LocationMatch ^/abc&gt;</code> は、
<code>/abc</code> というリクエスト URL にマッチしますが、
<code>//abc</code> というリクエスト URL にはマッチしません。
(正規表現でない) <directive type="section">Location</directive>
ディレクティブは、
proxy リクエストに対して利用する際には同様の振る舞いをしますが、
(正規表現でない) <directive type="section">Location</directive> を proxy
でないリクエストに対して利用する際には、
一つのスラッシュで複数のスラッシュにマッチします。
例えば、<code>&lt;Location /abc/def&gt;</code> と指定し、
<code>/abc//def</code> というリクエストがあれば、
マッチすることになります。</p></note>
</usage>
<seealso>リクエストを受けた際にこれらの異なるセクションが
組み合わされる方法については <a href="/sections.html">
&lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
</directivesynopsis>
<directivesynopsis type="section">
<name>LocationMatch</name>
<description>囲んだディレクティブを正規表現にマッチする URL のみに
適用</description>
<syntax>&lt;LocationMatch
<var>regex</var>&gt; ... &lt;/LocationMatch&gt;</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive type="section">LocationMatch</directive> ディレクティブは、
<directive type="section" module="core">Location</directive> と同じ様に
URL により中に書かれたディレクティブの適用範囲を制限します。
但し、引数は普通の文字列ではなく、<glossary ref="regex">正規表現</glossary>となります。
例えば、</p>
<example>
&lt;LocationMatch "/(extra|special)/data"&gt;
</example>
<p>は URL に <code>/extra/data</code> か <code>/special/data</code>
という文字列が含まれている場合にマッチします。</p>
</usage>
<seealso>リクエストを受けた際にこれらの異なるセクションが
組み合わされる方法については <a href="/sections.html">
&lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>LogLevel</name>
<description>ErrorLog の冗長性を制御する</description>
<syntax>LogLevel <var>level</var></syntax>
<default>LogLevel warn</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>LogLevel</directive> は、エラーログ (<directive module="core"
>ErrorLog</directive> ディレクティブを
見てください) へ記録するメッセージの冗長性を調整します。
以下の <var>level</var> を指定でき、順に重要度が下がっていきます。</p>
<table border="1">
<tr>
<th><strong>レベル</strong> </th>
<th><strong>説明</strong> </th>
<th><strong>例</strong> </th>
</tr>
<tr>
<td><code>emerg</code> </td>
<td>緊急 - システムが利用できない</td>
<td>Child cannot open lock file. Exiting
(子プロセスがロックファイルを開けないため終了した)</td>
</tr>
<tr>
<td><code>alert</code> </td>
<td>直ちに対処が必要</td>
<td>getpwuid: couldn't determine user name from uid
(getpwuid: UID からユーザ名を特定できなかった)</td>
</tr>
<tr>
<td><code>crit</code> </td>
<td>致命的な状態</td>
<td>socket: Failed to get a socket, exiting child
(socket: ソケットが得られないため、子プロセスを終了させた)</td>
</tr>
<tr>
<td><code>error</code> </td>
<td>エラー</td>
<td>Premature end of script headers
(スクリプトのヘッダが足りないままで終わった)</td>
</tr>
<tr>
<td><code>warn</code> </td>
<td>警告</td>
<td>child process 1234 did not exit, sending another SIGHUP
(子プロセス 1234 が終了しなかった。もう一度 SIGHUP を送る)</td>
</tr>
<tr>
<td><code>notice</code> </td>
<td>普通だが、重要な情報</td>
<td>httpd: caught SIGBUS, attempting to dump core in ...
(httpd: SIGBUS シグナルを受け、... へコアダンプをした)</td>
</tr>
<tr>
<td><code>info</code> </td>
<td>追加情報</td>
<td>"Server seems busy, (you may need to increase
StartServers, or Min/MaxSpareServers)..." (「サーバは負荷が高い、
(StartServers や Min/MaxSpareServers の値を増やす必要があるかも)」)</td>
</tr>
<tr>
<td><code>debug</code> </td>
<td>デバッグメッセージ</td>
<td>"Opening config file ..." (設定ファイルを開いている...)</td>
</tr>
</table>
<p>特定のレベルが指定された場合、それより高いレベルの全てのメッセージが
報告されます。
<em>例えば</em>、<code>LogLevel info</code> に指定すると、
<code>notice</code> と <code>warn</code> も報告されます。</p>
<p>なお <code>crit</code> 以上のレベルを指定することが推奨されます。</p>
<p>例:</p>
<example>
LogLevel notice
</example>
<note><title>注</title>
<p>ファイルにログを出力する場合、<code>notice</code>
レベルのメッセージは抑制されず、すべてログに出力されます。
しかし <code>syslog</code> を使用している場合は、
これは当てはまりません。</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>MaxKeepAliveRequests</name>
<description>持続的な接続上で許可されるリクエストの数</description>
<syntax>MaxKeepAliveRequests <var>number</var></syntax>
<default>MaxKeepAliveRequests 100</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>MaxKeepAliveRequests</directive> ディレクティブは、
<directive module="core">KeepAlive</directive> が有効な場合に、
一回の接続で受け付け可能なリクエストの数を制限します。
<code>0</code> に設定していれば、受け付けるリクエストは無制限になります。
この設定は、サーバ性能を向上させるために、大きな数値を指定すること勧めます。
</p>
<p>例:</p>
<example>
MaxKeepAliveRequests 500
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>NameVirtualHost</name>
<description>名前ベースのバーチャルホストのための IP アドレスを指定</description>
<syntax>NameVirtualHost <var>addr</var>[:<var>port</var>]</syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p><directive>NameVirtualHost</directive> ディレクティブは、
<a href="/vhosts/">名前ベースのバーチャルホスト</a>の設定を行ないたい場合に
必要となるものです。</p>
<p><var>addr</var> にはホスト名を指定できますが、
常に IP アドレスを指定するのが推奨されます。
例えば、</p>
<example>
NameVirtualHost 111.22.33.44
</example>
<p><directive>NameVirtualHost</directive> ディレクティブは、
名前ベースのバーチャルホストを
利用してリクエストを受け付ける IP アドレスを指定します。
これは、普通は名前ベースのバーチャルホストアドレスです。
ただし、ファイアーウォールや他のプロキシがリクエストを受け付け、
違う IP アドレスのサーバにフォワードするという場合は、
リクエストを提供したいマシン上の物理インターフェースの
IP アドレスを指定する必要があります。
複数のアドレスで複数の名前ベースのバーチャルホストを指定する場合は
各アドレスに対してディレクティブを書いてください。</p>
<note><title>中</title>
<p>「主サーバ」や、どの <code>_default_</code> サーバも、
<directive>NameVirtualHost</directive> で指定した IP アドレスへのリクエスト
を処理することは<strong>ありません</strong> (なぜか
<directive>NameVirtualHost</directive> を
指定したけどそのアドレスに <directive>VirtualHost</directive> を定義しなかった場合を除く)。</p>
</note>
<p>名前ベースのバーチャルホストにポート番号を指定することも可能です。
例えば</p>
<example>
NameVirtualHost 111.22.33.44:8080
</example>
<p>IPV6 のアドレスは次の例のように角括弧で囲む必要があります:</p>
<example>
NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
</example>
<p>すべてのインタフェースへのリクエストを受け取るようにするためには、
引数として <code>*</code> を使います。</p>
<example>
NameVirtualHost *
</example>
<note><title><directive type="section">VirtualHost</directive> ディレクティブの引数</title>
<p><directive type="section">VirtualHost</directive> ディレクティブの引数は <directive
>NameVirtualHost</directive> ディレクティブの引数に正確に
合っている必要があることに注意してください。</p>
<example>
NameVirtualHost 1.2.3.4<br />
&lt;VirtualHost 1.2.3.4&gt;<br />
# ...<br />
&lt;/VirtualHost&gt;<br />
</example>
</note>
</usage>
<seealso><a href="/vhosts/">バーチャルホスト説明書
</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>Options</name>
<description>ディレクトリに対して使用可能な機能を設定する</description>
<syntax>Options
[+|-]<var>option</var> [[+|-]<var>option</var>] ...</syntax>
<default>Options All</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>Options</override>
<usage>
<p><directive>Options</directive> ディレクティブは、特定のディレクトリに対して
どの機能が使用可能かを制御します。</p>
<p><var>option</var> を <code>None</code>に指定すると、
特別な機能は全て無効になります。
また、以下の示す 1 個以上のものを指定できます。</p>
<dl>
<dt><code>All</code></dt>
<dd><code>MultiViews</code> を除いた全ての機能が有効となります。
これがデフォルトです。</dd>
<dt><code>ExecCGI</code></dt>
<dd>
<module>mod_cgi</module> による CGI スクリプトの実行を許可します。</dd>
<dt><code>FollowSymLinks</code></dt>
<dd>
サーバが、このディレクトリ内でシンボリックリンクをたどれるようにします。
<note><p>サーバがシンボリックリンクをたどる場合でも、
<directive type="section" module="core">Directory</directive> セクションに
マッチさせるための
パス名は<em>変更されません</em>。</p>
<p><directive type="section" module="core">Location</directive> 内に
このオプションを指定しても<strong>無視される</strong>ことに
注意してください。</p>
<p>このオプションを省略したからといってセキュリティの強化にはなりません。
なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、
そのため回避可能になるからです。</p>
</note></dd>
<dt><code>Includes</code></dt>
<dd>
<module>mod_include</module> が提供する SSI を有効にします。</dd>
<dt><code>IncludesNOEXEC</code></dt>
<dd>
SSI は有効になりますが、<code>#exec</code> コマンド と <code>#exec CGI</code> は無効になります。
ただし、<code>#include virtual</code> により、<directive module="mod_alias">ScriptAlias</directive> されたディレクトリで
CGI を実行することは可能です。</dd>
<dt><code>Indexes</code></dt>
<dd>
もし、URL がディレクトリにマップするリクエストであって、
且つ <directive module="mod_dir">DirectoryIndex</directive> で指定したファイル (例えば、<code>index.html</code>) が
ディレクトリ内に無ければ、<module>mod_autoindex</module> が
ディレクトリ内の一覧を整形して返します。</dd>
<dt><code>MultiViews</code></dt>
<dd>
<module>mod_negotiation</module> による
<a href="/content-negotiation.html">コンテントネゴシエーション</a>
された "MultiViews" を許可します。</dd>
<dt><code>SymLinksIfOwnerMatch</code></dt>
<dd>
シンボリック先のファイルまたはディレクトリが、
シンボリックリンクの所有ユーザ ID と同じ場合にのみシンボリックリンクを
たどれるようにします。
<note><title>注</title> <p><directive type="section" module="core"
>Location</directive> 内にこのオプションを
指定しても無視されます。</p>
<p>このオプションはセキュリティの強化にはなりません。
なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、
そのため回避可能になるからです。</p>
</note>
</dd>
</dl>
<p>通常、ディレクトリに対して複数の <directive>Options</directive> が
適用可能な場合、
最も近いもの一つのみが適用され、他のものは無視されます。
複数の指定がマージされるわけではありません。(<a
href="/sections.html#mergin">セクションのマージ方法</a>を参照してください。)
しかし、すべての <directive>Options</directive> ディレクティブが <code>+</code> や <code>-</code> 付きで
指定された場合はオプションの値はマージされます。
<code>+</code> を頭につければ現在の設定に加えられ、
<code>-</code> を付ければ現在の設定から削除されます。</p>
<note type="warning"><title>警告</title>
<p><directive>Options</directive> で <code>+</code> や
<code>-</code> のついたものを、つけないものと組み合わせて
指定する構文は正しい構文ではありませんので、期待する結果に
ならないことがあります。</p>
</note>
<p>例えば、<code>+</code> や <code>-</code> を利用しない場合は:</p>
<example>
&lt;Directory /web/docs&gt;<br />
<indent>
Options Indexes FollowSymLinks<br />
</indent>
&lt;/Directory&gt;<br />
<br />
&lt;Directory /web/docs/spec&gt;<br />
<indent>
Options Includes<br />
</indent>
&lt;/Directory&gt;
</example>
<p><code>/web/docs/spec</code> というディレクトリには、
<code>Includes</code> だけが適用されます。
しかし、2 番目の <directive>Options</directive> で <code>+</code> や <code>-</code> を利用してみると:</p>
<example>
&lt;Directory /web/docs&gt;<br />
<indent>
Options Indexes FollowSymLinks<br />
</indent>
&lt;/Directory&gt;<br />
<br />
&lt;Directory /web/docs/spec&gt;<br />
<indent>
Options +Includes -Indexes<br />
</indent>
&lt;/Directory&gt;
</example>
<p><code>/web/docs/spec</code> というディレクトリには、 <code>FollowSymLinks</code> と
<code>Includes</code> が適用されます。</p>
<note><title>注</title>
<p><code>-IncludesNOEXEC</code> もしくは
<code>-Includes</code> を指定すると、
前の設定がどのようになっていようとも SSI は無効となります。</p>
</note>
<p>どのような設定もされていなければ、デフォルトでは <code>All</code> に
なります。</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>RLimitCPU</name>
<description>Apache の子プロセスから起動されたプロセスの CPU 消費量を
制限する</description>
<syntax>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</syntax>
<default>未設定。オペレーティングシステムのデフォルトを使用</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>All</override>
<usage>
<p>一つか二つのパラメータをとります。
最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2 番目のパラメータは最大のリソースリミットを設定します。
パラメータには数字か、オペレーティングシステムの最大となる
<code>max</code> のどちらかを指定することができます。
最大のリソースリミットを上げるためには、サーバを
<code>root</code> で実行するか起動されなければいけません。</p>
<p>ちなみに、この設定は Apache の子プロセス自体ではなく、
リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
適用されます。
これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
<p>CPU リソースのリミットはプロセスあたりの秒数で表わされます。</p>
</usage>
<seealso><directive module="core">RLimitMEM</directive></seealso>
<seealso><directive module="core">RLimitNPROC</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>RLimitMEM</name>
<description>Apache の子プロセスから起動されたプロセスのメモリ消費量を
制限する</description>
<syntax>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</syntax>
<default>未設定。オペレーティングシステムのデフォルトを使用</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>All</override>
<usage>
<p>一つか二つのパラメータをとります。
最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2 番目のパラメータは最大のリソースリミットを設定します。
パラメータには数字か、オペレーティングシステムの最大となる
<code>max</code> のどちらかを指定することができます。
最大のリソースリミットを上げるためには、サーバを
<code>root</code> で実行するか起動されなければいけません。</p>
<p>この設定は Apache の子プロセス自体ではなく、
リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
適用されます。
これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
<p>メモリリソースのリミットはプロセスあたりのバイト数で表わされます。</p>
</usage>
<seealso><directive module="core">RLimitCPU</directive></seealso>
<seealso><directive module="core">RLimitNPROC</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>RLimitNPROC</name>
<description>Apache の子プロセスから起動されたプロセスが起動するプロセスの
数を制限する</description>
<syntax>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</syntax>
<default>未設定。オペレーティングシステムのデフォルトを使用</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>All</override>
<usage>
<p>一つか二つのパラメータをとります。
最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2 番目のパラメータは最大のリソースリミットを設定します。
パラメータには数字か、オペレーティングシステムの最大となる
<code>max</code> のどちらかを指定することができます。
最大のリソースリミットを上げるためには、サーバを
<code>root</code> で実行するか起動されなければいけません。</p>
<p>この設定は Apache の子プロセス自体ではなく、
リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
適用されます。
これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
<p>プロセスの制限は、ユーザあたりのプロセス数で制御されます。</p>
<note><title>注</title>
<p> CGI プロセスがウェブサーバのユーザ ID 以外で実行されるので
<strong>無ければ</strong>、
このディレクティブは、サーバ自身が生成できるプロセスの数を制限することになります。
そのような状況になっているかどうかは、<code>error_log</code> 中の
<strong><code>cannot fork</code></strong> というメッセージにより
確認することができます。</p>
</note>
</usage>
<seealso><directive module="core">RLimitMEM</directive></seealso>
<seealso><directive module="core">RLimitCPU</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ScriptInterpreterSource</name>
<description>CGI スクリプトのインタープリタの位置を調べるための手法</description>
<syntax>ScriptInterpreterSource Registry|Registry-Strict|Script</syntax>
<default>ScriptInterpreterSource Script</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
<compatibility>Win32 のみ。
オプション <code>Registry-Strict</code> は Apache 2.0 以降で使用可能</compatibility>
<usage>
<p>このディレクティブは、Apache で CGI スクリプトを
実行する場合に利用するインタープリタを、
どのように探し出すかについて制御するために使用します。
デフォルトの設定は <code>Script</code> です。これはスクリプトの
shebang 行 (最初の行で <code>#!</code> から始まるもの)
に指されているインタープリタを使用します。Win32 ではその行は
以下の様になります。</p>
<example>
#!C:/Perl/bin/perl.exe
</example>
<p>もしくは、<code>perl</code> が <code>PATH</code> にある場合は単に:</p>
<example>
#!perl
</example>
<p><code>ScriptInterpreterSource Registry</code> を指定すると、
スクリプトファイルの拡張子 (例えば、<code>.pl</code>) を
キーとして、Windows のレジストリツリー <code>HKEY_CLASSES_ROOT</code>
を検索するようになります。レジストリのサブキー
<code>Shell\ExecCGI\Command</code> か、それが存在しない場合は
<code>Shell\Open\Command</code> がスクリプトファイルを開くために
使われます。レジストリキーが見つからないときは、Apache は <code>Script</code>
オプションが指定されたときの動作に戻ります。</p>
<note type="warning"><title>セキュリティ</title>
<p><code>ScriptInterpreterSource Registry</code> を <directive
module="mod_alias">ScriptAlias</directive> されたディレクトリで使うときは
注意してください。Apache はそのディレクトリ中の<em>すべての</em>ファイルを
実行しようとします。<code>Registry</code> という設定は通常は実行されない
ファイルに対して望ましくないプログラムの実行が発生する可能性があります。
例えば、ほとんどの Windows システムで、
<code>.htm</code> ファイルのデフォルトの「開く」コマンドは
Microsoft Internet Explorer を実行しますので、スクリプトに指定された
ディレクトリにある <code>.htm</code> ファイルへのリクエストはサーバの
バックグラウンドでブラウザを実行することになります。これは、一分内くらいで
システムをクラッシュさるための良い方法です。</p>
</note>
<p>Apache 2.0 から導入されたオプション <code>Registry-Strict</code> は
<code>Registry</code> と同じことを行ないますが、サブキー
<code>Shell\ExecCGI\Command</code> のみを使います。
<code>ExecCGI</code> キーは普通に使われるキーではありません。Windows
レジストリに手動で設定する必要がありますので、システムでの偶発的なプログラムの
実行を防ぐことができます。</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ServerAdmin</name>
<description>サーバがクライアントに送るエラーメッセージに含める電子メールの
アドレス</description>
<syntax>ServerAdmin <var>email-address</var>|<var>URL</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p><directive>ServerAdmin</directive> は、クライアントに返すさまざまな
エラーメッセージ中に記述する、
問合せアドレスを設定します。与えられた引数を <code>httpd</code> が
URL と認識しない場合は、<var>email-address</var> だと解釈して、
ハイパーリンクのターゲットに <code>mailto:</code> を付けます。
実際には、ここには電子メールアドレスを使うことが推奨されています。
多くの CGI スクリプトはそうなっていることを仮定しています。
URL を使う場合は、あなたの管理下にある別サーバを指すようにしてください。
そうでないと、エラーが起こったときに連絡をすることができなくなって
しまいます。
</p>
<p>その際、これのために専用のアドレスを設定するのが良いでしょう。
例えば、</p>
<example>
ServerAdmin www-admin@foo.example.com
</example>
<p>といったようにします。ユーザはいつもサーバに関する話であるということを
明記してくるわけではありませんので。</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ServerAlias</name>
<description>リクエストを名前ベースのバーチャルホストにマッチさせているときに
使用されるホストの別名</description>
<syntax>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</syntax>
<contextlist><context>virtual host</context></contextlist>
<usage>
<p><directive>ServerAlias</directive> ディレクティブは、<a
href="/vhosts/name-based.html">ネームベースのバーチャルホスト</a>において
使用するホストの別名を指定します。
適切であれば、<directive>ServerAlias</directive> ディレクティブでは
ワイルドカードを使うこともできます。</p>
<example>
&lt;VirtualHost *&gt;<br />
ServerName server.domain.com<br />
ServerAlias server server2.domain.com server2<br />
# ...<br />
&lt;/VirtualHost&gt;
</example>
</usage>
<seealso><a href="/vhosts/">Apache バーチャルホスト説明書</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ServerName</name>
<description>サーバが自分自身を示すときに使うホスト名とポート</description>
<syntax>ServerName [<var>scheme</var>://]<var>fully-qualified-domain-name</var>[:<var>port</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<compatibility>このディレクティブはバージョン 2.0 ではバージョン 1.3 の
<directive>Port</directive> ディレクティブの機能も含みます。</compatibility>
<usage>
<p><directive>ServerName</directive> ディレクティブは、
サーバが自分自身を示すスキーム名、ホスト名とポート番号を設定します。
これは、リダイレクトする URL を生成する際に利用されます。
例えば、ウェブサーバを動かしているマシンは <code>simple.example.com</code>
で、DNS のエイリアス <code>www.example.com</code> もあるときに、
ウェブサーバが後者として認識されて欲しいときは、以下のようにディレクティブを
使います。</p>
<example>
ServerName www.example.com:80
</example>
<p><directive>ServerName</directive> が指定されていないときは、
サーバは IP アドレスから逆引きを行なうことでホスト名を知ろうとします。
<directive>ServerName</directive> にポートが指定されていないときは、
サーバはリクエストが来ている
ポートを使います。最高の信頼性と確実性をもたらすためには、
<directive>ServerName</directive> を使ってホスト名とポートを明示的に
指定してください。</p>
<p><a href="/vhosts/name-based.html">名前ベースのバーチャルホスト</a>
を利用している場合、<directive type="section" module="core"
>VirtualHost</directive> セクション内の
<directive>ServerName</directive> はこのバーチャルホストにマッチするために
何がリクエストの Host: ヘッダに現れる必要があるのかを指定します。</p>
<p>SSL を処理するデバイス、例えばリーバスプロクシやロードバランサや
SSL 処理軽減アプライアンスの裏側でサーバが稼動する場合もあるでしょう。
そういった場合では、クライアントが接続するときに使う
<code>https://</code> スキームとポート番号を <directive>ServerName</directive>
ディレクティブで指定して、自己参照 URL が正しく生成できるようにします。</p>
<p>自己参照 URL (例えば <module>mod_dir</module> モジュールによるものなど)
が指定されたポートを使うか、クライアントのリクエストのポート番号を使うかを
決定する設定は <directive module="core">UseCanonicalName</directive>
ディレクティブと <directive
module="core">UseCanonicalPhysicalPort</directive>
ディレクティブを参照してください。</p>
</usage>
<seealso><a href="/dns-caveats.html">DNS と Apache に関する話</a></seealso>
<seealso><a href="/vhosts/">Apache バーチャルホスト説明書</a></seealso>
<seealso><directive module="core">UseCanonicalName</directive></seealso>
<seealso><directive module="core">UseCanonicalPhysicalPort</directive></seealso>
<seealso><directive module="core">NameVirtualHost</directive></seealso>
<seealso><directive module="core">ServerAlias</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ServerPath</name>
<description>非互換のブラウザが名前ベースのバーチャルホストにアクセスしたときの
ための互換用 URL パス名</description>
<syntax>ServerPath <var>URL-path</var></syntax>
<contextlist><context>virtual host</context></contextlist>
<usage>
<p><directive>ServerPath</directive> ディレクティブは、<a
href="/vhosts/">ネームベースのバーチャルホスト</a>において利用する
互換用 URL パス名を設定します。</p>
</usage>
<seealso><a href="/vhosts/">Apache バーチャルホスト説明書</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ServerRoot</name>
<description>インストールされたサーバのベースディレクトリ</description>
<syntax>ServerRoot <var>directory-path</var></syntax>
<default>ServerRoot /usr/local/apache</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p><directive>ServerRoot</directive> ディレクティブは、
サーバが存在するディレクトリを設定します。
通常、<code>conf/</code> や <code>logs/</code> といったサブディレクトリが
存在します。
また、他の設定ディレクティブ (例えば <directive
module="core">Include</directive> や <directive
module="mod_so">LoadModule</directive> など) における相対パスは、
このディレクトリからの相対位置となります。</p>
<example><title>例</title>
ServerRoot /home/httpd
</example>
</usage>
<seealso><a href="/invoking.html"><code>httpd</code> の <code>-d</code>
オプション</a></seealso>
<seealso><directive>ServerRoot</directive> の権限を適切に設定する方法は<a
href="/misc/security_tips.html#serverroot">セキュリティのこつ</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ServerSignature</name>
<description>サーバが生成するドキュメントのフッタを設定</description>
<syntax>ServerSignature On|Off|EMail</syntax>
<default>ServerSignature Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>All</override>
<usage>
<p><directive>ServerSignature</directive> ディレクティブは、
サーバが生成するドキュメント
(エラーメッセージ、<module>mod_proxy</module> における FTP のディレクトリリスト、
<module>mod_info</module> の出力、等々)
の最下行に付与するフッタの設定を行ないます。
そのようなフッタ行を有効にしたい理由には、
プロキシが複数連なっている場合に、ユーザはどのサーバが返した
エラーメッセージかを知る手段がほとんど無いというものがあります。</p>
<p>デフォルトである <code>Off</code> に設定をすると、フッタ行が抑制されます
(そして、Apache-1.2 以前と互換の動作をします)。
<code>On</code> に設定した場合は、単にドキュメントの中に、サーバのバージョン、
稼動中のバーチャルホストの <a
href="#servername">ServerName</a> の書かれた行を追加し、
<code>EMail</code> にした場合はさらに参照されたドキュメントに対する <a
href="#serveradmin">ServerAdmin</a> を指す "mailto:" が追加されます。</p>
<p>バージョン 2.0.44 以降ではこのディレクティブは <directive
module="core">ServerSignature</directive>
ディレクティブにより表示される情報も制御します。</p>
</usage>
<seealso><directive module="core">ServerTokens</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>ServerTokens</name>
<description><code>Server</code> HTTP 応答ヘッダを設定する</description>
<syntax>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</syntax>
<default>ServerTokens Full</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>このディレクティブは、クライアントに送り返す <code>Server</code>
応答ヘッダ内に、サーバの一般的な OS 種別や、
コンパイルされて組み込まれているモジュールの情報を
含めるかどうかを指定します。</p>
<dl>
<dt><code>ServerTokens Prod[uctOnly]</code></dt>
<dd>サーバは (例えば): <code>Server:
Apache</code> といったように送ります。</dd>
<dt><code>ServerTokens Major</code></dt>
<dd>Server sends (<em>e.g.</em>): <code>Server:
Apache/2</code></dd>
<dt><code>ServerTokens Minor</code></dt>
<dd>Server sends (<em>e.g.</em>): <code>Server:
Apache/2.0</code></dd>
<dt><code>ServerTokens Min[imal]</code></dt>
<dd>サーバは (例えば): <code>Server:
Apache/2.0.41</code> といったように送ります。</dd>
<dt><code>ServerTokens OS</code></dt>
<dd>サーバは (例えば): <code>Server: Apache/2.0.41
(Unix)</code> といったように送ります。</dd>
<dt><code>ServerTokens Full</code> (もしくは未指定)</dt>
<dd>サーバは (例えば): <code>Server: Apache/2.0.41
(Unix) PHP/4.2.2 MyMod/1.2</code> といったように送ります。</dd>
</dl>
<p>この設定はサーバ全体に適用され、バーチャルホスト上で有効にしたり
無効にしたりはできません。</p>
<p>バージョン 2.0.44 以降ではこのディレクティブは <directive
module="core">ServerSignature</directive>
ディレクティブにより表示される情報も制御します。</p>
</usage>
<seealso><directive module="core">ServerSignature</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>SetHandler</name>
<description>マッチするファイルがハンドラで処理されるようにする</description>
<syntax>SetHandler <var>handler-name</var>|None</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<compatibility>Apache 2.0 で core に移動</compatibility>
<usage>
<p><code>.htaccess</code> や <directive type="section" module="core"
>Directory</directive>
セクション、<directive type="section" module="core">Location</directive>
セクションに書かれた場合、
このディレクティブはそこにあるすべてのファイルが
<var>handler-name</var> で指定された<a href="/handler.html"
>ハンドラ</a>で扱われることを強制します。例えば、拡張子に関わらず、
ディレクトリ全体がイメージマップファイルとして解析して欲しい場合には、
以下をそのディレクトリの <code>.htaccess</code>
ファイルに記述します:</p>
<example>
SetHandler imap-file
</example>
<p>別の例: URL <code>http://servername/status</code>
が指定されたときにサーバが状態報告をするようにしたいときは、以下を
<code>httpd.conf</code> に記述します:</p>
<example>
&lt;Location /status&gt;<br />
<indent>
SetHandler server-status<br />
</indent>
&lt;/Location&gt;
</example>
<p><code>None</code> という値を設定することで、
前の方の <directive>SetHandler</directive> で定義された設定を無効にすることが
できます。</p>
<p><strong>注意:</strong>SetHandler はデフォルトのハンドラをオーバーライド
しますので、通常の挙動、たとえば、スラッシュ (/) で終わる URL が
リクエストされたときにディレクトリやインデックスファイルを返すよう取り扱う挙動は、
行われなくなります。
</p>
</usage>
<seealso><directive module="mod_mime">AddHandler</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>SetInputFilter</name>
<description>クライアントのリクエストや POST の入力を処理するフィルタを設定する</description>
<syntax>SetInputFilter <var>filter</var>[;<var>filter</var>...]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<usage>
<p><directive>SetInputFilter</directive> ディレクティブはクライアントの
リクエストや POST の入力をサーバが受け取ったときに処理するフィルタを
設定します。これは <directive module="mod_mime">AddInputFilter</directive>
ディレクティブを含め、他の場所で定義されているフィルタの設定に
追加されます。</p>
<p>複数のフィルタを指定するときは、データを処理する順番に
セミコロンで区切る必要があります。</p>
</usage>
<seealso><a href="/filter.html">フィルタ</a>説明書</seealso>
</directivesynopsis>
<directivesynopsis>
<name>SetOutputFilter</name>
<description>サーバの応答を処理するフィルタを設定する</description>
<syntax>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>FileInfo</override>
<usage>
<p><directive>SetOutputFilter</directive> ディレクティブは
サーバの応答をクライアントに送り返される前に処理するフィルタを設定します。
これは <directive module="mod_mime">AddOutputFilter</directive>
ディレクティブを含め、他の場所で定義されているフィルタの設定に
追加されます。</p>
<p>例えば、以下の設定は <code>/www/data/</code> ディレクトリのすべての
ファイルを SSI で処理します。</p>
<example>
&lt;Directory /www/data/&gt;<br />
<indent>
SetOutputFilter INCLUDES<br />
</indent>
&lt;/Directory&gt;
</example>
<p>複数のフィルタを指定するときは、データを処理する順番に
セミコロンで区切る必要があります。</p>
</usage>
<seealso><a href="/filter.html">フィルタ</a>説明書</seealso>
</directivesynopsis>
<directivesynopsis>
<name>TimeOut</name>
<description>各イベントについて、リクエストを失敗させるまでにサーバが
待つ時間を設定</description>
<syntax>TimeOut <var>seconds</var></syntax>
<default>TimeOut 300</default>
<contextlist><context>server config</context><context>virtual host</context></contextlist>
<usage>
<p><directive>TimeOut</directive> ディレクティブは、
様々な条件下での I/O 待ち時間を定義します:</p>
<ol>
<li>クライアントからのデータを読み込む時。
受信バッファが空になっていて、TCP パケットが届くまで
待つ時間の長さ</li>
<li>クライアントに対してデータを送り出す時。
送信バッファがいっぱいで、パケットの受信完了 <transnote>ACK</transnote>
が届くまで待つ時間の長さ</li>
<li><module>mod_cgi</module> 内で、CGI スクリプトが出力を
返すまでの待ち時間の長さ</li>
<li><module>mod_ext_filter</module> 内で、フィルタ処理で出力を
待つ時間の長さ</li>
<li><module>mod_proxy</module> 内で、
<directive module="mod_proxy">ProxyTimeout</directive>
が設定されていない場合のデフォルトの待ち時間</li>
</ol>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>TraceEnable</name>
<description><code>TRACE</code> メソッドのリクエストに対する応答方法を決める
</description>
<syntax>TraceEnable <var>[on|off|extended]</var></syntax>
<default>TraceEnable on</default>
<contextlist><context>server config</context></contextlist>
<compatibility>Apache 1.3.34, 2.0.55 以降</compatibility>
<usage>
<p>Apache のコア機能<transnote><module>core</module></transnote>と
<module>mod_proxy</module> 両方の <code>TRACE</code>
の挙動をオーバーライドします。デフォルトの <code>TraceEnable on</code>
は、リクエストボディを受け入れないような、RFC2616 に準拠した
<code>TRACE</code> リクエストを受け付けます。
<code>TraceEnale off</code> と設定すると、コアサーバと
<module>mod_proxy</module> は <code>405</code> (メソッド不許可)
エラーをクライアントに返します。</p>
<p>最後に、テストや調査目的などの限定用途として、仕様に準拠しない
<code>TraceEnable extended</code> を使って、リクエストボディを
受け付けるように挙動を変更できます。(オリジンサーバとしての)
Apache のコアでは、リクエストボディのサイズは 64k (
<code>Transfer-Encoding: chunked</code> が使われている場合は
chunk ヘッダ用に +8k) に制限されます。
Apache のコアは、ヘッダと全ての chunk ヘッダをレスポンスの
ボディとして返却します。
proxy サーバとしては、リクエストボディのサイズは 64k に制限されません。</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>UseCanonicalName</name>
<description>サーバが自分自身の名前とポートを決定する方法を設定する</description>
<syntax>UseCanonicalName On|Off|Dns</syntax>
<default>UseCanonicalName Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
<usage>
<p>多くの状況で Apache は<em>自己参照</em> URL、すなわち
同じサーバを指す URL、を作成する必要があります。
<code>UseCanonicalName On</code> の場合は、<directive
module="core">ServerName</directive> ディレクティブで指定されている
ホスト名とポート番号を使って、その正規名 (自己参照の名前) を生成します。
この名前は、すべての自己参照 URL で使われますし、CGI の
<code>SERVER_NAME</code> と <code>SERVER_PORT</code> でも使われます。</p>
<p><code>UseCanonicalName Off</code> の場合、
クライアントがホスト名とポートを指定したときには、
それらを元に自己参照 URL を作成します (指定がなかったときは
上の定義と同様にして正規名を解決します)。
これらの値は<a href="/vhosts/name-based.html">名前ベースの
バーチャルホスト</a>を実装で使われているのと同じ値で、
同じクライアントで取得できる値になっています。
CGI 変数 <code>SERVER_NAME</code> と <code>SERVER_PORT</code>
もクライアントから与えられた値から作成されます。</p>
<p>このような挙動が便利な例は、イントラネットのサーバで <code>www</code>
のような短い名前でユーザがマシンに接続するときです。
ユーザの入力で短いホスト名が使われていて、URL が<em>最後のスラッシュ無しの</em>
ディレクトリになっている <code>http://www/splat</code> のようなとき、
Apache はリクエストを <code>http://www.domain.com/splat/</code>
へリダイレクトします。
認証をするように設定していると、この場合
ユーザは 2 回認証をしなければならなくなります (<code>www</code> に
対して 1 回、<code>www.domain.com</code> に対してもう 1 回 --
詳細は <a
href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">この話題の
FAQ</a> を参照してください)。
しかし <directive>UseCanonicalName</directive> が <code>Off</code> になっていると、
Apache は <code>http://www/splat/</code> にリダイレクトします。</p>
<p>三つ目のオプション <code>UseCanonicalName DNS</code> は、
大規模な IP ベースのバーチャルホスティングで、
<code>Host:</code> ヘッダを提供しない古いクライアントを
サポートする場合を想定しています。
このオプションでは Apache は、クライアントが接続した IP アドレスに対して
DNS の逆引きを行なって、自己参照 URL を作成します。</p>
<note type="warning"><title>警告</title>
<p>CGI が <code>SERVER_NAME</code> に関して何らかの前提条件を
仮定しているときには、このオプションの設定によっては動作しなく
なるかもしれません。クライアントは実質的にはホスト名として
何でも望みの値を指定することができます。CGI が
<code>SERVER_NAME</code> を使って自己参照 URL を作成することしかしない
場合は、どの設定を行なっても大丈夫なはずです。</p></note>
</usage>
<seealso><directive module="core">UseCanonicalPhysicalPort</directive></seealso>
<seealso><directive module="core">ServerName</directive></seealso>
<seealso><directive module="mpm_common">Listen</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>UseCanonicalPhysicalPort</name>
<description>自分自身の名前とポート番号を解決する方法を設定する
</description>
<syntax>UseCanonicalPhysicalPort On|Off</syntax>
<default>UseCanonicalPhysicalPort Off</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context></contextlist>
<usage>
<p>さまざまな局面で <em>自己参照</em> URL -- それ自体のサーバを参照する URL
を作ることになります。<code>UseCanonicalPhysicalPort On</code> と設定すると、
<directive module="core">UseCanonicalName</directive> に従って別名を
生成する場合に、実際の物理ポート番号を使って構成するようになります。
<code>UseCanonicalPhysicalPort Off</code> の場合は、実際の物理ポート番号は
使用せず、設定された情報を元にポート番号を決めます。</p>
<note><title>注意</title>
<p>物理ポートが使われる場合の順番は次のようになっています:<br /><br />
<code>UseCanonicalName On</code></p>
<ul>
<li><code>ServerName</code> で指定されているポート番号</li>
<li>物理ポート番号</li>
<li>デフォルトのポート番号</li>
</ul>
<code>UseCanonicalName Off | DNS</code>
<ul>
<li><code>Host:</code> ヘッダをパースして取得されるポート番号</li>
<li>物理ポート番号</li>
<li><code>ServerName</code> で指定されているポート番号</li>
<li>デフォルトのポート番号</li>
</ul>
<p><code>UseCanonicalPhysicalPort Off</code> で、
物理ポート番号が上記の順序付けから除外されます。</p>
</note>
</usage>
<seealso><directive module="core">UseCanonicalName</directive></seealso>
<seealso><directive module="core">ServerName</directive></seealso>
<seealso><directive module="mpm_common">Listen</directive></seealso>
</directivesynopsis>
<directivesynopsis type="section">
<name>VirtualHost</name>
<description>特定のホスト名や IP アドレスのみに適用されるディレクティブを
囲む</description>
<syntax>&lt;VirtualHost
<var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
...&gt; ... &lt;/VirtualHost&gt;</syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p><directive type="section">VirtualHost</directive> 及び
<code>&lt;/VirtualHost&gt;</code> は、
特定のバーチャルホストに対してのみ適用されるディレクティブ群を括る
ために使われます。
バーチャルホストコンテキストで許可される全てのディレクティブを指定可能です。
サーバが、指定されたバーチャルホストにあるドキュメントへの
リクエストを受け付けた場合、
<directive type="section">VirtualHost</directive> セクションの中にある
ディレクティブが適用されます。
<var>Addr</var>は、次のものが利用できます:</p>
<ul>
<li>バーチャルホストの IP アドレス</li>
<li>バーチャルホストの IP に対応する完全なドメイン名 (非推奨)</li>
<li><code>NameVirtualHost *</code> と共に使われる、
すべての IP アドレスにマッチする文字 <code>*</code></li>
<li>IP ベースのバーチャルホストで他のものにマッチしない IP アドレス
のための文字列 <code>_default_</code></li>
</ul>
<example><title>例</title>
&lt;VirtualHost 10.1.2.3&gt;<br />
<indent>
ServerAdmin webmaster@host.example.com<br />
DocumentRoot /www/docs/host.example.com<br />
ServerName host.example.com<br />
ErrorLog logs/host.example.com-error_log<br />
TransferLog logs/host.example.com-access_log<br />
</indent>
&lt;/VirtualHost&gt;
</example>
<p>IPv6 アドレスはオプションのポート番号の指定と区別するために、
角括弧で括って指定する必要があります。次は IPv6 の例です:</p>
<example>
&lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
<indent>
ServerAdmin webmaster@host.example.com<br />
DocumentRoot /www/docs/host.example.com<br />
ServerName host.example.com<br />
ErrorLog logs/host.example.com-error_log<br />
TransferLog logs/host.example.com-access_log<br />
</indent>
&lt;/VirtualHost&gt;
</example>
<p>各々のバーチャルホストにはそれぞれ違う IP アドレス、ポート番号
もしくはホスト名に対応する必要があり、
1 番目の場合には複数のアドレスで IP パケットを受信できるように
サーバマシンを設定しなければなりません。
(もし、マシンが複数のネットワークインターフェースと持たない場合は、
(OSがサポートしていれば) <code>ifconfig alias</code> コマンドにより
達成できます)。</p>
<note><title>注意点</title>
<p><directive type="section">VirtualHost</directive> は Apache が Listen する
IP アドレスには影響を与え<strong>ません</strong>。
<directive module="mpm_common">Listen</directive> を
使って Apache が正しいアドレスを listen するように設定する必要があります。</p>
</note>
<p>IP ベースのバーチャルホストを使っている場合は、特別な名前
<code>_default_</code> を指定することができます。その場合は
そのバーチャルホストは他のバーチャルホストで明示的に挙げられていない
すべての IP アドレスにマッチします。<code>_default_</code> バーチャルホストが無い
場合に IP がバーチャルホストで指定されたものにマッチしないときは、
VirtualHost セクションの外のすべての定義からなる「主」サーバ設定が
使われます。(ただし、<directive
module="core">NameVirtualHost</directive> ディレクティブにマッチする
すべての IP アドレスは「主」サーバ設定も <code>_default_</code> バーチャルホストも
使わないことに注意してください。詳しくは <a
href="/vhosts/name-based.html">ネームベースのバーチャルホスト</a> を
参照してください。)</p>
<p><code>:port</code> といった形式で記述することにより、
マッチさせるポートを変更可能です。
この指定をしない場合には、主サーバ設定における
一番最後に <code><a href="#port">Port</a></code> で指定されたポートが
デフォルトとなります。
<code>:*</code> を指定することにより、
アドレス上の全てのポートにマッチします。(<code>_default_</code> のときは
これを使うことが推奨されています。)</p>
<p><directive type="section">VirtualHost</directive> ブロックごとに
<directive module="core">ServerName</directive> を指定すべきです。
もしなければ、メインサーバ設定の
<directive module="core">ServerName</directive>
が継承されます</p>
<note type="warning"><title>セキュリティ</title>
<p>サーバーを起動した以外のユーザがログファイルが保管されるディレクトリに
書き込み可能なときになぜセキュリティが破られる可能性があるかの詳細は
<a href="/misc/security_tips.html">セキュリティに関するコツ</a> を
参照してください。</p></note>
</usage>
<seealso><a href="/vhosts/">Apache バーチャルホスト説明書</a></seealso>
<seealso><a href="/dns-caveats.html">DNS と Apache に関する話</a></seealso>
<seealso><a href="/bind.html">Apache が使用するアドレスとポートの設定</a></seealso>
<seealso>リクエストを受けた際にこれらの異なるセクションが
組み合わされる方法については <a href="/sections.html">
&lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></seealso>
</directivesynopsis>
</modulesynopsis>