1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>core - Apache HTTP サーバ</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
14 <div id="page-header">
15 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
16 <p class="apache">Apache HTTP サーバ バージョン 2.3</p>
17 <img alt="" src="../images/feather.gif" /></div>
18 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
20 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="../">バージョン
21 2.3</a> > <a href="./">モジュール</a></div>
22 <div id="page-content">
23 <div id="preamble"><h1>Apache コア機能</h1>
25 <p><span>言語: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
26 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
27 <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> |
28 <a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
29 <a href="../ja/mod/core.html" title="Japanese"> ja </a> |
30 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
32 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>常に使用可能な Apache HTTP サーバのコア機能</td></tr>
33 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Core</td></tr></table>
35 <div id="quickview"><h3 class="directives">ディレクティブ</h3>
37 <li><img alt="" src="../images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
38 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
39 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
40 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
41 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
42 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
43 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</a></li>
44 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
45 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
46 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
47 <li><img alt="" src="../images/down.gif" /> <a href="#define">Define</a></li>
48 <li><img alt="" src="../images/down.gif" /> <a href="#directory"><Directory></a></li>
49 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li>
50 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
51 <li><img alt="" src="../images/down.gif" /> <a href="#else"><Else></a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#elseif"><ElseIf></a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
55 <li><img alt="" src="../images/down.gif" /> <a href="#error">Error</a></li>
56 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
57 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li>
59 <li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
61 <li><img alt="" src="../images/down.gif" /> <a href="#files"><Files></a></li>
62 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li>
63 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
64 <li><img alt="" src="../images/down.gif" /> <a href="#gprofdir">GprofDir</a></li>
65 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
66 <li><img alt="" src="../images/down.gif" /> <a href="#if"><If></a></li>
67 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li>
68 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule"><IfModule></a></li>
69 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
70 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
71 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
72 <li><img alt="" src="../images/down.gif" /> <a href="#limit"><Limit></a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
75 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
76 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
77 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
78 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
79 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
80 <li><img alt="" src="../images/down.gif" /> <a href="#location"><Location></a></li>
81 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li>
82 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
83 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#maxranges">MaxRanges</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#mutex">Mutex</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#protocol">Protocol</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
90 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
91 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
92 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
93 <li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
95 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
96 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
97 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
98 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
99 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
100 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
101 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
102 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
103 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
104 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
105 <li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
106 <li><img alt="" src="../images/down.gif" /> <a href="#undefine">UnDefine</a></li>
107 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
108 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
109 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li>
113 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
114 <div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">ディレクティブ</a></h2>
115 <table class="directive">
116 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロトコルを Listen しているソケットの最適化を設定する</td></tr>
117 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
118 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
119 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
120 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
121 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.1.5 以降</td></tr>
123 <p>Listen しているソケットに対して、OS が固有に持っているプロトコルについての最適化を
124 有効にするディレクティブです。大前提となる条件は、データが受信されるか
125 HTTP リクエスト全体がバッファされるかするまで、カーネルがサーバプロセスに
126 ソケットを送らないようになっている、ということです。現在サポートされているのは、
127 <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
128 FreeBSD の Accept Filter</a> と Linux のプリミティブな
129 <code>TCP_DEFER_ACCEPT</code> のみです。</p>
131 <p>FreeBSD のデフォルト値は :</p>
132 <div class="example"><p><code>
133 AcceptFilter http httpready <br />
134 AcceptFilter https dataready
137 <p><code>httpready</code> Accept Filter は HTTP リクエスト全体を、
138 カーネルレベルでバッファリングします。リクエスト全体を受信し終わると、
139 その後サーバプロセスにそれを送ります。詳細については <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">accf_http(9)</a>
140 を参照してください。HTTPS のリクエストは暗号化されているので <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">accf_data(9)</a>
143 <p>Linux でのデフォルト値は :</p>
144 <div class="example"><p><code>
145 AcceptFilter http data <br />
146 AcceptFilter https data
149 <p>Linux の <code>TCP_DEFER_ACCEPT</code> は HTTP リクエストのバッファリングを
150 サポートしていません。<code>none</code> 以外の値で
151 <code>TCP_DEFER_ACCEPT</code> が有効になります。詳細については Linux
152 man ページ <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">tcp(7)</a>
155 <p>引数に <code>none</code> を指定すると、プロトコルに対する全ての Accept
156 Filter が無効になります。<code>nntp</code> といった、先にサーバにデータを
157 送る必要のあるプロトコルに有効です :</p>
158 <div class="example"><p><code>AcceptFilter nntp none</code></p></div>
162 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
163 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">ディレクティブ</a></h2>
164 <table class="directive">
165 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>後に続くパス名情報を受け付けるリソースの指定</td></tr>
166 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
167 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
168 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
169 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
170 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
171 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
172 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.30 以降で使用可能</td></tr>
175 <p>このディレクティブは実際のファイル名 (もしくは存在するディレクトリの
176 存在しないファイル) の後に続くパス名情報があるリクエストを受け付けるか
177 拒否するかを制御します。続きのパス名情報はスクリプトには <code>PATH_INFO</code>
178 環境変数として利用可能になります。</p>
180 <p>例えば、<code>/test/</code> が、<code>here.html</code> というファイル
181 一つのみがあるディレクトリを指しているとします。そうすると、
182 <code>/test/here.html/more</code> と <code>/test/nothere.html/more</code>
183 へのリクエストは両方とも <code>/more</code> を <code>PATH_INFO</code> とします。</p>
185 <p><code class="directive">AcceptPathInfo</code> ディレクティブに指定可能な
189 <dt><code>Off</code></dt><dd>リクエストは存在するパスにそのまま
190 マップされる場合にのみ受け付けられます。ですから、上の例の
191 <code>/test/here.html/more</code> のように、本当のファイル名の
192 後にパス名情報が続くリクエストには 404 NOT FOUND エラーが返ります。</dd>
194 <dt><code>On</code></dt><dd>前の方のパスが存在するファイルにマップする場合は
195 リクエストが受け付けられます。上の例の <code>/test/here.html/more</code>
196 は <code>/test/here.html</code> が有効なファイルにマップすれば
199 <dt><code>Default</code></dt><dd>続きのパス名情報の扱いはリクエストの
200 <a href="../handler.html">ハンドラ</a>で決まります。
201 普通のファイルのためのコアハンドラのデフォルトは <code>PATH_INFO</code> を拒否します。
202 <a href="mod_cgi.html">cgi-script</a> や <a href="mod_isapi.html">isapi-handler</a> のようにスクリプトを扱うハンドラは
203 一般的にデフォルトで <code>PATH_INFO</code> を受け付けます。</dd>
206 <p><code>AcceptPathInfo</code> の主な目的はハンドラの <code>PATH_INFO</code> を
207 受け付けるか拒否するかの選択を上書きできるようにすることです。
208 例えば、これは例えば <a href="mod_include.html">INCLUDES</a> のような
209 <a href="../filter.html">フィルタ</a>を使って <code>PATH_INFO</code> に
210 基づいてコンテンツを生成しているときに必要になります。</p>
212 <div class="example"><p><code>
213 <Files "mypaths.shtml"><br />
214 <span class="indent">
215 Options +Includes<br />
216 SetOutputFilter INCLUDES<br />
217 AcceptPathInfo On<br />
223 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
224 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">ディレクティブ</a></h2>
225 <table class="directive">
226 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>分散設定ファイルの名前</td></tr>
227 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
228 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
229 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
230 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
231 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
233 <p>リクエストを処理するとき、サーバはディレクトリに
234 対して分散設定ファイルが<a href="#allowoverride">有効になっていれば</a>、
236 パス上にある全てのディレクトリから、ここで指定された名前の一覧の中で
237 最初に見つかったファイルをそれぞれ設定ファイルとして読み込みます。例えば:</p>
239 <div class="example"><p><code>
243 <p>という設定があると、以下のようにして無効にされていない限り、
244 ドキュメント <code>/usr/local/web/index.html</code>
245 を返す前に、サーバは <code>/.acl</code>, <code>/usr/.acl</code>,
246 <code>/usr/local/.acl</code>, <code>/usr/local/web/.acl</code> から
249 <div class="example"><p><code>
250 <Directory /><br />
251 <span class="indent">
252 AllowOverride None<br />
259 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
260 <li><a href="../configuring.html">設定ファイル</a></li>
261 <li><a href="../howto/htaccess.html">.htaccess ファイル</a></li>
264 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
265 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">ディレクティブ</a></h2>
266 <table class="directive">
267 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>レスポンスのコンテントタイプが <code>text/plain</code> あるいは
268 <code>text/html</code> の場合に追加するデフォルトの charset パラメータ</td></tr>
269 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
270 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
271 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
272 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
273 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
274 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
276 <p>レスポンスのコンテントタイプが <code>text/plain</code>
277 あるいは <code>text/html</code>
278 の場合に限りますが、レスポンスに追加するメディアタイプの文字セットパラメータ
279 (文字エンコーディングの名前) のデフォルト値を、このディレクティブで指定します。
280 これはレスポンス <span class="transnote">(<em>訳注:</em> レスポンスの HTML)</span> 内で <code>META</code>
281 要素で指定された、どのような文字セットも無効にしますが、
282 最終的な挙動はユーザのクライアント側の設定で決まります。
283 この機能は <code>AddDefaultCharset Off</code> という設定で無効になります。
284 <code>AddDefaultCharset On</code> にすれば、
285 Apache 内部のデフォルト文字セット <code>iso-8859-1</code> に設定されます。
286 その他 <var>charset</var> に指定できる値であれば、どんな値でも使えます。
287 指定する値は、MIME メディアタイプとして使われる
288 <a href="http://www.iana.org/assignments/character-sets">IANA
289 に登録されている文字セット名</a>のうちの一つにすべきです。
292 <div class="example"><p><code>
293 AddDefaultCharset utf-8
296 <p><code class="directive">AddDefaultCharset</code> を使うときは、全てのテキストリソースが
297 指定する文字エンコードになっていると分かっていて、かつ、
298 リソースの個々に文字セットを指定するのが大変な場合のみです。
299 例を挙げると、レガシーな CGI スクリプトなどの、動的に生成される
300 コンテンツを含むリソースに文字セットパラメータを追加する場合で、
301 ユーザの入力データが出力に入り、クロスサイトスクリプティングが
302 引き起こされうる場合です。デフォルト文字セットをセットしたとしても、
303 ブラウザの "文字エンコードの自動選択" 機能が有効になっているユーザを
304 守ることにはならないので、もちろんより良い解決策は単にスクリプトを修正
309 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
312 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
313 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">ディレクティブ</a></h2>
314 <table class="directive">
315 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>URL 中の符号化されたパス分離文字が先に伝えられるのを許可するかどうかを
317 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
318 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
319 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
320 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
321 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
322 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.46 以降で使用可能</td></tr>
324 <p><code class="directive">AllowEncodedSlashes</code> ディレクティブは符号化された
325 パス分離文字 (<code>/</code> は <code>%2F</code>、さらにシステムによっては
326 <code>\</code> に対応する <code>%5C</code>) が存在する URL の使用を
327 許可するかどうかを決定します。通常はそのような URL は 404 (Not found) エラー
330 <p><code class="directive">AllowEncodedSlashes</code> <code>On</code> による
331 パス分離文字の使用は、<code>PATH_INFO</code> と合わせて
334 <div class="note"><h3>注</h3>
335 <p>符号化されたスラッシュを許可することは、<em>復号</em>をすることを
336 意味<em>しません</em>。<code>%2F</code> や (関係するシステムでの)
337 <code>%5C</code> は、他の部分が復号された URL の中でもそのままの形式で
343 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
346 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
347 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">ディレクティブ</a></h2>
348 <table class="directive">
349 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>.htaccess</code> で許可されるディレクティブの種類</td></tr>
350 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
351 [<var>directive-type</var>] ...</code></td></tr>
352 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AllowOverride All</code></td></tr>
353 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr>
354 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
355 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
357 <p>サーバが (<code class="directive"><a href="#accessfilename">AccessFileName</a></code> によって指定された)
358 <code>.htaccess</code> ファイルを見つけた時、そのファイルの中で
359 宣言されたどのディレクティブがより前に定義された設定ディレクティブを
360 上書きできるかを知る必要があります。</p>
362 <div class="note"><h3><Directory> セクションでのみ使用可能</h3>
363 <code class="directive">AllowOverride</code> は正規表現無しの<code class="directive"><a href="#directory"><Directory></a></code>
364 セクションでのみ有効で、<code class="directive"><a href="#location"><Location></a></code> や <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code>
365 や <code class="directive"><a href="#files"><Files></a></code> セクションでは無効です。
368 <p>このディレクティブを <code>None</code> に設定すると、<a href="#accessfilename">.htaccess</a> ファイルは完全に
370 この場合、サーバはファイルシステムの <code>.htaccess</code> ファイルを読むことを
373 <p>このディレクティブが <code>All</code> に設定されている時には、
374 <code>.htaccess</code> という <a href="directive-dict.html#Context">コンテキスト</a> を持つ
375 全てのディレクティブが利用できます。</p>
377 <p><var>directive-type</var> には、以下のディレクティブ群の
385 認証に関するディレクティブの使用を許可する (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
386 <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
387 <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
388 <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>,
389 <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> <em>など</em>)。</dd>
394 ドキュメントタイプを制御するためのディレクティブの使用を許可する (<code class="directive"><a href="#defaulttype">DefaultType</a></code>, <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
395 <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>,
396 <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> の Add* と Remove*
398 ドキュメントのメタデータ (<code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>, <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookieexpires">CookieExpires</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiedomain">CookieDomain</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiestyle">CookieStyle</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookietracking">CookieTracking</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiename">CookieName</a></code>),
399 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> のディレクティブ <code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>) と
400 <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code> の
401 <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code>
408 ディレクトリインデックスを制御するためのディレクティブの使用を許可する
409 (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
410 <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>,
411 <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
412 <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>
418 ホストへのアクセス制御を行うためのディレクティブの使用を許可する (<code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code>, <code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code>).</dd>
420 <dt>Options[=<var>Option</var>,...]</dt>
423 特定のディレクトリにおける機能を指定するためのディレクティブの使用を許可する
424 (<code class="directive"><a href="#options">Options</a></code> と
425 <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>)。
426 <code class="directive"><a href="#options">Options</a></code> で設定するオプション
427 を、(空白を含めない) コンマ区切りのリストにして等号の後に続けることで
433 <div class="example"><p><code>
434 AllowOverride AuthConfig Indexes
437 <p>上の例では <code>AuthConfig</code> と <code>Indexes</code> のどちらにも
438 属さないディレクティブはすべて内部サーバエラーを引き起こします。</p>
442 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
443 <li><a href="../configuring.html">設定ファイル</a></li>
444 <li><a href="../howto/htaccess.html">.htaccess ファイル</a></li>
447 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
448 <div class="directive-section"><h2><a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a name="allowoverridelist" id="allowoverridelist">ディレクティブ</a></h2>
449 <table class="directive">
450 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Individual directives that are allowed in
451 <code>.htaccess</code> files</td></tr>
452 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AllowOverrideList None|<var>directive</var>
453 [<var>directive-type</var>] ...</code></td></tr>
454 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AllowOverrideList None</code></td></tr>
455 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr>
456 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
457 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
458 </table><p>The documentation for this directive has
459 not been translated yet. Please have a look at the English
460 version.</p><h3>参照</h3>
462 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
463 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
464 <li><a href="../configuring.html">Configuration Files</a></li>
465 <li><a href="../howto/htaccess.html">.htaccess Files</a></li>
468 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
469 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">ディレクティブ</a></h2>
470 <table class="directive">
471 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>CGI スクリプトのインタープリタの位置を調べるための手法</td></tr>
472 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
473 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
474 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
475 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
476 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
477 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>NetWare のみ</td></tr>
479 <p>このディレクティブは Apache が CGI スクリプトを実行するための
481 例えば、<code>CGIMapExtension sys:\foo.nlm .foo</code> と設定すると
482 <code>.foo</code> という拡張子のすべての CGI スクリプトは FOO インタープリタに
486 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
487 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">ディレクティブ</a></h2>
488 <table class="directive">
489 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>Content-MD5</code> HTTP 応答ヘッダの生成を有効にする</td></tr>
490 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ContentDigest On|Off</code></td></tr>
491 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ContentDigest Off</code></td></tr>
492 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
493 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Options</td></tr>
494 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
495 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
497 <p>このディレクティブは、RFC1864 及び RFC2616 において定義されている
498 <code>Content-MD5</code> ヘッダーの生成を有効にします。</p>
500 <p>MD5 は、任意長のデータの「メッセージダイジェスト」(「指紋」
501 と表現されることもある) を計算するアルゴリズムで、
502 データの変更があった場合には非常に高い信頼度でメッセージダイジェストに変更が
505 <p><code>Content-MD5</code> ヘッダは、エンドツーエンドで
506 エンティティボディーに含まれるメッセージの完全性チェック
507 (Message Integrity Check - MIC)を提供します。
508 このヘッダを調べることで、プロキシやクライアントは、
509 途中経路におけるエンティティボディの予期せぬ変更などを
510 検出することができます。ヘッダの例:</p>
512 <div class="example"><p><code>
513 Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
516 <p>リクエスト毎にメッセージダイジェストを計算する (値はキャッシュされません)
518 サーバパフォーマンスが低下することについて注意してください。</p>
520 <p><code>Content-MD5</code>は、<code class="module"><a href="../mod/core.html">core</a></code> 機能により処理された
522 SSI ドキュメントや CGI スクリプトの出力、バイトレンジを指定した
523 応答の場合にはこのヘッダは付与されません。
527 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
528 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">ディレクティブ</a></h2>
529 <table class="directive">
530 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバがコンテントタイプを決定できないときに
531 送られる MIME コンテントタイプ</td></tr>
532 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>DefaultType <var>MIME-type|none</var></code></td></tr>
533 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>DefaultType text/plain</code></td></tr>
534 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
535 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
536 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
537 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
538 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>引数 <code>none</code> は Apache 2.2.7 以降で利用可能</td></tr>
540 <p>サーバは、<a class="glossarylink" href="../glossary.html#mime-type" title="用語集を参照">MIME タイプ</a>
541 のマップからは決定できないドキュメントの送信を要求されることがあります。</p>
543 <p>サーバは、ドキュメントのコンテントタイプをクライアントに通知するべきです。
544 サーバで通常の方法ではこれが判定できない場合は、
545 <code>DefaultType</code> で指定されたタイプを利用します。
548 <div class="example"><p><code>
549 DefaultType image/gif
552 <p>これは <code>.gif</code> という拡張子がファイル名に含まれていない
553 多くの GIF 画像が含まれているディレクトリに適しているでしょう。</p>
555 <p>サーバでも管理者でも判定することができない (例えばプロクシの) 場合、
556 誤った情報を与えるよりは MIME タイプの指定がない状態が望ましいことも
557 あります。この場合は次のようにします :</p>
558 <div class="example"><p><code>
561 <p><code>DefaultType None</code> は httpd-2.2.7
564 <p><code class="directive"><a href="#forcetype">ForceType</a></code> ディレクティブと
565 違って、このディレクティブはデフォルトの MIME タイプを提供するだけで
566 あることに注意してください。ファイル名の拡張子を含め、
567 メディアタイプを決定できる他の MIME タイプの定義があれば
571 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
572 <div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">ディレクティブ</a></h2>
573 <table class="directive">
574 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>変数の存在を宣言する</td></tr>
575 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Define <var>parameter-name</var></code></td></tr>
576 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
577 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
578 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
580 <p><code class="program"><a href="../programs/httpd.html">httpd</a></code> の <code>-D</code>
582 <p>このディレクティブを使うと、スタートアップスクリプトに
583 記載されている <code>-D</code> 引数を書き換える必要なく、
584 <code class="directive"><a href="#ifdefine"><IfDefine></a></code>
585 セクションを切り替えることができます。</p>
588 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
589 <div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">ディレクティブ</a></h2>
590 <table class="directive">
591 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>指定のファイルシステムのディレクトリとサブディレクトリとのみに
592 適用されるディレクティブを囲む</td></tr>
593 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><Directory <var>directory-path</var>>
594 ... </Directory></code></td></tr>
595 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
596 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
597 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
599 <p>指定されたディレクトリとそのサブディレクトリにのみ
601 <code class="directive"><Directory></code> と
602 <code></Directory></code> を対として、ディレクティブ群を囲います。
603 その中には、ディレクトリコンテキストで許可された全てのディレクティブを
605 <var>directive-path</var> は、フルパスもしくは Unix のシェル形式の
607 <code>?</code> は任意の 1 文字、<code>*</code> は任意の文字列にマッチします。
608 シェルにおける指定同様、文字の範囲を <code>[]</code> で指定できます。
609 ワイルドカードは `/' 文字にはマッチしませんので、
610 <code>/home/user/public_html</code> には
611 <code><Directory /*/public_html></code> はマッチしませんが、
612 <code><Directory /home/*/public_html></code> はマッチします。
615 <div class="example"><p><code>
616 <Directory /usr/local/httpd/htdocs><br />
617 <span class="indent">
618 Options Indexes FollowSymLinks<br />
624 <p><var>directory-path</var> 引数には注意してください: その引数は
625 Apache がファイルをアクセスするために使うファイルシステムのパスに
626 そのままマッチする必要があります。ある <code><Directory></code> に
627 適用されるディレクティブは、別のシンボリックリンクをたどったりして
628 同じディレクトリを違うパスでアクセスした場合には適用されません。</p>
631 <p><code>~</code> という文字を
632 付加することで<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を利用することもできます。
635 <div class="example"><p><code>
636 <Directory ~ "^/www/.*/[0-9]{3}">
639 <p>といった指定の場合、<code>/www/</code> 以下にある数字
640 3 文字のディレクトリにマッチします。</p>
642 <p>もし複数の (正規表現以外の) <code class="directive"><Directory></code>セクションが
643 ドキュメントを含むディレクトリ (やその上位ディレクトリのどれか) とマッチしたならば、
644 <a href="#accessfilename">.htaccess</a> ファイルのディレクティブも読み込みつつ、
648 <div class="example"><p><code>
649 <Directory /><br />
650 <span class="indent">
651 AllowOverride None<br />
653 </Directory><br />
655 <Directory /home/><br />
656 <span class="indent">
657 AllowOverride FileInfo<br />
662 <p>と設定し、ドキュメント <code>/home/web/dir/doc.html</code> への
663 アクセスがあった場合には以下のように動作します:</p>
666 <li><code>AllowOverride None</code> が適用される。
667 (<code>.htaccess</code> ファイルは無効になる)</li>
669 <li><code>AllowOverride FileInfo</code> が適用される
670 (<code>/home</code> ディレクトリに対して)。</li>
672 <li><code>/home/.htaccess</code>, <code>/home/web/.htaccess</code>,
673 <code>/home/web/dir/.htaccess</code> の順にそれらのファイル中の
674 FileInfo ディレクティブが適用される。</li>
677 <p>正規表現は、通常のセクションがすべて適用されるまで
679 その後、全ての正規表現が設定ファイルに現れた順で試されます。
682 <div class="example"><p><code>
683 <Directory ~ abc$><br />
684 <span class="indent">
685 # ... directives here ...<br />
690 <p>正規表現のセクションはすべての通常の <code class="directive"><Directory></code> と
691 <code>.htaccess</code> の適用が終わるまで考慮されません。
692 その後で、正規表現は <code>/home/abc/public_html/abc</code> にマッチし、
693 対応する <code class="directive"><Directory></code> が適用されます。</p>
695 <p><strong>Apache のデフォルトでは <code><Directory /></code> へのアクセスは
696 <code>Allow from All</code> になっていることに注意してください。
697 これは、URL からマップされたどのファイルでも Apache は送るということです。
698 これは以下のようにして変更することが推奨されています。</strong></p>
700 <div class="example"><p><code>
701 <Directory /><br />
702 <span class="indent">
703 Order Deny,Allow<br />
709 <p><strong>そしてアクセスを<em>可能にしたい</em>ディレクトリに対して
711 このあたりについては、<a href="../misc/security_tips.html">セキュリティに関するコツ</a>を
712 参照してください。</strong></p>
714 <p>ディレクトリセクションは <code>httpd.conf</code> ファイルに書きます。
715 <code class="directive"><Directory></code>
716 ディレクティブは入れ子にすることができず、
717 <code class="directive"><a href="#limit"><Limit></a></code> や <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> セクションの中にも
723 <li>リクエストを受けた際にこれらの異なるセクションが
724 組み合わされる方法については <a href="../sections.html">
725 <Directory>, <Location>, <Files> セクションの動作法</a></li>
728 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
729 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">ディレクティブ</a></h2>
730 <table class="directive">
731 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>正規表現にマッチするファイルシステムのディレクトリと
732 サブディレクトリとのみに適用されるディレクティブを囲む</td></tr>
733 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><DirectoryMatch <var>regex</var>>
734 ... </DirectoryMatch></code></td></tr>
735 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
736 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
737 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
739 <p><code class="directive"><a href="#directory"><Directory></a></code>
740 ディレクティブと同様に、<code class="directive"><DirectoryMatch></code>
741 と <code></DirectoryMatch></code> は指定されたディレクトリと
742 そのサブディレクトリにのみ適用されるディレクティブ群を囲います。
743 しかし、このディレクティブは引数として<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>をとります。例えば:</p>
745 <div class="example"><p><code>
746 <DirectoryMatch "^/www/(.+/)?[0-9]{3}">
749 <p>は <code>/www/</code> 以下にある数字 3 文字のディレクトリにマッチします。</p>
754 <li>通常の <code class="directive"><Directory></code> と正規表現の指定が
755 適用される順番については <code class="directive"><a href="#directory"><Directory></a></code></li>
756 <li>リクエストを受けた際にこれらの異なるセクションが
757 組み合わされる方法については <a href="../sections.html">
758 <Directory>, <Location>, <Files> セクションの動作法</a></li>
761 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
762 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">ディレクティブ</a></h2>
763 <table class="directive">
764 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ウェブから見えるメインのドキュメントツリーになる
766 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
767 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
768 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
769 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
770 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
772 <p>このディレクティブは、<code class="program"><a href="../programs/httpd.html">httpd</a></code>
773 がファイルを提供するディレクトリを設定します。
774 <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> のようなディレクティブにマッチしない場合には、
775 ドキュメントの (訳注:ファイルシステム上の) パスを生成するために、
776 リクエストされた URL のパス部分をドキュメントルートに付与します。
779 <div class="example"><p><code>
780 DocumentRoot /usr/web
784 <code>http://www.my.host.com/index.html</code> へのアクセスがあれば
785 <code>/usr/web/index.html</code> が返されます。
786 <var>directory-path</var> が絶対パスでない場合は、
787 <code class="directive"><a href="#serverroot">ServerRoot</a></code>
790 <p><code class="directive">DocumentRoot</code> は最後のスラッシュ無しで
795 <li><a href="../urlmapping.html#documentroot">URL をファイルシステムの位置に
799 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
800 <div class="directive-section"><h2><a name="Else" id="Else"><Else></a> <a name="else" id="else">ディレクティブ</a></h2>
801 <table class="directive">
802 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Contains directives that apply only if the condition of a
803 previous <code class="directive"><a href="#if"><If></a></code> or
804 <code class="directive"><a href="#elseif"><ElseIf></a></code> section is not
805 satisfied by a request at runtime</td></tr>
806 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><Else> ... </Else></code></td></tr>
807 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
808 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
809 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
810 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
811 </table><p>The documentation for this directive has
812 not been translated yet. Please have a look at the English
813 version.</p><h3>参照</h3>
815 <li><code class="directive"><a href="#if"><If></a></code></li>
816 <li><code class="directive"><a href="#elseif"><ElseIf></a></code></li>
817 <li><a href="../sections.html">How <Directory>, <Location>,
818 <Files> sections work</a> for an explanation of how these
819 different sections are combined when a request is received.
820 <code class="directive"><If></code>,
821 <code class="directive"><ElseIf></code>, and
822 <code class="directive"><Else></code> are applied last.</li>
825 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
826 <div class="directive-section"><h2><a name="ElseIf" id="ElseIf"><ElseIf></a> <a name="elseif" id="elseif">ディレクティブ</a></h2>
827 <table class="directive">
828 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Contains directives that apply only if a condition is satisfied
829 by a request at runtime while the condition of a previous
830 <code class="directive"><a href="#if"><If></a></code> or
831 <code class="directive"><ElseIf></code> section is not
833 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><ElseIf <var>expression</var>> ... </ElseIf></code></td></tr>
834 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
835 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
836 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
837 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
838 </table><p>The documentation for this directive has
839 not been translated yet. Please have a look at the English
840 version.</p><h3>参照</h3>
842 <li><a href="../expr.html">Expressions in Apache HTTP Server</a>,
843 for a complete reference and more examples.</li>
844 <li><code class="directive"><a href="#if"><If></a></code></li>
845 <li><code class="directive"><a href="#else"><Else></a></code></li>
846 <li><a href="../sections.html">How <Directory>, <Location>,
847 <Files> sections work</a> for an explanation of how these
848 different sections are combined when a request is received.
849 <code class="directive"><If></code>,
850 <code class="directive"><ElseIf></code>, and
851 <code class="directive"><Else></code> are applied last.</li>
854 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
855 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">ディレクティブ</a></h2>
856 <table class="directive">
857 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>配送中にファイルを読み込むためにメモリマッピングを
859 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
860 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>EnableMMAP On</code></td></tr>
861 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
862 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
863 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
864 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
866 <p>このディレクティブは配送中にファイルの内容を読み込む必要があるときに
867 <code class="program"><a href="../programs/httpd.html">httpd</a></code> がメモリマッピングを使うかどうかを制御します。
869 例えば、<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> を使って SSI ファイルを配送
870 するときのように、ファイルの途中のデータをアクセスする必要があるときには
871 Apache は OS がサポートしていればファイルをメモリにマップします。</p>
874 このメモリマップは性能の向上を持たらすことがあります。
875 しかし、環境によっては運用上の問題を防ぐためにメモリマッピングを
876 使用しないようにした方が良い場合もあります:</p>
879 <li>マルチプロセッサシステムの中にはメモリマッピングをすると
880 <code class="program"><a href="../programs/httpd.html">httpd</a></code> の性能が落ちるものがあります。</li>
881 <li>NFS マウントされた <code class="directive"><a href="#documentroot">DocumentRoot</a></code>
882 では、<code class="program"><a href="../programs/httpd.html">httpd</a></code> がメモリマップしている間にファイルが削除されたり
883 短くなったりしたときに起こるセグメンテーションフォールトのために
884 <code class="program"><a href="../programs/httpd.html">httpd</a></code> がクラッシュする可能性があります。</li>
887 <p>これらの問題に当てはまるサーバの設定の場合は、以下のようにして
888 ファイルの配送時のメモリマッピングを使用不可にしてください:</p>
890 <div class="example"><p><code>
894 <p>NFS マウントされたファイルには、問題のあるファイルにのみ明示的に
897 <div class="example"><p><code>
898 <Directory "/path-to-nfs-files">
899 <span class="indent">
906 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
907 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">ディレクティブ</a></h2>
908 <table class="directive">
909 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ファイルのクライアントへの配送時にカーネルの sendfile サポートを
911 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
912 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>EnableSendfile On</code></td></tr>
913 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
914 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
915 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
916 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
917 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>バージョン 2.0.44 以降で使用可能</td></tr>
919 <p>このディレクティブはクライアントにファイルの内容を送るときに
920 <code class="program"><a href="../programs/httpd.html">httpd</a></code> がカーネルの
921 sendfile サポートを使うかどうかを制御します。デフォルトでは、
922 例えば静的なファイルの配送のように、リクエストの処理にファイルの
923 途中のデータのアクセスを必要としないときには、Apache は OS が
924 サポートしていればファイルを読み込むことなく sendfile を使って
927 <p>sendfile は read と send を別々に行なうことと、バッファの割り当てを
928 回避します。しかし、プラットフォームやファイルシステムの中には
929 運用上の問題を避けるためにこの機能を使用不可にした方が良い場合があります:</p>
932 <li>プラットフォームの中にはビルドシステムが検知できなかった、壊れた
933 sendfile のサポートが存在するものがあります。これは特に
934 バイナリが別のマシンでビルドされ、壊れた sendfile のあるマシンに
936 <li>Linux では、sendfile を用いると、
937 IPv6 使用時に存在する特定ネットワークカードの TCP-checksum
938 オフロードのバグを踏んでしまいます。</li>
939 <li>Itanium 上の Linux では、sendfile では 2GB 以上の
940 ファイルを扱うことができません。</li>
941 <li>ネットワークマウントされた <code class="directive"><a href="#documentroot">DocumentRoot</a></code>
943 では、カーネルは自身のキャッシュを使ってネットワークからのファイルを
944 送ることができないことがあります。</li>
947 <p>これらの問題に当てはまるサーバの設定の場合は、以下のようにして
948 この機能を使用不可にしてください:</p>
951 <div class="example"><p><code>
955 <p>NFS や SMB マウントされたファイルには、問題のあるファイルにのみ明示的に
958 <div class="example"><p><code>
959 <Directory "/path-to-nfs-files">
960 <span class="indent">
967 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
968 <div class="directive-section"><h2><a name="Error" id="Error">Error</a> <a name="error" id="error">ディレクティブ</a></h2>
969 <table class="directive">
970 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Abort configuration parsing with a custom error message</td></tr>
971 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Error <var>message</var></code></td></tr>
972 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
973 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
974 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
975 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.3.9 and later</td></tr>
976 </table><p>The documentation for this directive has
977 not been translated yet. Please have a look at the English
979 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
980 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">ディレクティブ</a></h2>
981 <table class="directive">
982 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>エラーが発生したときにサーバがクライアントに送るもの</td></tr>
983 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ErrorDocument <var>error-code document</var></code></td></tr>
984 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
985 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
986 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
987 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
989 <p>問題やエラーが発生したときの動作として、
990 Apache には以下の四つのうち一つの動作を設定することができます。</p>
993 <li>Apache 標準の簡単なエラーメッセージを表示</li>
995 <li>自分で指定したメッセージを表示</li>
997 <li>問題やエラーの処理をする為に、自サーバ内の
998 <var>URL-path</var> へリダイレクト</li>
1000 <li>問題やエラーの処理をする為に、外部の <var>URL</var> へリダイレクト</li>
1003 <p>最初のものがデフォルトの動作で、2 番目から 4 番目は、
1004 <code class="directive">ErrorDocument</code>ディレクティブにより、
1005 HTTP のレスポンスコードと、メッセージか URL を指定することで設定します。
1006 Apache が問題もしくはエラーに関する追加情報を提供することがあります。</p>
1008 <p>URL の場合は、スラッシュで始まる (/) ローカルの web-path (
1009 <code class="directive"><a href="#documentroot">DocumentRoot</a></code> からの相対パス
1010 ) か、クライアントが解決できる完全な URL を指定します。
1011 もしくは、ブラウザに表示されるメッセージを指定できます。
1014 <div class="example"><p><code>
1015 ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1016 ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
1017 ErrorDocument 401 /subscription_info.html<br />
1018 ErrorDocument 403 "Sorry can't allow you access today"
1021 <p>加えて、特別な値 <code>default</code> を使って Apache に
1022 ハードコードされている簡単なメッセージを指定することができます。
1023 通常は必要ではありませんが、<code>default</code> を使うと
1024 既存の <code class="directive">ErrorDocument</code> ディレクティブの設定を
1025 継承するところで、Apache のハードコードされた簡単なメッセージに
1028 <div class="example"><p><code>
1029 ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1030 <Directory /web/docs><br />
1031 <span class="indent">
1032 ErrorDocument 404 default<br />
1037 <p>リモート URL (例えば、頭に <code>http</code> と付与した方法) を
1038 <code class="directive">ErrorDocument</code> に指定するとき、
1039 たとえ文書が同じサーバにあろうとも、ドキュメントがどこにあるかを通知するために、
1040 Apache はリダイレクトをクライアントに送出するということに、注意してください。
1041 これにはいろいろと関連して起こる問題があります。
1042 中でも最も重要なのは、クライアントは元々のエラーステータスコードを受け取らず、
1043 代わりにリダイレクトのステータスコードを受け取るということです。
1044 これにより、ステータスコードを使って URL が有効であるかどうかを決定しようとする
1045 ウェブロボットやその他クライアントを、混乱させるかもしれません。
1046 さらに、<code>ErrorDocument 401</code> にリモートの URL を指定すると、
1047 クライアントは 401 というステータスコードを受け取らないため、
1048 パスワードをユーザーに入力要求しなければならないことがわかりません。
1049 従って、<strong><code>ErrorDocument 401</code> というディレクティブを使う場合は、
1050 必ずローカルな文書を参照しなければなりません。</strong></p>
1052 <p>Microsoft Internet Explorer (MSIE) はデフォルトではサーバが生成したエラーメッセージが
1053 「小さすぎる」ときには無視をして自分自身の「やさしい」エラーメッセージで
1054 置換します。サイズのしきい値はエラーの種類によって異なりますが、
1055 一般的にはエラーの文書を 512 バイトよりも大きくすると、MSIE は
1056 サーバが生成したエラーを隠さずに表示します。詳しい情報は Microsoft
1057 Knowledge Base の記事 <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>
1060 <p>ほとんどのエラーメッセージを上書きすることができますが、特定の状況下では
1061 <code class="directive"><a href="#errordocument">ErrorDocument</a></code> の設定にかかわらず
1063 特に、不正な形式のリクエストが検出された場合、通常のリクエスト処理は
1064 即座に中止され、内蔵のエラーメッセージが返されます。
1065 この処置は不正なリクエストによって引き起こされる、セキュリティ問題から
1068 <p>2.0 より前のバージョンでは、対になっていない二重引用符を
1069 先頭に付けることによりメッセージであることを指定していました。</p>
1074 <li><a href="../custom-error.html">カスタマイズ可能な
1075 エラー応答のドキュメンテーション</a></li>
1078 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1079 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">ディレクティブ</a></h2>
1080 <table class="directive">
1081 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバがエラーをログ収集する場所</td></tr>
1082 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</code></td></tr>
1083 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
1084 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1085 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1086 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1088 <p><code class="directive">ErrorLog</code> ディレクティブは、
1090 記録する為のファイルの名前を設定します。
1091 <var>file-path</var> が絶対パスでないときは、<code class="directive"><a href="#serverroot">ServerRoot</a></code> からの相対パスとみなされます。</p>
1093 <div class="example"><h3>例</h3><p><code>
1094 ErrorLog /var/log/httpd/error_log
1097 <p><var>file-path</var> がパイプ (|) から始まる場合は、
1098 エラーログを処理するために実行されるコマンドが
1101 <div class="example"><h3>例</h3><p><code>
1102 ErrorLog "|/usr/local/bin/httpd_errors"
1105 <p>ファイル名の変わりに <code>syslog</code> と指定することによって、
1106 システムがサポートしていれば syslogd(8) を利用したロギングが有効になります。
1107 デフォルトでは、<code>local7</code> ファシリティとなりますが、
1108 <code>syslog:<var>facility</var></code> といった形で記述することにより、
1109 通常 syslog(1) のドキュメントで説明されているファシリティの一つを使うように
1112 <div class="example"><h3>例</h3><p><code>
1113 ErrorLog syslog:user
1117 ログファイルを格納するディレクトリが、サーバを起動したユーザ以外の
1118 ユーザによって書き込める場合にセキュリティが破られる可能性があることに
1119 関する詳細は <a href="../misc/security_tips.html#serverroot">セキュリティに関するコツ</a> を
1121 <div class="warning"><h3>注</h3>
1122 <p>Unix 以外のプラットフォームでファイルのパスを入力するときは、
1123 プラットフォームがバックスラッシュの使用を許していたとしても、
1124 確実にスラッシュのみが使用されるように注意してください。一般的には、
1125 設定ファイル全般でスラッシュのみを使う方が良いでしょう。</p>
1130 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1131 <li><a href="../logs.html">Apache ログファイル</a></li>
1134 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1135 <div class="directive-section"><h2><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">ディレクティブ</a></h2>
1136 <table class="directive">
1137 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Format specification for error log entries</td></tr>
1138 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> ErrorLog [connection|request] <var>format</var></code></td></tr>
1139 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1140 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1141 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1142 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache httpd 2.3.9 and later</td></tr>
1143 </table><p>The documentation for this directive has
1144 not been translated yet. Please have a look at the English
1145 version.</p><h3>参照</h3>
1147 <li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
1148 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1149 <li><a href="../logs.html">Apache HTTP Server Log Files</a></li>
1152 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1153 <div class="directive-section"><h2><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">ディレクティブ</a></h2>
1154 <table class="directive">
1155 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Keep track of extended status information for each
1157 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
1158 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ExtendedStatus Off[*]</code></td></tr>
1159 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1160 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1161 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1162 </table><p>The documentation for this directive has
1163 not been translated yet. Please have a look at the English
1165 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1166 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">ディレクティブ</a></h2>
1167 <table class="directive">
1168 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ETag HTTP 応答ヘッダを作成するために使用される
1170 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
1171 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1172 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1173 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
1174 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1175 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1178 <code class="directive">FileETag</code> ディレクティブは
1179 ドキュメントがファイルに基づいたものであるときに、
1180 <code>ETag</code> (エンティティタグ) 応答ヘッダフィールドを作成するときに使用する
1181 ファイルの属性を設定します。 (<code>ETag</code> の値はネットワークの帯域を節約するための
1182 キャッシュの管理で使われます。) Apache 1.3.22 以前では、<code>ETag</code> の値は
1183 <em>常に</em>ファイルの inode, サイズ、最終修正時刻 (mtime) から作成
1184 されていました。<code class="directive">FileETag</code> ディレクティブにより、これらのどれを使うかを
1185 選ぶことができます。認識されるキーワードは:
1189 <dt><strong>INode</strong></dt>
1190 <dd>ファイルの inode 番号を計算に使います</dd>
1191 <dt><strong>MTime</strong></dt>
1192 <dd>ファイルの最終修正時刻を使います</dd>
1193 <dt><strong>Size</strong></dt>
1194 <dd>ファイルの中身のバイト数を使います</dd>
1195 <dt><strong>All</strong></dt>
1196 <dd>使用可能なすべてのフィールドを使います。
1197 これは <div class="example"><p><code>FileETag INode MTime Size</code></p></div> と等価です。</dd>
1198 <dt><strong>None</strong></dt>
1199 <dd>ドキュメントがファイルに基づいたものでも、<code>ETag</code> フィールドを
1203 <p><code>INode</code>, <code>MTime</code>, <code>Size</code> キーワードには
1204 <code>+</code> や <code>-</code> を前に付けて
1205 指定することもできます。この場合は、より広い範囲から継承された
1206 デフォルトの設定に変更を加えるようになります。そのような接頭辞の
1207 無いキーワードを指定すると、即座に継承した設定を無効にします。</p>
1210 <code>FileETag INode MTime Size</code> があり、
1211 サブディレクトリの設定に <code>FileETag -INode</code> があるときは、
1212 そのサブディレクトリの設定は (設定が上書きされなければサブディレクトリの
1213 サブディレクトリにも継承されます) <code>FileETag MTime Size</code>
1215 <div class="warning"><h3>警告</h3>
1216 WebDAV を使っていて、<code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> をストレージプロバイダとして
1217 使っているような Directory や Location では、デフォルト値を変更しないでください。
1218 <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> では、条件付リクエストでの比較演算に
1219 <code>INode MTime Size</code>
1221 <code class="directive">FileETag</code> で <code>ETag</code> フォーマットを
1222 変更してしまうと、条件付リクエストでうまく動作しなくなります。
1226 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1227 <div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">ディレクティブ</a></h2>
1228 <table class="directive">
1229 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>マッチするファイル名に適用されるディレクティブを囲む</td></tr>
1230 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><Files <var>filename</var>> ... </Files></code></td></tr>
1231 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1232 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1233 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1234 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1236 <p><code class="directive"><Files></code> ディレクティブは、
1237 その中にあるディレクティブの適用範囲をファイル名で制限します。
1238 <code class="directive"><a href="#directory"><Directory></a></code> ディレクティブや <code class="directive"><a href="#location"><Location></a></code> ディレクティブと
1240 これは、<code></Files></code> ディレクティブと対に
1242 このセクション中のディレクティブは、ベース名 (ファイル名の最後の部分)
1243 が指定されたファイル名にマッチするすべてのオブジェクトに適用されます。
1244 <code class="directive"><Files></code> セクションは
1245 <code class="directive"><Directory></code> セクションと
1246 <code>.htaccess</code> が読み込まれた後、
1247 <code class="directive"><Location></code> セクションよりは先に
1249 <code class="directive"><Files></code> は、
1250 <code class="directive"><Directory></code> セクション内に
1252 ファイルシステムの一部にのみ限定して適用させることができます。</p>
1254 <p><var>filename</var> 引数は、ファイル名かワイルドカード文字列
1255 で、ワイルドカードでは <code>?</code> は一つの文字、<code>*</code> は任意の文字列にマッチします。
1256 <code>~</code> という文字を付加することで<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を使うこともできます。
1259 <div class="example"><p><code>
1260 <Files ~ "\.(gif|jpe?g|png)$">
1263 <p>とすることにより、一般的なインターネットの画像フォーマットにマッチします。
1265 <code class="directive"><a href="#filesmatch"><FilesMatch></a></code> を使う方が
1268 <p>ちなみに、<code class="directive"><a href="#directory"><Directory></a></code> と <code class="directive"><a href="#location"><Location></a></code> セクションとは異なり、
1269 <code class="directive"><Files></code>
1270 は <code>.htaccess</code> ファイル内で利用することができます。
1271 これにより、ユーザがファイル毎にアクセスの制御を行なうことができるように
1277 <li>リクエストを受けた際にこれらの異なるセクションが
1278 組み合わされる方法については <a href="../sections.html">
1279 <Directory>, <Location>, <Files> セクションの動作法</a></li>
1282 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1283 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">ディレクティブ</a></h2>
1284 <table class="directive">
1285 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>正規表現にマッチするファイル名に適用される
1286 ディレクティブを囲む</td></tr>
1287 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><FilesMatch <var>regex</var>> ... </FilesMatch></code></td></tr>
1288 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1289 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1290 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1291 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1293 <p><code class="directive"><FilesMatch></code> ディレクティブは、
1294 <code class="directive"><a href="#files"><Files></a></code>
1295 ディレクティブ同様にその中にあるディレクティブの適用範囲をファイル名で制限します。ただし、
1296 このディレクティブには<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を指定します。
1299 <div class="example"><p><code>
1300 <FilesMatch "\.(gif|jpe?g|png)$">
1303 <p>は一般的なインターネットの画像形式にマッチします。</p>
1307 <li>リクエストを受けた際にこれらの異なるセクションが
1308 組み合わされる方法については <a href="../sections.html">
1309 <Directory>, <Location>, <Files> セクションの動作法</a></li>
1312 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1313 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">ディレクティブ</a></h2>
1314 <table class="directive">
1315 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>すべてのマッチするファイルが指定の MIME コンテントタイプで
1317 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ForceType <var>MIME-type</var>|None</code></td></tr>
1318 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
1319 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
1320 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1321 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1322 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 で core に移動</td></tr>
1324 <p><code>.htaccess</code> や <code class="directive"><a href="#directory"><Directory></a></code> セクション、
1325 <code class="directive"><a href="#location"><Location></a></code> セクション、
1326 <code class="directive"><a href="#files"><Files></a></code> セクションに
1327 書かれた場合、このディレクティブはそこにあるすべてのファイルが
1328 <var>MIME-type</var>
1329 で指定されたコンテントタイプとして扱われるようにします。たとえば、
1330 GIF ファイルばかりのディレクトリがあって、すべてのファイルを <code>.gif</code>
1331 で終わらせたくはないときに、以下のものを使用します:</p>
1333 <div class="example"><p><code>
1337 <p><code class="directive"><a href="#defaulttype">DefaultType</a></code> と違って
1338 このディレクティブはメディアタイプを決めることができるかもしれない
1339 ファイルの拡張子も含め、すべての MIME タイプの関連付けを
1340 上書きすることに注意してください。</p>
1342 <p><code>None</code> という値を使うことで <code class="directive">ForceType</code> の
1345 <div class="example"><p><code>
1346 # force all files to be image/gif:<br />
1347 <Location /images><br />
1348 <span class="indent">
1349 ForceType image/gif<br />
1351 </Location><br />
1353 # but normal mime-type associations here:<br />
1354 <Location /images/mixed><br />
1355 <span class="indent">
1356 ForceType None<br />
1362 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1363 <div class="directive-section"><h2><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">ディレクティブ</a></h2>
1364 <table class="directive">
1365 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Directory to write gmon.out profiling data to. </td></tr>
1366 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr>
1367 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1368 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1369 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1370 </table><p>The documentation for this directive has
1371 not been translated yet. Please have a look at the English
1373 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1374 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">ディレクティブ</a></h2>
1375 <table class="directive">
1376 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントの IP アドレスの DNS ルックアップを
1378 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1379 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>HostnameLookups Off</code></td></tr>
1380 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
1381 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1382 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1384 <p>このディレクティブは、ホスト名をログ収集できるように
1386 (さらに、CGI/SSI に <code>REMOTE_HOST</code> 変数として渡します)。
1387 <code>Double</code>を指定した場合、2 重の逆引きを行ないます。
1388 つまり、逆引きの後に、その結果に対して正引きを行ないます。正引きの
1389 結果の IP アドレスの中にオリジナルのアドレスと一致するものがなければ
1390 なりません。("tcpwrappers" の用語では <code>PARANOID</code> と呼ばれています。)</p>
1392 <p><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> でホスト名によるアクセス
1394 設定の如何によらず 2 重の逆引きが実行されます。
1395 これは、セキュリティを保つために必要です。
1396 <code>HostnameLookups Double</code> を設定しない限り、
1397 他の部分はこの 2 重逆引きの結果を使うことはできません。
1398 例えば、<code>HostnameLookups On</code> と設定してある状態で、
1399 ホスト名によるアクセス制限を行なったオブジェクトへの
1400 リクエストを受けたとすると、2 重の逆引きが成功するか否かによらず、
1401 <code>REMOTE_HOST</code> には通常の逆引き結果が渡されます。</p>
1404 本当に逆引きを必要としているわけではないサイトの
1405 ネットワークトラフィックを低減させるために、<code>Off</code> になっています。
1406 ルックアップによる余計な遅延がなくなるため、
1408 DNS のルックアップには、かなりの時間が必要となる場合が多く、
1409 負荷の高いサイトではこのディレクティブは <code>Off</code> にすべきです。
1410 なお、<var>/support</var> ディレクトリに含まれ、デフォルトでは
1411 インストールディレクトリの <code>bin</code> サブディレクトリに
1412 インストールされる <code class="program"><a href="../programs/logresolve.html">logresolve</a></code> ユーティリティにより、
1413 Apache の動作とは別に、ログに残されている IP アドレスからホスト名を
1414 ルックアップすることが可能です。</p>
1417 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1418 <div class="directive-section"><h2><a name="If" id="If"><If></a> <a name="if" id="if">ディレクティブ</a></h2>
1419 <table class="directive">
1420 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>実行時、リクエストが条件を満たした場合にのみ適用される
1421 ディレクティブを包含する</td></tr>
1422 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr>
1423 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1424 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1425 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1426 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1428 <p><code class="directive"><If></code> ディレクティブは
1429 実行時に式を評価し、条件式が真になるときにのみ
1433 <div class="example"><p><code>
1434 <If "$req{Host} = ''">
1437 <p>上記例は <var>Host:</var> ヘッダの存在しない HTTP/1.0 のリクエストに
1442 <li><a href="../sections.html">どのように <Directory>, <Location>,
1443 <Files> セクションが動作するか</a> では、リクエストを受けたときに、
1444 これらの異なるセクションがどのように組み合わさるかについて記載されています。
1445 <code class="directive"><If></code> は
1446 <code class="directive"><Files></code>
1447 と同じ処理順と用法になっています。</li>
1450 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1451 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">ディレクティブ</a></h2>
1452 <table class="directive">
1453 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>起動時にテストが真であるときのみに処理されるディレクティブを
1455 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><IfDefine [!]<var>parameter-name</var>> ...
1456 </IfDefine></code></td></tr>
1457 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1458 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1459 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1460 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1462 <p><code><IfDefine <var>test</var>>...</IfDefine></code>
1464 ディレクティブを条件付きで指定するために利用します。
1465 <code class="directive"><IfDefine></code> セクションに
1466 含まれるディレクティブは、<var>test</var>が
1468 もし <var>test</var> が定義されていなければ、
1469 開始と終了の指定の間のディレクティブは無視されます。</p>
1471 <p><code class="directive"><IfDefine></code> セクションディレクティブに
1472 指定する <var>test</var> は、
1473 次の二つの形式のうちの一つをとります:</p>
1476 <li><var>parameter-name</var></li>
1478 <li><code>!</code><var>parameter-name</var></li>
1481 <p>前者の場合には、<var>parameter-name</var> と名付けられたパラメータが
1482 定義されていれば開始と終了の間のディレクティブが処理されます。
1483 後者の場合は逆で、<em>parameter-name</em> が指定されて<strong>いない</strong>
1486 <p><var>parameter-name</var> 引数は、サーバを起動する際に
1487 <code class="program"><a href="../programs/httpd.html">httpd</a></code> のコマンドラインに
1488 <code>-D<var>parameter</var></code> という形で指定するか
1489 あるいは <code class="directive"><a href="#define">Define</a></code>
1490 ディレクティブで指定されると定義されます。 </p>
1492 <p><code class="directive"><IfDefine></code> セクションは
1493 入れ子にすることができ、複数のパラメータによるテストをするために使用できます。
1496 <div class="example"><p><code>
1497 httpd -DReverseProxy -DUseCache -DMemCache ...<br />
1500 <IfDefine ReverseProxy><br />
1501 <span class="indent">
1502 LoadModule proxy_module modules/mod_proxy.so<br />
1503 LoadModule proxy_http_module modules/mod_proxy_http.so<br />
1504 <IfDefine UseCache><br />
1505 <span class="indent">
1506 LoadModule cache_module modules/mod_cache.so<br />
1507 <IfDefine MemCache><br />
1508 <span class="indent">
1509 LoadModule mem_cache_module modules/mod_mem_cache.so<br />
1511 </IfDefine><br />
1512 <IfDefine !MemCache><br />
1513 <span class="indent">
1514 LoadModule cache_disk_module modules/mod_cache_disk.so<br />
1524 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1525 <div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">ディレクティブ</a></h2>
1526 <table class="directive">
1527 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>モジュールの存在するかしないかに応じて処理される
1528 ディレクティブを囲む</td></tr>
1529 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><IfModule [!]<var>module-file</var>|<var>module-identifier</var>> ...
1530 </IfModule></code></td></tr>
1531 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1532 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1533 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1534 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1535 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>モジュール識別子はバージョン 2.1 以降で使用可能。</td></tr>
1537 <p><code><IfModule <var>test</var>>...</IfModule></code>
1538 セクションは、モジュールが存在するときに処理されるディレクティブを
1540 <code class="directive"><IfModule></code> セクションに
1541 含まれるディレクティブは、<var>test</var>
1542 で指定するモジュールが組み込まれているときのみ処理されます。
1543 もし <var>test</var> が組み込まれていなければ、開始と終了の間のディレクティブ
1546 <p><code class="directive"><IfModule></code> セクションディレクティブに
1547 指定する <var>test</var> は、
1548 次の二つの形式のうちの一つをとります。</p>
1551 <li><var>module</var></li>
1553 <li>!<var>module</var></li>
1556 <p>前者の場合は、<var>module</var> と名付けられたモジュールが
1558 (コンパイル済みのものと、<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> を利用して
1560 開始と終了の間のディレクティブが処理されます。
1561 後者の場合は逆で、<var>module</var> が組み込まれて<strong>いない</strong>
1564 <p><var>module</var> 引数は、モジュール識別子か
1565 コンパイルをした時のモジュールのファイル名です。
1566 例えば、<code>rewrite_module</code> は識別子で
1567 <code>mod_rewrite.c</code> はファイル名です。
1568 モジュールが複数のソースファイルから構成されている場合は、文字列
1569 <code>STANDARD20_MODULE_STUFF</code> があるファイルの名前を
1572 <p><code class="directive"><IfModule></code> セクションは
1574 複数のモジュールのテストを行なうために使用できます。</p>
1576 <div class="note">特定のモジュールの存在に関わらず動作する
1577 設定ファイルの原本が必要なときにのみこのセクションを使用してください。
1579 <code class="directive"><IfModule></code> セクションの中に
1583 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1584 <div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">ディレクティブ</a></h2>
1585 <table class="directive">
1586 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバ設定ファイル中から他の設定ファイルを取り込む</td></tr>
1587 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Include <var>file-path</var>|<var>directory-path</var></code></td></tr>
1588 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
1589 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1590 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1591 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>ワイルドカードによるマッチは 2.0.41 以降で使用可能</td></tr>
1593 <p>このディレクティブにより、サーバの設定ファイルから
1594 他の設定ファイルをインクルードすることができます。</p>
1596 <p>複数のファイルをアルファベット順に一度に読み込むために、
1597 シェル形式 (<code>fnmatch</code>) のワイルドカード文字を使うことができます。
1598 さらに、<code class="directive">Include</code> にディレクトリを指定した場合は、
1599 ディレクトリとそのサブディレクトリ内の全てのファイルを
1600 アルファベット順に読み込んで、設定ファイルとして処理します。
1601 しかし、ディレクトリ全体を読み込むのはお勧めできません。
1602 ふとしたことから <code>httpd</code> が読み込みに失敗するような
1603 一時ファイルをディレクトリに残してしまうようなことがよくあるからです。</p>
1605 <p>指定するファイルパスは絶対パスか、
1606 <code class="directive"><a href="#serverroot">ServerRoot</a></code> ディレクトリからの
1611 <div class="example"><p><code>
1612 Include /usr/local/apache2/conf/ssl.conf<br />
1613 Include /usr/local/apache2/conf/vhosts/*.conf
1616 <p><code class="directive"><a href="#serverroot">ServerRoot</a></code> からの相対パスの場合は:</p>
1618 <div class="example"><p><code>
1619 Include conf/ssl.conf<br />
1620 Include conf/vhosts/*.conf
1625 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1628 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1629 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">ディレクティブ</a></h2>
1630 <table class="directive">
1631 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>HTTP の持続的な接続を有効にする</td></tr>
1632 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1633 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>KeepAlive On</code></td></tr>
1634 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1635 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1636 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1638 <p>HTTP/1.0 の Keep-Alive 拡張と HTTP/1.1 の持続的接続の機能は、
1639 複数のリクエストが同じ TCP の接続で送られる、長時間持続する
1640 HTTP セッションを提供します。たくさんの画像が
1641 含まれる HTML ドキュメントでは場合によっては遅延時間が 50% 短縮される結果も
1642 でています。Keep-Alive 接続を有効にするには
1643 <code>KeepAlive On</code> と設定します。</p>
1645 <p>HTTP/1.0 に対応したクライアントの際には、
1646 クライアントより特に要求があった場合のみ Keep-Alive 接続となります。
1647 さらに、HTTP/1.0 クライアントでは、コンテンツの容量が先に
1648 (訳注: 要求に対して応答を返す前に) わかる場合のみ Keep-Alive
1650 これは、CGI の出力や SSI のページ、
1651 サーバが生成したディレクトリのリストのような動的コンテンツを
1652 HTTP/1.0 クライアントに送る場合には Keep-Alive 接続を使えないことを意味します。
1653 HTTP/1.1 に対応したクライアントの際には、
1654 特に指定されない限りはデフォルトとして持続的な接続が行なわれます。
1655 クライアントが要求すれば、コンテンツの容量を判別できないものを
1656 持続的な接続を通して送るために、チャンクエンコーディングが用いられます。</p>
1658 <p>クライアントが Keep-Alive コネクションを使用している場合、
1659 そのコネクションを通してどれだけたくさんのリクエストが処理されても、
1660 それは「リクエスト」1 つとして、MaxRequestsPerChild ディレクティブでは
1665 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1668 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1669 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">ディレクティブ</a></h2>
1670 <table class="directive">
1671 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>持続的な接続で次のリクエストが来るまでサーバが待つ時間</td></tr>
1672 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>KeepAliveTimeout <var>seconds</var></code></td></tr>
1673 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
1674 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1675 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1676 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1678 <p>接続を閉じる前に、Apache が次のリクエストを何秒待つかを指定します。
1679 リクエストを受け付けた後は、<code class="directive"><a href="#timeout">Timeout</a></code> ディレクティブによって
1680 指定されたタイムアウト値が使われます。</p>
1682 <p><code class="directive">KeepAliveTimeout</code> を大きな値に設定すると、
1683 負荷の高いサーバにおいてはパフォーマンスの問題を引き起こす場合があります。
1684 タイムアウトが長ければ長いほど、より多くのサーバプロセスが
1685 活性でないクライアントからの接続の終了を待ち続けることになります。</p>
1687 <p>名前ベースのバーチャルホストコンテキストでは、
1688 <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>
1689 のセットの中で最初に定義されたバーチャルホストの値
1694 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1695 <div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">ディレクティブ</a></h2>
1696 <table class="directive">
1697 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>囲いの中にあるアクセス制御の適用を特定の HTTP メソッドのみに
1699 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><Limit <var>method</var> [<var>method</var>] ... > ...
1700 </Limit></code></td></tr>
1701 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1702 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1703 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1704 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1706 <p>アクセス制御は、通常<strong>全ての</strong>アクセスメソッドに対して
1708 <strong>そうしたことから、大部分の場合にはアクセス制御に関わるディレクティブを
1709 <code class="directive"><Limit></code> セクション内に
1710 書くべきではありません。 </strong></p>
1712 <p><code class="directive"><Limit></code> ディレクティブの
1714 指定された HTTP メソッドに限定するためです。
1715 それ以外のメソッドは、<code class="directive"><Limit></code> で囲われたアクセス制御の
1716 <strong>影響を受けません</strong>。
1717 以下の例は、<code>POST</code>, <code>PUT</code>, <code>DELETE</code> のメソッドに対してのみアクセスの制御を行ない、
1718 それ以外のメソッドについては制限しません:</p>
1720 <div class="example"><p><code>
1721 <Limit POST PUT DELETE><br />
1722 <span class="indent">
1723 Require valid-user<br />
1728 <p>メソッド名には以下の中から一つ以上を列挙することができます:
1730 <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1731 <code>CONNECT</code>, <code>OPTIONS</code>,
1732 <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1733 <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1734 <code>LOCK</code>, <code>UNLOCK</code>. <strong>メソッド名は
1735 大文字小文字を区別します。</strong> <code>GET</code> を指定した場合には
1736 <code>HEAD</code> リクエストにも制限がかかります。<code>TRACE</code>
1738 (<code class="directive"><a href="#traceenable"><TraceEnable></a></code> 参照)。</p>
1740 <div class="warning">アクセス制御が目的の場合は
1741 <code class="directive"><a href="#limit"><Limit></a></code>
1742 セクションの代わりに <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> セクションを使用した方が良いでしょう。
1743 <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>
1744 セクションでは不特定のメソッドに対しても防御できるからです。</div>
1748 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1749 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">ディレクティブ</a></h2>
1750 <table class="directive">
1751 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>指定されたもの以外の HTTP メソッドにアクセス制御を
1753 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><LimitExcept <var>method</var> [<var>method</var>] ... > ...
1754 </LimitExcept></code></td></tr>
1755 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1756 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1757 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1758 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1760 <p><code class="directive"><LimitExcept></code> と
1761 <code></LimitExcept></code> は、引数に
1762 <strong>含まれていない</strong>
1763 HTTP のアクセスメソッドに適用するためのアクセス制御
1765 つまり、<code class="directive"><a href="#limit"><Limit></a></code> セクションの反対の動作をし、
1766 標準のメソッドと標準外や未認識のメソッドの場合の両方を設定できます。
1767 <code class="directive"><a href="#limit"><Limit></a></code> のドキュメントも
1772 <div class="example"><p><code>
1773 <LimitExcept POST GET><br />
1774 <span class="indent">
1775 Require valid-user<br />
1777 </LimitExcept>
1782 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1783 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">ディレクティブ</a></h2>
1784 <table class="directive">
1785 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>内部リダイレクトと入れ子になったサブリクエストの最大数を決定する</td></tr>
1786 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
1787 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1788 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1789 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1790 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1791 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.47 以降で使用可能</td></tr>
1793 <p>内部リダイレクトは例えば <code class="directive">Action</code> ディレクティブを
1794 使っているときに起こります。<code class="directive">Action</code> ディレクティブは
1795 元々のリクエストを CGI スクリプトに内部リダイレクトを行ないます。
1796 サブリクエストはいくつかの URI に対して、リクエストされたときに
1797 何が起こるかを調べるための Apache の機構です。例えば、<code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>
1798 は <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> ディレクティブ
1799 がリストするファイルを調べるためにサブリクエストを使います。</p>
1801 <p><code class="directive">LimitInternalRecursion</code> は内部リダイレクトや
1802 サブリクエストが無限ループに陥ったときのサーバクラッシュを防ぎます。
1803 普通、そのようなループは設定に失敗したときに発生します。</p>
1805 <p>このディレクティブは、リクエスト毎に評価される、二つの違う限界値を
1806 設定します。最初の <var>number</var> は、起こり得る
1807 内部リクエストの最大値を設定します。二つめの <var>number</var> は
1808 サブリクエストが入れ子にできる深さを設定します。<var>number</var> を
1809 一つだけ指定したときは、両方の限界値にその値が設定されます。</p>
1811 <div class="example"><h3>例</h3><p><code>
1812 LimitInternalRecursion 5
1816 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1817 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">ディレクティブ</a></h2>
1818 <table class="directive">
1819 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントから送られる HTTP リクエストのボディの
1821 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
1822 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1823 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1824 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1825 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1826 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1828 <p>このディレクティブは、リクエストボディに許されるバイト数、<var>bytes</var>
1829 を 0 (無制限を意味します) から 2147483647 (2GB) までの数値で指定します。</p>
1831 <p><code class="directive">LimitRequestBody</code> ディレクティブは、
1833 (サーバ全体、ディレクトリ、ファイル、ロケーション) 内で
1834 許容する HTTP リクエストメッセージボディのサイズに制限をかけることができます。
1835 クライアントのリクエストがその制限値を越えていれば、
1836 サーバはリクエストを処理せずにエラーを返します。
1837 普通のリクエストメッセージボディのサイズは、リソースの種類や
1838 許可されているメソッドによって大きく変わります。
1839 CGI スクリプトは、よく情報を受信するために
1841 <code>PUT</code> メソッドの実装は、このディレクティブの値として
1842 少なくともあるリソースに対してサーバが受け付けようとする
1843 表現の大きさほどの値を必要とします。</p>
1846 管理者にクライアントからの異常なリクエストを制御できるようにし、
1847 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
1849 <p>ある場所へのファイルアップロードを許可する場合に、
1850 アップロードできるファイルのサイズを 100K に制限したければ、
1853 <div class="example"><p><code>
1854 LimitRequestBody 102400
1859 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1860 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">ディレクティブ</a></h2>
1861 <table class="directive">
1862 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントからの HTTP リクエストのヘッダフィールドの数を
1864 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
1865 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1866 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1867 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1868 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1870 <p><var>number</var> には、0 (無制限を意味します) から 32767
1872 デフォルト値は、定数 <code>DEFAULT_LIMIT_REQUEST_FIELDS</code>
1873 によりコンパイル時に定義されます (配布時には 100 と指定されています)。</p>
1875 <p><code class="directive">LimitRequestBody</code> ディレクティブは、
1876 サーバ管理者が HTTP リクエスト中において許可するリクエストヘッダフィールド数を
1878 サーバはこの値には通常のクライアントからのリクエストに含まれるであろう
1879 フィールドの数より大きな値が必要とします。
1880 クライアントにより使われた要求ヘッダーフィールドの数が
1881 20 を超えることはほとんどありませんが、
1882 これは種々のクライアントの実装によって変わり、
1883 詳細なコンテントネゴシエーションをするためのブラウザの設定までにも
1885 オプションの HTTP 拡張はリクエストヘッダフィールドを使って表される場合が
1889 管理者にクライアントからの異常なリクエストを制御できるようにし、
1890 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。
1891 リクエストのフィールドが多過ぎることを意味するエラー応答が
1892 普通のクライアントに返されるような時はこの値を増やしてください。</p>
1896 <div class="example"><p><code>
1897 LimitRequestFields 50
1902 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1903 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">ディレクティブ</a></h2>
1904 <table class="directive">
1905 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントからの HTTP リクエストのヘッダの
1907 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr>
1908 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
1909 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1910 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1911 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1913 <p>このディレクティブは、HTTP リクエストヘッダ一つで受付ける
1914 バイト数 <var>bytes</var> を指定します。</p>
1916 <p><code class="directive">LimitRequestFieldSize</code> ディレクティブは、
1917 HTTP リクエストヘッダで許容されるサイズを増減させることができます。
1918 サーバは、このディレクティブの値として、
1919 一般的なクライアントからリクエストが送られた際に、そのリクエストに
1920 付属しているどのヘッダフィールドについても、
1921 十分足りる大きさになっていなければなりません。
1922 一般的なリクエストヘッダのサイズといっても、その大きさは個々の
1923 クライアントの実装によって大きく異なり、
1924 詳細なコンテントネゴシエーションをサポートするかどうかの、
1926 SPNEGO 認証ヘッダでは 12392 バイトにまで及ぶことすらあります。</p>
1929 管理者にクライアントからの異常なリクエストを制御できるようにし、
1930 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
1934 <div class="example"><p><code>
1935 LimitRequestFieldSize 4094
1938 <div class="note">通常はデフォルトから変更する必要はありません。</div>
1942 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1943 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">ディレクティブ</a></h2>
1944 <table class="directive">
1945 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントからの HTTP リクエスト行のサイズを制限する</td></tr>
1946 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
1947 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1948 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1949 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1950 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1952 <p>このディレクティブは、HTTP リクエスト行内で許容されるバイト数
1953 <var>bytes</var> を指定します。</p>
1955 <p><code class="directive">LimitRequestLine</code> ディレクティブにより、
1956 クライアントからの HTTP リクエスト行の許容サイズを増減できます。
1957 リクエスト行は、HTTPメソッド、URI、プロトコルバージョンから成っており、
1958 <code class="directive">LimitRequestLine</code> はサーバへのリクエストに対して
1959 許容するリクエスト URI の長さを制限することになります。
1960 サーバは、<code>GET</code> リクエストのクエリ部分も含めて、リソースの名前が入るに足る
1964 管理者にクライアントからの異常なリクエストを制御できるようにし、
1965 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
1969 <div class="example"><p><code>
1970 LimitRequestLine 4094
1973 <div class="note">通常はデフォルトから変更する必要はありません。</div>
1976 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1977 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">ディレクティブ</a></h2>
1978 <table class="directive">
1979 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>XML 形式のリクエストのボディのサイズを制限する</td></tr>
1980 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
1981 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1982 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1983 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1984 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1985 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1987 <p>XML 形式のリクエストのボディの最大値を (バイト単位で) 制限します。
1988 値に <code>0</code> を指定するとチェックを無効にします。</p>
1992 <div class="example"><p><code>
1993 LimitXMLRequestBody 0
1998 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1999 <div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">ディレクティブ</a></h2>
2000 <table class="directive">
2001 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>囲んだディレクティブをマッチする URL のみに適用</td></tr>
2002 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><Location
2003 <var>URL-path</var>|<var>URL</var>> ... </Location></code></td></tr>
2004 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2005 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2006 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2008 <p><code class="directive"><Location></code> ディレクティブは、
2009 URL により中に書かれたディレクティブの適用範囲を制限します。
2010 <code class="directive"><a href="#directory"><Directory></a></code>
2012 <code></Location></code> ディレクティブで終了する
2014 <code class="directive"><Location></code> セクションは、
2015 <code class="directive"><a href="#directory"><Directory></a></code> セクションと
2016 <code>.htaccess</code> の読み込みの後、
2017 <code class="directive"><a href="#files"><Files></a></code> セクションを
2018 適用した後に、設定ファイルに現れた順に処理されます。</p>
2020 <p><code class="directive"><Location></code> セクションは
2021 完全にファイルシステムと関連せずに動作します。このことから導かれる
2022 結果にはいつくか注意する点があります。最も重要なものは、
2023 ファイルシステムの位置へのアクセス制御に <code class="directive"><Location></code> ディレクティブを使うべきではない
2024 ということです。複数の URL がファイルシステムの同じ位置にマップされる
2025 可能がありますので、そのようなアクセス制御は回避されてしまう可能性が
2028 <div class="note"><h3>いつ <code class="directive"><Location></code> を使うか</h3>
2030 <p><code class="directive"><Location></code> ディレクティブは
2031 ファイルシステム外のコンテンツにディレクティブを適用するときに
2032 使用してください。ファイルシステムに存在するコンテンツに対しては、
2033 <code class="directive"><a href="#directory"><Directory></a></code> と <code class="directive"><a href="#files"><Files></a></code> を使ってください。
2034 例外は、<code><Location /></code> で、これはサーバ全体に対して
2038 <p>全ての (プロキシ以外の) リクエストに対し、
2039 URL は <code>/path/</code> という、
2040 接頭辞 <code>http://servername</code> を含まない形でマッチします。
2041 プロキシリクエストの場合には、<code>scheme://servername/path</code>
2042 という接頭辞を含む形でマッチし、接頭辞を含めて指定する必要があります。</p>
2044 <p>URL にはワイルドカードを利用することができます。
2045 <code>?</code> は任意の一文字、<code>*</code> は任意の文字列にマッチします。
2046 どちらのワイルドカードも URL パス中の / にはマッチしません。</p>
2048 <p><code>~</code> という文字を追加することで、<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を
2052 <div class="example"><p><code>
2053 <Location ~ "/(extra|special)/data">
2056 <p>は URL に <code>/extra/data</code> か <code>/special/data</code> という文字列が
2058 <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> ディレクティブは
2059 <code class="directive"><Location></code> の正規表現
2062 <p><code class="directive"><Location></code> 機能は、<code class="directive"><a href="#sethandler">SetHandler</a></code> ディレクティブと
2064 例えば、<code>example.com</code> のブラウザからのみステータスの参照を有効にしたければ、
2067 <div class="example"><p><code>
2068 <Location /status><br />
2069 <span class="indent">
2070 SetHandler server-status<br />
2071 Order Deny,Allow<br />
2073 Allow from .example.com<br />
2078 <div class="note"><h3>/ (スラッシュ) に関する注</h3>
2079 <p>スラッシュ文字は、URL 内に現れる場所に応じて変化する
2081 ファイルシステムにおいて利用する場合には複数のスラッシュでも一つの
2082 スラッシュとして扱われることが多いですが、
2083 (<em>すなわち</em>、<code>/home///foo</code> は
2084 <code>/home/foo</code> と同じいったように)
2085 URL においては必ずしもそうなるわけではありません。
2086 <code class="directive"><a href="#locationmatch"><LocationMatch></a></code>
2088 <code class="directive"><Location></code> ディレクティブで、
2089 複数のスラッシュにマッチさせたいときには、、明示的に記述する
2092 <p>例えば、<code><LocationMatch ^/abc></code> は、
2093 <code>/abc</code> というリクエスト URL にマッチしますが、
2094 <code>//abc</code> というリクエスト URL にはマッチしません。
2095 (正規表現でない) <code class="directive"><Location></code>
2097 proxy リクエストに対して利用する際には同様の振る舞いをしますが、
2098 (正規表現でない) <code class="directive"><Location></code> を proxy
2099 でないリクエストに対して利用する際には、
2100 一つのスラッシュで複数のスラッシュにマッチします。
2101 例えば、<code><Location /abc/def></code> と指定し、
2102 <code>/abc//def</code> というリクエストがあれば、
2103 マッチすることになります。</p></div>
2108 <li>リクエストを受けた際にこれらの異なるセクションが
2109 組み合わされる方法については <a href="../sections.html">
2110 <Directory>, <Location>, <Files> セクションの動作法</a></li>
2113 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2114 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">ディレクティブ</a></h2>
2115 <table class="directive">
2116 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>囲んだディレクティブを正規表現にマッチする URL のみに
2118 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><LocationMatch
2119 <var>regex</var>> ... </LocationMatch></code></td></tr>
2120 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2121 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2122 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2124 <p><code class="directive"><LocationMatch></code> ディレクティブは、
2125 <code class="directive"><a href="#location"><Location></a></code> と同じ様に
2126 URL により中に書かれたディレクティブの適用範囲を制限します。
2127 但し、引数は普通の文字列ではなく、<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>となります。
2130 <div class="example"><p><code>
2131 <LocationMatch "/(extra|special)/data">
2134 <p>は URL に <code>/extra/data</code> か <code>/special/data</code>
2135 という文字列が含まれている場合にマッチします。</p>
2139 <li>リクエストを受けた際にこれらの異なるセクションが
2140 組み合わされる方法については <a href="../sections.html">
2141 <Directory>, <Location>, <Files> セクションの動作法</a></li>
2144 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2145 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">ディレクティブ</a></h2>
2146 <table class="directive">
2147 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ErrorLog の冗長性を制御する</td></tr>
2148 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LogLevel <var>level</var></code></td></tr>
2149 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LogLevel warn</code></td></tr>
2150 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2151 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2152 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2154 <p><code class="directive">LogLevel</code> は、エラーログ (<code class="directive"><a href="#errorlog">ErrorLog</a></code> ディレクティブを
2155 見てください) へ記録するメッセージの冗長性を調整します。
2156 以下の <var>level</var> を指定でき、順に重要度が下がっていきます。</p>
2158 <table class="bordered">
2160 <th><strong>レベル</strong> </th>
2162 <th><strong>説明</strong> </th>
2164 <th><strong>例</strong> </th>
2168 <td><code>emerg</code> </td>
2170 <td>緊急 - システムが利用できない</td>
2172 <td>Child cannot open lock file. Exiting
2173 (子プロセスがロックファイルを開けないため終了した)</td>
2177 <td><code>alert</code> </td>
2181 <td>getpwuid: couldn't determine user name from uid
2182 (getpwuid: UID からユーザ名を特定できなかった)</td>
2186 <td><code>crit</code> </td>
2190 <td>socket: Failed to get a socket, exiting child
2191 (socket: ソケットが得られないため、子プロセスを終了させた)</td>
2195 <td><code>error</code> </td>
2199 <td>Premature end of script headers
2200 (スクリプトのヘッダが足りないままで終わった)</td>
2204 <td><code>warn</code> </td>
2208 <td>child process 1234 did not exit, sending another SIGHUP
2209 (子プロセス 1234 が終了しなかった。もう一度 SIGHUP を送る)</td>
2213 <td><code>notice</code> </td>
2217 <td>httpd: caught SIGBUS, attempting to dump core in ...
2218 (httpd: SIGBUS シグナルを受け、... へコアダンプをした)</td>
2222 <td><code>info</code> </td>
2226 <td>"Server seems busy, (you may need to increase
2227 StartServers, or Min/MaxSpareServers)..." (「サーバは負荷が高い、
2228 (StartServers や Min/MaxSpareServers の値を増やす必要があるかも)」)</td>
2232 <td><code>debug</code> </td>
2236 <td>"Opening config file ..." (設定ファイルを開いている...)</td>
2240 <p>特定のレベルが指定された場合、それより高いレベルの全てのメッセージが
2242 <em>例えば</em>、<code>LogLevel info</code> に指定すると、
2243 <code>notice</code> と <code>warn</code> も報告されます。</p>
2245 <p>なお <code>crit</code> 以上のレベルを指定することが推奨されます。</p>
2249 <div class="example"><p><code>
2253 <div class="note"><h3>注</h3>
2254 <p>ファイルにログを出力する場合、<code>notice</code>
2255 レベルのメッセージは抑制されず、すべてログに出力されます。
2256 しかし <code>syslog</code> を使用している場合は、
2261 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2262 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">ディレクティブ</a></h2>
2263 <table class="directive">
2264 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>持続的な接続上で許可されるリクエストの数</td></tr>
2265 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr>
2266 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2267 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2268 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2269 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2271 <p><code class="directive">MaxKeepAliveRequests</code> ディレクティブは、
2272 <code class="directive"><a href="#keepalive">KeepAlive</a></code> が有効な場合に、
2273 一回の接続で受け付け可能なリクエストの数を制限します。
2274 <code>0</code> に設定していれば、受け付けるリクエストは無制限になります。
2275 この設定は、サーバ性能を向上させるために、大きな数値を指定すること勧めます。
2280 <div class="example"><p><code>
2281 MaxKeepAliveRequests 500
2285 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2286 <div class="directive-section"><h2><a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a name="maxranges" id="maxranges">ディレクティブ</a></h2>
2287 <table class="directive">
2288 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Number of ranges allowed before returning the complete
2290 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>MaxRanges default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
2291 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>MaxRanges 200</code></td></tr>
2292 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
2293 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2294 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2295 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
2296 </table><p>The documentation for this directive has
2297 not been translated yet. Please have a look at the English
2299 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2300 <div class="directive-section"><h2><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">ディレクティブ</a></h2>
2301 <table class="directive">
2302 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Configures mutex mechanism and lock file directory for all
2303 or specified mutexes</td></tr>
2304 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Mutex <var>mechanism</var> [default|<var>mutex-name</var>] ... [OmitPID]</code></td></tr>
2305 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>Mutex default</code></td></tr>
2306 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2307 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2308 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2309 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.3.4 and later</td></tr>
2310 </table><p>The documentation for this directive has
2311 not been translated yet. Please have a look at the English
2313 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2314 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">ディレクティブ</a></h2>
2315 <table class="directive">
2316 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>名前ベースのバーチャルホストのための IP アドレスを指定</td></tr>
2317 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr>
2318 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2319 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2320 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2322 <p><code class="directive">NameVirtualHost</code> ディレクティブは、
2323 <a href="../vhosts/">名前ベースのバーチャルホスト</a>の設定を行ないたい場合に
2326 <p><var>addr</var> にはホスト名を指定できますが、
2327 常に IP アドレスを指定するのが推奨されます。
2330 <div class="example"><p><code>
2331 NameVirtualHost 111.22.33.44
2334 <p><code class="directive">NameVirtualHost</code> ディレクティブは、
2336 利用してリクエストを受け付ける IP アドレスを指定します。
2337 これは、普通は名前ベースのバーチャルホストアドレスです。
2338 ただし、ファイアーウォールや他のプロキシがリクエストを受け付け、
2339 違う IP アドレスのサーバにフォワードするという場合は、
2340 リクエストを提供したいマシン上の物理インターフェースの
2341 IP アドレスを指定する必要があります。
2342 複数のアドレスで複数の名前ベースのバーチャルホストを指定する場合は
2343 各アドレスに対してディレクティブを書いてください。</p>
2345 <div class="note"><h3>中</h3>
2346 <p>「主サーバ」や、どの <code>_default_</code> サーバも、
2347 <code class="directive">NameVirtualHost</code> で指定した IP アドレスへのリクエスト
2348 を処理することは<strong>ありません</strong> (なぜか
2349 <code class="directive">NameVirtualHost</code> を
2350 指定したけどそのアドレスに <code class="directive">VirtualHost</code> を定義しなかった場合を除く)。</p>
2353 <p>名前ベースのバーチャルホストにポート番号を指定することも可能です。
2356 <div class="example"><p><code>
2357 NameVirtualHost 111.22.33.44:8080
2360 <p>IPV6 のアドレスは次の例のように角括弧で囲む必要があります:</p>
2362 <div class="example"><p><code>
2363 NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2366 <p>すべてのインタフェースへのリクエストを受け取るようにするためには、
2367 引数として <code>*</code> を使います。</p>
2369 <div class="example"><p><code>
2373 <div class="note"><h3><code class="directive"><VirtualHost></code> ディレクティブの引数</h3>
2374 <p><code class="directive"><VirtualHost></code> ディレクティブの引数は <code class="directive">NameVirtualHost</code> ディレクティブの引数に正確に
2375 合っている必要があることに注意してください。</p>
2377 <div class="example"><p><code>
2378 NameVirtualHost 1.2.3.4<br />
2379 <VirtualHost 1.2.3.4><br />
2381 </VirtualHost><br />
2388 <li><a href="../vhosts/">バーチャルホスト説明書
2392 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2393 <div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">ディレクティブ</a></h2>
2394 <table class="directive">
2395 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディレクトリに対して使用可能な機能を設定する</td></tr>
2396 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Options
2397 [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
2398 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>Options All</code></td></tr>
2399 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2400 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Options</td></tr>
2401 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2402 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2404 <p><code class="directive">Options</code> ディレクティブは、特定のディレクトリに対して
2405 どの機能が使用可能かを制御します。</p>
2407 <p><var>option</var> を <code>None</code>に指定すると、
2409 また、以下の示す 1 個以上のものを指定できます。</p>
2412 <dt><code>All</code></dt>
2414 <dd><code>MultiViews</code> を除いた全ての機能が有効となります。
2417 <dt><code>ExecCGI</code></dt>
2420 <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> による CGI スクリプトの実行を許可します。</dd>
2422 <dt><code>FollowSymLinks</code></dt>
2425 サーバが、このディレクトリ内でシンボリックリンクをたどれるようにします。
2426 <div class="note"><p>サーバがシンボリックリンクをたどる場合でも、
2427 <code class="directive"><a href="#directory"><Directory></a></code> セクションに
2429 パス名は<em>変更されません</em>。</p>
2430 <p><code class="directive"><a href="#location"><Location></a></code> 内に
2431 このオプションを指定しても<strong>無視される</strong>ことに
2433 <p>このオプションを省略したからといってセキュリティの強化にはなりません。
2434 なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、
2435 そのため回避可能になるからです。</p>
2438 <dt><code>Includes</code></dt>
2441 <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> が提供する SSI を有効にします。</dd>
2443 <dt><code>IncludesNOEXEC</code></dt>
2446 SSI は有効になりますが、<code>#exec</code> コマンド と <code>#exec CGI</code> は無効になります。
2447 ただし、<code>#include virtual</code> により、<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> されたディレクトリで
2448 CGI を実行することは可能です。</dd>
2450 <dt><code>Indexes</code></dt>
2453 もし、URL がディレクトリにマップするリクエストであって、
2454 且つ <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> で指定したファイル (例えば、<code>index.html</code>) が
2455 ディレクトリ内に無ければ、<code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> が
2456 ディレクトリ内の一覧を整形して返します。</dd>
2458 <dt><code>MultiViews</code></dt>
2461 <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> による
2462 <a href="../content-negotiation.html">コンテントネゴシエーション</a>
2463 された "MultiViews" を許可します。</dd>
2465 <dt><code>SymLinksIfOwnerMatch</code></dt>
2468 シンボリック先のファイルまたはディレクトリが、
2469 シンボリックリンクの所有ユーザ ID と同じ場合にのみシンボリックリンクを
2472 <div class="note"><h3>注</h3> <p><code class="directive"><a href="#location"><Location></a></code> 内にこのオプションを
2474 <p>このオプションはセキュリティの強化にはなりません。
2475 なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、
2476 そのため回避可能になるからです。</p>
2481 <p>通常、ディレクトリに対して複数の <code class="directive">Options</code> が
2483 最も近いもの一つのみが適用され、他のものは無視されます。
2484 複数の指定がマージされるわけではありません。(<a href="../sections.html#mergin">セクションのマージ方法</a>を参照してください。)
2485 しかし、すべての <code class="directive">Options</code> ディレクティブが <code>+</code> や <code>-</code> 付きで
2486 指定された場合はオプションの値はマージされます。
2487 <code>+</code> を頭につければ現在の設定に加えられ、
2488 <code>-</code> を付ければ現在の設定から削除されます。</p>
2490 <div class="warning"><h3>警告</h3>
2491 <p><code class="directive">Options</code> で <code>+</code> や
2492 <code>-</code> のついたものを、つけないものと組み合わせて
2493 指定する構文は正しい構文ではありませんので、期待する結果に
2497 <p>例えば、<code>+</code> や <code>-</code> を利用しない場合は:</p>
2499 <div class="example"><p><code>
2500 <Directory /web/docs><br />
2501 <span class="indent">
2502 Options Indexes FollowSymLinks<br />
2504 </Directory><br />
2506 <Directory /web/docs/spec><br />
2507 <span class="indent">
2508 Options Includes<br />
2513 <p><code>/web/docs/spec</code> というディレクトリには、
2514 <code>Includes</code> だけが適用されます。
2515 しかし、2 番目の <code class="directive">Options</code> で <code>+</code> や <code>-</code> を利用してみると:</p>
2517 <div class="example"><p><code>
2518 <Directory /web/docs><br />
2519 <span class="indent">
2520 Options Indexes FollowSymLinks<br />
2522 </Directory><br />
2524 <Directory /web/docs/spec><br />
2525 <span class="indent">
2526 Options +Includes -Indexes<br />
2531 <p><code>/web/docs/spec</code> というディレクトリには、 <code>FollowSymLinks</code> と
2532 <code>Includes</code> が適用されます。</p>
2534 <div class="note"><h3>注</h3>
2535 <p><code>-IncludesNOEXEC</code> もしくは
2536 <code>-Includes</code> を指定すると、
2537 前の設定がどのようになっていようとも SSI は無効となります。</p>
2540 <p>どのような設定もされていなければ、デフォルトでは <code>All</code> に
2544 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2545 <div class="directive-section"><h2><a name="Protocol" id="Protocol">Protocol</a> <a name="protocol" id="protocol">ディレクティブ</a></h2>
2546 <table class="directive">
2547 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Protocol for a listening socket</td></tr>
2548 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Protocol <var>protocol</var></code></td></tr>
2549 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2550 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2551 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2552 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache 2.1.5 and later.
2553 On Windows from Apache 2.3.3 and later.</td></tr>
2554 </table><p>The documentation for this directive has
2555 not been translated yet. Please have a look at the English
2556 version.</p><h3>参照</h3>
2558 <li><code class="directive">AcceptFilter</code></li>
2559 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
2562 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2563 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">ディレクティブ</a></h2>
2564 <table class="directive">
2565 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Apache の子プロセスから起動されたプロセスの CPU 消費量を
2567 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
2568 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>未設定。オペレーティングシステムのデフォルトを使用</code></td></tr>
2569 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2570 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
2571 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2572 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2574 <p>一つか二つのパラメータをとります。
2575 最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2576 2 番目のパラメータは最大のリソースリミットを設定します。
2577 パラメータには数字か、オペレーティングシステムの最大となる
2578 <code>max</code> のどちらかを指定することができます。
2579 最大のリソースリミットを上げるためには、サーバを
2580 <code>root</code> で実行するか起動されなければいけません。</p>
2582 <p>ちなみに、この設定は Apache の子プロセス自体ではなく、
2583 リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
2585 これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
2586 親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
2588 <p>CPU リソースのリミットはプロセスあたりの秒数で表わされます。</p>
2593 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2594 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2597 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2598 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">ディレクティブ</a></h2>
2599 <table class="directive">
2600 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Apache の子プロセスから起動されたプロセスのメモリ消費量を
2602 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</var>|max]</code></td></tr>
2603 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>未設定。オペレーティングシステムのデフォルトを使用</code></td></tr>
2604 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2605 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
2606 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2607 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2609 <p>一つか二つのパラメータをとります。
2610 最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2611 2 番目のパラメータは最大のリソースリミットを設定します。
2612 パラメータには数字か、オペレーティングシステムの最大となる
2613 <code>max</code> のどちらかを指定することができます。
2614 最大のリソースリミットを上げるためには、サーバを
2615 <code>root</code> で実行するか起動されなければいけません。</p>
2617 <p>この設定は Apache の子プロセス自体ではなく、
2618 リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
2620 これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
2621 親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
2623 <p>メモリリソースのリミットはプロセスあたりのバイト数で表わされます。</p>
2627 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2628 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2631 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2632 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">ディレクティブ</a></h2>
2633 <table class="directive">
2634 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Apache の子プロセスから起動されたプロセスが起動するプロセスの
2636 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr>
2637 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>未設定。オペレーティングシステムのデフォルトを使用</code></td></tr>
2638 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2639 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
2640 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2641 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2643 <p>一つか二つのパラメータをとります。
2644 最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2645 2 番目のパラメータは最大のリソースリミットを設定します。
2646 パラメータには数字か、オペレーティングシステムの最大となる
2647 <code>max</code> のどちらかを指定することができます。
2648 最大のリソースリミットを上げるためには、サーバを
2649 <code>root</code> で実行するか起動されなければいけません。</p>
2651 <p>この設定は Apache の子プロセス自体ではなく、
2652 リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
2654 これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
2655 親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
2657 <p>プロセスの制限は、ユーザあたりのプロセス数で制御されます。</p>
2659 <div class="note"><h3>注</h3>
2660 <p> CGI プロセスがウェブサーバのユーザ ID 以外で実行されるので
2661 <strong>無ければ</strong>、
2662 このディレクティブは、サーバ自身が生成できるプロセスの数を制限することになります。
2663 そのような状況になっているかどうかは、<code>error_log</code> 中の
2664 <strong><code>cannot fork</code></strong> というメッセージにより
2670 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2671 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2674 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2675 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">ディレクティブ</a></h2>
2676 <table class="directive">
2677 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>CGI スクリプトのインタープリタの位置を調べるための手法</td></tr>
2678 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2679 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2680 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2681 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
2682 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2683 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2684 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Win32 のみ。
2685 オプション <code>Registry-Strict</code> は Apache 2.0 以降で使用可能</td></tr>
2687 <p>このディレクティブは、Apache で CGI スクリプトを
2688 実行する場合に利用するインタープリタを、
2689 どのように探し出すかについて制御するために使用します。
2690 デフォルトの設定は <code>Script</code> です。これはスクリプトの
2691 shebang 行 (最初の行で <code>#!</code> から始まるもの)
2692 に指されているインタープリタを使用します。Win32 ではその行は
2695 <div class="example"><p><code>
2696 #!C:/Perl/bin/perl.exe
2699 <p>もしくは、<code>perl</code> が <code>PATH</code> にある場合は単に:</p>
2701 <div class="example"><p><code>
2705 <p><code>ScriptInterpreterSource Registry</code> を指定すると、
2706 スクリプトファイルの拡張子 (例えば、<code>.pl</code>) を
2707 キーとして、Windows のレジストリツリー <code>HKEY_CLASSES_ROOT</code>
2708 を検索するようになります。レジストリのサブキー
2709 <code>Shell\ExecCGI\Command</code> か、それが存在しない場合は
2710 <code>Shell\Open\Command</code> がスクリプトファイルを開くために
2711 使われます。レジストリキーが見つからないときは、Apache は <code>Script</code>
2712 オプションが指定されたときの動作に戻ります。</p>
2714 <div class="warning"><h3>セキュリティ</h3>
2715 <p><code>ScriptInterpreterSource Registry</code> を <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> されたディレクトリで使うときは
2716 注意してください。Apache はそのディレクトリ中の<em>すべての</em>ファイルを
2717 実行しようとします。<code>Registry</code> という設定は通常は実行されない
2718 ファイルに対して望ましくないプログラムの実行が発生する可能性があります。
2719 例えば、ほとんどの Windows システムで、
2720 <code>.htm</code> ファイルのデフォルトの「開く」コマンドは
2721 Microsoft Internet Explorer を実行しますので、スクリプトに指定された
2722 ディレクトリにある <code>.htm</code> ファイルへのリクエストはサーバの
2723 バックグラウンドでブラウザを実行することになります。これは、一分内くらいで
2724 システムをクラッシュさるための良い方法です。</p>
2727 <p>Apache 2.0 から導入されたオプション <code>Registry-Strict</code> は
2728 <code>Registry</code> と同じことを行ないますが、サブキー
2729 <code>Shell\ExecCGI\Command</code> のみを使います。
2730 <code>ExecCGI</code> キーは普通に使われるキーではありません。Windows
2731 レジストリに手動で設定する必要がありますので、システムでの偶発的なプログラムの
2735 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2736 <div class="directive-section"><h2><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">ディレクティブ</a></h2>
2737 <table class="directive">
2738 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Determine if mod_status displays the first 63 characters
2739 of a request or the last 63, assuming the request itself is greater than
2741 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
2742 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SeeRequestTail Off</code></td></tr>
2743 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2744 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2745 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2746 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache httpd 2.2.7 and later.</td></tr>
2747 </table><p>The documentation for this directive has
2748 not been translated yet. Please have a look at the English
2750 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2751 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">ディレクティブ</a></h2>
2752 <table class="directive">
2753 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバがクライアントに送るエラーメッセージに含める電子メールの
2755 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerAdmin <var>email-address</var>|<var>URL</var></code></td></tr>
2756 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2757 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2758 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2760 <p><code class="directive">ServerAdmin</code> は、クライアントに返すさまざまな
2762 問合せアドレスを設定します。与えられた引数を <code>httpd</code> が
2763 URL と認識しない場合は、<var>email-address</var> だと解釈して、
2764 ハイパーリンクのターゲットに <code>mailto:</code> を付けます。
2765 実際には、ここには電子メールアドレスを使うことが推奨されています。
2766 多くの CGI スクリプトはそうなっていることを仮定しています。
2767 URL を使う場合は、あなたの管理下にある別サーバを指すようにしてください。
2768 そうでないと、エラーが起こったときに連絡をすることができなくなって
2772 <p>その際、これのために専用のアドレスを設定するのが良いでしょう。
2775 <div class="example"><p><code>
2776 ServerAdmin www-admin@foo.example.com
2779 <p>といったようにします。ユーザはいつもサーバに関する話であるということを
2780 明記してくるわけではありませんので。</p>
2784 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2785 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">ディレクティブ</a></h2>
2786 <table class="directive">
2787 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リクエストを名前ベースのバーチャルホストにマッチさせているときに
2788 使用されるホストの別名</td></tr>
2789 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
2790 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>バーチャルホスト</td></tr>
2791 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2792 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2794 <p><code class="directive">ServerAlias</code> ディレクティブは、<a href="../vhosts/name-based.html">ネームベースのバーチャルホスト</a>において
2796 適切であれば、<code class="directive">ServerAlias</code> ディレクティブでは
2797 ワイルドカードを使うこともできます。</p>
2799 <div class="example"><p><code>
2800 <VirtualHost *><br />
2801 ServerName server.domain.com<br />
2802 ServerAlias server server2.domain.com server2<br />
2804 </VirtualHost>
2809 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
2812 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2813 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">ディレクティブ</a></h2>
2814 <table class="directive">
2815 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが自分自身を示すときに使うホスト名とポート</td></tr>
2816 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerName [<var>scheme</var>://]<var>fully-qualified-domain-name</var>[:<var>port</var>]</code></td></tr>
2817 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2818 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2819 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2820 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>このディレクティブはバージョン 2.0 ではバージョン 1.3 の
2821 <code class="directive">Port</code> ディレクティブの機能も含みます。</td></tr>
2823 <p><code class="directive">ServerName</code> ディレクティブは、
2824 サーバが自分自身を示すスキーム名、ホスト名とポート番号を設定します。
2825 これは、リダイレクトする URL を生成する際に利用されます。
2826 例えば、ウェブサーバを動かしているマシンは <code>simple.example.com</code>
2827 で、DNS のエイリアス <code>www.example.com</code> もあるときに、
2828 ウェブサーバが後者として認識されて欲しいときは、以下のようにディレクティブを
2831 <div class="example"><p><code>
2832 ServerName www.example.com:80
2835 <p><code class="directive">ServerName</code> が指定されていないときは、
2836 サーバは IP アドレスから逆引きを行なうことでホスト名を知ろうとします。
2837 <code class="directive">ServerName</code> にポートが指定されていないときは、
2839 ポートを使います。最高の信頼性と確実性をもたらすためには、
2840 <code class="directive">ServerName</code> を使ってホスト名とポートを明示的に
2843 <p><a href="../vhosts/name-based.html">名前ベースのバーチャルホスト</a>
2844 を利用している場合、<code class="directive"><a href="#virtualhost"><VirtualHost></a></code> セクション内の
2845 <code class="directive">ServerName</code> はこのバーチャルホストにマッチするために
2846 何がリクエストの Host: ヘッダに現れる必要があるのかを指定します。</p>
2848 <p>SSL を処理するデバイス、例えばリーバスプロクシやロードバランサや
2849 SSL 処理軽減アプライアンスの裏側でサーバが稼動する場合もあるでしょう。
2850 そういった場合では、クライアントが接続するときに使う
2851 <code>https://</code> スキームとポート番号を <code class="directive">ServerName</code>
2852 ディレクティブで指定して、自己参照 URL が正しく生成できるようにします。</p>
2854 <p>自己参照 URL (例えば <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> モジュールによるものなど)
2855 が指定されたポートを使うか、クライアントのリクエストのポート番号を使うかを
2856 決定する設定は <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>
2857 ディレクティブと <code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
2858 ディレクティブを参照してください。</p>
2863 <li><a href="../dns-caveats.html">DNS と Apache に関する話</a></li>
2864 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
2865 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2866 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
2867 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2868 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2871 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2872 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">ディレクティブ</a></h2>
2873 <table class="directive">
2874 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>非互換のブラウザが名前ベースのバーチャルホストにアクセスしたときの
2875 ための互換用 URL パス名</td></tr>
2876 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
2877 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>バーチャルホスト</td></tr>
2878 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2879 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2881 <p><code class="directive">ServerPath</code> ディレクティブは、<a href="../vhosts/">ネームベースのバーチャルホスト</a>において利用する
2882 互換用 URL パス名を設定します。</p>
2886 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
2889 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2890 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">ディレクティブ</a></h2>
2891 <table class="directive">
2892 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>インストールされたサーバのベースディレクトリ</td></tr>
2893 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
2894 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2895 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2896 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2897 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2899 <p><code class="directive">ServerRoot</code> ディレクティブは、
2900 サーバが存在するディレクトリを設定します。
2901 通常、<code>conf/</code> や <code>logs/</code> といったサブディレクトリが
2903 また、他の設定ディレクティブ (例えば <code class="directive"><a href="#include">Include</a></code> や <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> など) における相対パスは、
2904 このディレクトリからの相対位置となります。</p>
2906 <div class="example"><h3>例</h3><p><code>
2907 ServerRoot /home/httpd
2914 <li><a href="../invoking.html"><code>httpd</code> の <code>-d</code>
2916 <li><code class="directive">ServerRoot</code> の権限を適切に設定する方法は<a href="../misc/security_tips.html#serverroot">セキュリティのこつ</a></li>
2919 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2920 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">ディレクティブ</a></h2>
2921 <table class="directive">
2922 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが生成するドキュメントのフッタを設定</td></tr>
2923 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2924 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerSignature Off</code></td></tr>
2925 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2926 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
2927 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2928 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2930 <p><code class="directive">ServerSignature</code> ディレクティブは、
2932 (エラーメッセージ、<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> における FTP のディレクトリリスト、
2933 <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> の出力、等々)
2934 の最下行に付与するフッタの設定を行ないます。
2935 そのようなフッタ行を有効にしたい理由には、
2936 プロキシが複数連なっている場合に、ユーザはどのサーバが返した
2937 エラーメッセージかを知る手段がほとんど無いというものがあります。</p>
2940 <p>デフォルトである <code>Off</code> に設定をすると、フッタ行が抑制されます
2941 (そして、Apache-1.2 以前と互換の動作をします)。
2942 <code>On</code> に設定した場合は、単にドキュメントの中に、サーバのバージョン、
2943 稼動中のバーチャルホストの <a href="#servername">ServerName</a> の書かれた行を追加し、
2944 <code>EMail</code> にした場合はさらに参照されたドキュメントに対する <a href="#serveradmin">ServerAdmin</a> を指す "mailto:" が追加されます。</p>
2946 <p>バージョン 2.0.44 以降ではこのディレクティブは <code class="directive"><a href="#serversignature">ServerSignature</a></code>
2947 ディレクティブにより表示される情報も制御します。</p>
2951 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
2954 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2955 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">ディレクティブ</a></h2>
2956 <table class="directive">
2957 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>Server</code> HTTP 応答ヘッダを設定する</td></tr>
2958 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
2959 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerTokens Full</code></td></tr>
2960 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2961 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2962 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2964 <p>このディレクティブは、クライアントに送り返す <code>Server</code>
2965 応答ヘッダ内に、サーバの一般的な OS 種別や、
2966 コンパイルされて組み込まれているモジュールの情報を
2970 <dt><code>ServerTokens Prod[uctOnly]</code></dt>
2972 <dd>サーバは (例えば): <code>Server:
2973 Apache</code> といったように送ります。</dd>
2975 <dt><code>ServerTokens Major</code></dt>
2977 <dd>Server sends (<em>e.g.</em>): <code>Server:
2978 Apache/2</code></dd>
2980 <dt><code>ServerTokens Minor</code></dt>
2982 <dd>Server sends (<em>e.g.</em>): <code>Server:
2983 Apache/2.0</code></dd>
2985 <dt><code>ServerTokens Min[imal]</code></dt>
2987 <dd>サーバは (例えば): <code>Server:
2988 Apache/2.0.41</code> といったように送ります。</dd>
2990 <dt><code>ServerTokens OS</code></dt>
2992 <dd>サーバは (例えば): <code>Server: Apache/2.0.41
2993 (Unix)</code> といったように送ります。</dd>
2995 <dt><code>ServerTokens Full</code> (もしくは未指定)</dt>
2997 <dd>サーバは (例えば): <code>Server: Apache/2.0.41
2998 (Unix) PHP/4.2.2 MyMod/1.2</code> といったように送ります。</dd>
3001 <p>この設定はサーバ全体に適用され、バーチャルホスト上で有効にしたり
3004 <p>バージョン 2.0.44 以降ではこのディレクティブは <code class="directive"><a href="#serversignature">ServerSignature</a></code>
3005 ディレクティブにより表示される情報も制御します。</p>
3009 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3012 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3013 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">ディレクティブ</a></h2>
3014 <table class="directive">
3015 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>マッチするファイルがハンドラで処理されるようにする</td></tr>
3016 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
3017 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
3018 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
3019 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3020 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3021 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 で core に移動</td></tr>
3023 <p><code>.htaccess</code> や <code class="directive"><a href="#directory"><Directory></a></code>
3024 セクション、<code class="directive"><a href="#location"><Location></a></code>
3026 このディレクティブはそこにあるすべてのファイルが
3027 <var>handler-name</var> で指定された<a href="../handler.html">ハンドラ</a>で扱われることを強制します。例えば、拡張子に関わらず、
3028 ディレクトリ全体がイメージマップファイルとして解析して欲しい場合には、
3029 以下をそのディレクトリの <code>.htaccess</code>
3032 <div class="example"><p><code>
3033 SetHandler imap-file
3036 <p>別の例: URL <code>http://servername/status</code>
3037 が指定されたときにサーバが状態報告をするようにしたいときは、以下を
3038 <code>httpd.conf</code> に記述します:</p>
3040 <div class="example"><p><code>
3041 <Location /status><br />
3042 <span class="indent">
3043 SetHandler server-status<br />
3048 <p><code>None</code> という値を設定することで、
3049 前の方の <code class="directive">SetHandler</code> で定義された設定を無効にすることが
3051 <p><strong>注意:</strong>SetHandler はデフォルトのハンドラをオーバーライド
3052 しますので、通常の挙動、たとえば、スラッシュ (/) で終わる URL が
3053 リクエストされたときにディレクトリやインデックスファイルを返すよう取り扱う挙動は、
3060 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3063 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3064 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">ディレクティブ</a></h2>
3065 <table class="directive">
3066 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントのリクエストや POST の入力を処理するフィルタを設定する</td></tr>
3067 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
3068 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
3069 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
3070 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3071 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3073 <p><code class="directive">SetInputFilter</code> ディレクティブはクライアントの
3074 リクエストや POST の入力をサーバが受け取ったときに処理するフィルタを
3075 設定します。これは <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>
3076 ディレクティブを含め、他の場所で定義されているフィルタの設定に
3079 <p>複数のフィルタを指定するときは、データを処理する順番に
3080 セミコロンで区切る必要があります。</p>
3085 <li><a href="../filter.html">フィルタ</a>説明書</li>
3088 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3089 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">ディレクティブ</a></h2>
3090 <table class="directive">
3091 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバの応答を処理するフィルタを設定する</td></tr>
3092 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
3093 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
3094 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
3095 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3096 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3098 <p><code class="directive">SetOutputFilter</code> ディレクティブは
3099 サーバの応答をクライアントに送り返される前に処理するフィルタを設定します。
3100 これは <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>
3101 ディレクティブを含め、他の場所で定義されているフィルタの設定に
3104 <p>例えば、以下の設定は <code>/www/data/</code> ディレクトリのすべての
3105 ファイルを SSI で処理します。</p>
3107 <div class="example"><p><code>
3108 <Directory /www/data/><br />
3109 <span class="indent">
3110 SetOutputFilter INCLUDES<br />
3115 <p>複数のフィルタを指定するときは、データを処理する順番に
3116 セミコロンで区切る必要があります。</p>
3120 <li><a href="../filter.html">フィルタ</a>説明書</li>
3123 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3124 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">ディレクティブ</a></h2>
3125 <table class="directive">
3126 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>各イベントについて、リクエストを失敗させるまでにサーバが
3128 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
3129 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>TimeOut 300</code></td></tr>
3130 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
3131 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3132 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3134 <p><code class="directive">TimeOut</code> ディレクティブは、
3135 様々な条件下での I/O 待ち時間を定義します:</p>
3138 <li>クライアントからのデータを読み込む時。
3139 受信バッファが空になっていて、TCP パケットが届くまで
3142 <li>クライアントに対してデータを送り出す時。
3143 送信バッファがいっぱいで、パケットの受信完了 <span class="transnote">(<em>訳注:</em> ACK)</span>
3146 <li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> 内で、CGI スクリプトが出力を
3149 <li><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> 内で、フィルタ処理で出力を
3152 <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> 内で、
3153 <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code>
3154 が設定されていない場合のデフォルトの待ち時間</li>
3159 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3160 <div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">ディレクティブ</a></h2>
3161 <table class="directive">
3162 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>TRACE</code> メソッドのリクエストに対する応答方法を決める
3164 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
3165 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>TraceEnable on</code></td></tr>
3166 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
3167 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3168 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3169 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 1.3.34, 2.0.55 以降</td></tr>
3171 <p>Apache のコア機能<span class="transnote">(<em>訳注:</em> <code class="module"><a href="../mod/core.html">core</a></code>)</span>と
3172 <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> 両方の <code>TRACE</code>
3173 の挙動をオーバーライドします。デフォルトの <code>TraceEnable on</code>
3174 は、リクエストボディを受け入れないような、RFC2616 に準拠した
3175 <code>TRACE</code> リクエストを受け付けます。
3176 <code>TraceEnale off</code> と設定すると、コアサーバと
3177 <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> は <code>405</code> (メソッド不許可)
3178 エラーをクライアントに返します。</p>
3180 <p>最後に、テストや調査目的などの限定用途として、仕様に準拠しない
3181 <code>TraceEnable extended</code> を使って、リクエストボディを
3182 受け付けるように挙動を変更できます。(オリジンサーバとしての)
3183 Apache のコアでは、リクエストボディのサイズは 64k (
3184 <code>Transfer-Encoding: chunked</code> が使われている場合は
3185 chunk ヘッダ用に +8k) に制限されます。
3186 Apache のコアは、ヘッダと全ての chunk ヘッダをレスポンスの
3188 proxy サーバとしては、リクエストボディのサイズは 64k に制限されません。</p>
3191 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3192 <div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">ディレクティブ</a></h2>
3193 <table class="directive">
3194 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Undefine the existence of a variable</td></tr>
3195 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr>
3196 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
3197 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3198 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3199 </table><p>The documentation for this directive has
3200 not been translated yet. Please have a look at the English
3202 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3203 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">ディレクティブ</a></h2>
3204 <table class="directive">
3205 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが自分自身の名前とポートを決定する方法を設定する</td></tr>
3206 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UseCanonicalName On|Off|Dns</code></td></tr>
3207 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>UseCanonicalName Off</code></td></tr>
3208 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
3209 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3210 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3212 <p>多くの状況で Apache は<em>自己参照</em> URL、すなわち
3213 同じサーバを指す URL、を作成する必要があります。
3214 <code>UseCanonicalName On</code> の場合は、<code class="directive"><a href="#servername">ServerName</a></code> ディレクティブで指定されている
3215 ホスト名とポート番号を使って、その正規名 (自己参照の名前) を生成します。
3216 この名前は、すべての自己参照 URL で使われますし、CGI の
3217 <code>SERVER_NAME</code> と <code>SERVER_PORT</code> でも使われます。</p>
3219 <p><code>UseCanonicalName Off</code> の場合、
3220 クライアントがホスト名とポートを指定したときには、
3221 それらを元に自己参照 URL を作成します (指定がなかったときは
3222 上の定義と同様にして正規名を解決します)。
3223 これらの値は<a href="../vhosts/name-based.html">名前ベースの
3224 バーチャルホスト</a>を実装で使われているのと同じ値で、
3225 同じクライアントで取得できる値になっています。
3226 CGI 変数 <code>SERVER_NAME</code> と <code>SERVER_PORT</code>
3227 もクライアントから与えられた値から作成されます。</p>
3229 <p>このような挙動が便利な例は、イントラネットのサーバで <code>www</code>
3230 のような短い名前でユーザがマシンに接続するときです。
3231 ユーザの入力で短いホスト名が使われていて、URL が<em>最後のスラッシュ無しの</em>
3232 ディレクトリになっている <code>http://www/splat</code> のようなとき、
3233 Apache はリクエストを <code>http://www.domain.com/splat/</code>
3235 認証をするように設定していると、この場合
3236 ユーザは 2 回認証をしなければならなくなります (<code>www</code> に
3237 対して 1 回、<code>www.domain.com</code> に対してもう 1 回 --
3238 詳細は <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">この話題の
3240 しかし <code class="directive">UseCanonicalName</code> が <code>Off</code> になっていると、
3241 Apache は <code>http://www/splat/</code> にリダイレクトします。</p>
3243 <p>三つ目のオプション <code>UseCanonicalName DNS</code> は、
3244 大規模な IP ベースのバーチャルホスティングで、
3245 <code>Host:</code> ヘッダを提供しない古いクライアントを
3247 このオプションでは Apache は、クライアントが接続した IP アドレスに対して
3248 DNS の逆引きを行なって、自己参照 URL を作成します。</p>
3250 <div class="warning"><h3>警告</h3>
3251 <p>CGI が <code>SERVER_NAME</code> に関して何らかの前提条件を
3252 仮定しているときには、このオプションの設定によっては動作しなく
3253 なるかもしれません。クライアントは実質的にはホスト名として
3254 何でも望みの値を指定することができます。CGI が
3255 <code>SERVER_NAME</code> を使って自己参照 URL を作成することしかしない
3256 場合は、どの設定を行なっても大丈夫なはずです。</p></div>
3260 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
3261 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3262 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3265 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3266 <div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">ディレクティブ</a></h2>
3267 <table class="directive">
3268 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>自分自身の名前とポート番号を解決する方法を設定する
3270 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
3271 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
3272 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
3273 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3274 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3276 <p>さまざまな局面で <em>自己参照</em> URL -- それ自体のサーバを参照する URL
3277 を作ることになります。<code>UseCanonicalPhysicalPort On</code> と設定すると、
3278 <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> に従って別名を
3279 生成する場合に、実際の物理ポート番号を使って構成するようになります。
3280 <code>UseCanonicalPhysicalPort Off</code> の場合は、実際の物理ポート番号は
3281 使用せず、設定された情報を元にポート番号を決めます。</p>
3283 <div class="note"><h3>注意</h3>
3284 <p>物理ポートが使われる場合の順番は次のようになっています:<br /><br />
3285 <code>UseCanonicalName On</code></p>
3287 <li><code>ServerName</code> で指定されているポート番号</li>
3289 <li>デフォルトのポート番号</li>
3291 <code>UseCanonicalName Off | DNS</code>
3293 <li><code>Host:</code> ヘッダをパースして取得されるポート番号</li>
3295 <li><code>ServerName</code> で指定されているポート番号</li>
3296 <li>デフォルトのポート番号</li>
3299 <p><code>UseCanonicalPhysicalPort Off</code> で、
3300 物理ポート番号が上記の順序付けから除外されます。</p>
3306 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
3307 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3308 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3311 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3312 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">ディレクティブ</a></h2>
3313 <table class="directive">
3314 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>特定のホスト名や IP アドレスのみに適用されるディレクティブを
3316 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code><VirtualHost
3317 <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
3318 ...> ... </VirtualHost></code></td></tr>
3319 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
3320 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3321 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3323 <p><code class="directive"><VirtualHost></code> 及び
3324 <code></VirtualHost></code> は、
3325 特定のバーチャルホストに対してのみ適用されるディレクティブ群を括る
3327 バーチャルホストコンテキストで許可される全てのディレクティブを指定可能です。
3328 サーバが、指定されたバーチャルホストにあるドキュメントへの
3330 <code class="directive"><VirtualHost></code> セクションの中にある
3332 <var>Addr</var>は、次のものが利用できます:</p>
3335 <li>バーチャルホストの IP アドレス</li>
3337 <li>バーチャルホストの IP に対応する完全なドメイン名 (非推奨)</li>
3339 <li><code>NameVirtualHost *</code> と共に使われる、
3340 すべての IP アドレスにマッチする文字 <code>*</code></li>
3342 <li>IP ベースのバーチャルホストで他のものにマッチしない IP アドレス
3343 のための文字列 <code>_default_</code></li>
3346 <div class="example"><h3>例</h3><p><code>
3347 <VirtualHost 10.1.2.3><br />
3348 <span class="indent">
3349 ServerAdmin webmaster@host.example.com<br />
3350 DocumentRoot /www/docs/host.example.com<br />
3351 ServerName host.example.com<br />
3352 ErrorLog logs/host.example.com-error_log<br />
3353 TransferLog logs/host.example.com-access_log<br />
3355 </VirtualHost>
3358 <p>IPv6 アドレスはオプションのポート番号の指定と区別するために、
3359 角括弧で括って指定する必要があります。次は IPv6 の例です:</p>
3361 <div class="example"><p><code>
3362 <VirtualHost [2001:db8::a00:20ff:fea7:ccea]><br />
3363 <span class="indent">
3364 ServerAdmin webmaster@host.example.com<br />
3365 DocumentRoot /www/docs/host.example.com<br />
3366 ServerName host.example.com<br />
3367 ErrorLog logs/host.example.com-error_log<br />
3368 TransferLog logs/host.example.com-access_log<br />
3370 </VirtualHost>
3373 <p>各々のバーチャルホストにはそれぞれ違う IP アドレス、ポート番号
3375 1 番目の場合には複数のアドレスで IP パケットを受信できるように
3376 サーバマシンを設定しなければなりません。
3377 (もし、マシンが複数のネットワークインターフェースと持たない場合は、
3378 (OSがサポートしていれば) <code>ifconfig alias</code> コマンドにより
3381 <div class="note"><h3>注意点</h3>
3382 <p><code class="directive"><VirtualHost></code> は Apache が Listen する
3383 IP アドレスには影響を与え<strong>ません</strong>。
3384 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> を
3385 使って Apache が正しいアドレスを listen するように設定する必要があります。</p>
3388 <p>IP ベースのバーチャルホストを使っている場合は、特別な名前
3389 <code>_default_</code> を指定することができます。その場合は
3390 そのバーチャルホストは他のバーチャルホストで明示的に挙げられていない
3391 すべての IP アドレスにマッチします。<code>_default_</code> バーチャルホストが無い
3392 場合に IP がバーチャルホストで指定されたものにマッチしないときは、
3393 VirtualHost セクションの外のすべての定義からなる「主」サーバ設定が
3394 使われます。(ただし、<code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> ディレクティブにマッチする
3395 すべての IP アドレスは「主」サーバ設定も <code>_default_</code> バーチャルホストも
3396 使わないことに注意してください。詳しくは <a href="../vhosts/name-based.html">ネームベースのバーチャルホスト</a> を
3399 <p><code>:port</code> といった形式で記述することにより、
3401 この指定をしない場合には、主サーバ設定における
3402 一番最後に <code><a href="#port">Port</a></code> で指定されたポートが
3404 <code>:*</code> を指定することにより、
3405 アドレス上の全てのポートにマッチします。(<code>_default_</code> のときは
3406 これを使うことが推奨されています。)</p>
3408 <p><code class="directive"><VirtualHost></code> ブロックごとに
3409 <code class="directive"><a href="#servername">ServerName</a></code> を指定すべきです。
3411 <code class="directive"><a href="#servername">ServerName</a></code>
3414 <div class="warning"><h3>セキュリティ</h3>
3415 <p>サーバーを起動した以外のユーザがログファイルが保管されるディレクトリに
3416 書き込み可能なときになぜセキュリティが破られる可能性があるかの詳細は
3417 <a href="../misc/security_tips.html">セキュリティに関するコツ</a> を
3422 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
3423 <li><a href="../dns-caveats.html">DNS と Apache に関する話</a></li>
3424 <li><a href="../bind.html">Apache が使用するアドレスとポートの設定</a></li>
3425 <li>リクエストを受けた際にこれらの異なるセクションが
3426 組み合わされる方法については <a href="../sections.html">
3427 <Directory>, <Location>, <Files> セクションの動作法</a></li>
3431 <div class="bottomlang">
3432 <p><span>言語: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
3433 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> |
3434 <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> |
3435 <a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
3436 <a href="../ja/mod/core.html" title="Japanese"> ja </a> |
3437 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
3438 </div><div id="footer">
3439 <p class="apache">Copyright 2011 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
3440 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div>