]> granicus.if.org Git - apache/blob - docs/manual/mod/core.html.ja.utf8
s/2011/2012/g
[apache] / docs / manual / mod / core.html.ja.utf8
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
7       -->
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>
13 <body>
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.5</p>
17 <img alt="" src="../images/feather.gif" /></div>
18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
19 <div id="path">
20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン
21             2.5</a> &gt; <a href="./">モジュール</a></div>
22 <div id="page-content">
23 <div id="preamble"><h1>Apache コア機能</h1>
24 <div class="toplang">
25 <p><span>言語: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
26 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
27 <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
28 <a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
29 <a href="../ja/mod/core.html" title="Japanese">&nbsp;ja&nbsp;</a> |
30 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
31 </div>
32 <div class="outofdate">この日本語訳はすでに古くなっている可能性があります。
33           更新された内容を見るには英語版をご覧下さい。</div>
34 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>常に使用可能な Apache HTTP サーバのコア機能</td></tr>
35 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Core</td></tr></table>
36 </div>
37 <div id="quickview"><h3 class="directives">ディレクティブ</h3>
38 <ul id="toc">
39 <li><img alt="" src="../images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
40 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
41 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
42 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
43 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
44 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
45 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</a></li>
46 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
47 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
48 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
49 <li><img alt="" src="../images/down.gif" /> <a href="#define">Define</a></li>
50 <li><img alt="" src="../images/down.gif" /> <a href="#directory">&lt;Directory&gt;</a></li>
51 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch">&lt;DirectoryMatch&gt;</a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#else">&lt;Else&gt;</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#elseif">&lt;ElseIf&gt;</a></li>
55 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
56 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
57 <li><img alt="" src="../images/down.gif" /> <a href="#error">Error</a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
59 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li>
61 <li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
62 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
63 <li><img alt="" src="../images/down.gif" /> <a href="#files">&lt;Files&gt;</a></li>
64 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch">&lt;FilesMatch&gt;</a></li>
65 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
66 <li><img alt="" src="../images/down.gif" /> <a href="#gprofdir">GprofDir</a></li>
67 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
68 <li><img alt="" src="../images/down.gif" /> <a href="#if">&lt;If&gt;</a></li>
69 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine">&lt;IfDefine&gt;</a></li>
70 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule">&lt;IfModule&gt;</a></li>
71 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
72 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
74 <li><img alt="" src="../images/down.gif" /> <a href="#limit">&lt;Limit&gt;</a></li>
75 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept">&lt;LimitExcept&gt;</a></li>
76 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
77 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
78 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
79 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
80 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
81 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
82 <li><img alt="" src="../images/down.gif" /> <a href="#location">&lt;Location&gt;</a></li>
83 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch">&lt;LocationMatch&gt;</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#maxrangeoverlaps">MaxRangeOverlaps</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#maxrangereversals">MaxRangeReversals</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#maxranges">MaxRanges</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#mutex">Mutex</a></li>
90 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
91 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
92 <li><img alt="" src="../images/down.gif" /> <a href="#protocol">Protocol</a></li>
93 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
94 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
95 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
96 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
97 <li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
98 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
99 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
100 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
101 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
102 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
103 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
104 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
105 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
106 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
107 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
108 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
109 <li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
110 <li><img alt="" src="../images/down.gif" /> <a href="#undefine">UnDefine</a></li>
111 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
112 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
113 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>
114 </ul>
115 </div>
116
117 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
118 <div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">ディレクティブ</a></h2>
119 <table class="directive">
120 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロトコルを Listen しているソケットの最適化を設定する</td></tr>
121 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AcceptFilter <var>protocol</var> <var>accept_filter</var></code></td></tr>
122 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
123 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
124 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
125 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.1.5 以降</td></tr>
126 </table>
127     <p>Listen しているソケットに対して、OS が固有に持っているプロトコルについての最適化を
128        有効にするディレクティブです。大前提となる条件は、データが受信されるか
129        HTTP リクエスト全体がバッファされるかするまで、カーネルがサーバプロセスに
130        ソケットを送らないようになっている、ということです。現在サポートされているのは、
131        <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&amp;sektion=9">
132        FreeBSD の Accept Filter</a> と Linux のプリミティブな
133        <code>TCP_DEFER_ACCEPT</code> のみです。</p>
134
135     <p>FreeBSD のデフォルト値は :</p>
136     <div class="example"><p><code>
137         AcceptFilter http httpready <br />
138         AcceptFilter https dataready
139     </code></p></div>
140     
141     <p><code>httpready</code> Accept Filter は HTTP リクエスト全体を、
142        カーネルレベルでバッファリングします。リクエスト全体を受信し終わると、
143        その後サーバプロセスにそれを送ります。詳細については <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&amp;sektion=9">accf_http(9)</a> 
144        を参照してください。HTTPS のリクエストは暗号化されているので <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&amp;sektion=9">accf_data(9)</a>
145        フィルタのみが使用されます。</p>
146
147     <p>Linux でのデフォルト値は :</p>
148     <div class="example"><p><code>
149         AcceptFilter http data <br />
150         AcceptFilter https data
151     </code></p></div>
152
153     <p>Linux の <code>TCP_DEFER_ACCEPT</code> は HTTP リクエストのバッファリングを
154        サポートしていません。<code>none</code> 以外の値で
155        <code>TCP_DEFER_ACCEPT</code> が有効になります。詳細については Linux 
156        man ページ <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">tcp(7)</a>
157        を参照してください。</p>
158
159     <p>引数に <code>none</code> を指定すると、プロトコルに対する全ての Accept 
160        Filter が無効になります。<code>nntp</code> といった、先にサーバにデータを
161        送る必要のあるプロトコルに有効です :</p>
162     <div class="example"><p><code>AcceptFilter nntp none</code></p></div>
163
164
165 </div>
166 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
167 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">ディレクティブ</a></h2>
168 <table class="directive">
169 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>後に続くパス名情報を受け付けるリソースの指定</td></tr>
170 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
171 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
172 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
173 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
174 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
175 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
176 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.30 以降で使用可能</td></tr>
177 </table>
178
179     <p>このディレクティブは実際のファイル名 (もしくは存在するディレクトリの
180     存在しないファイル) の後に続くパス名情報があるリクエストを受け付けるか
181     拒否するかを制御します。続きのパス名情報はスクリプトには <code>PATH_INFO</code>
182     環境変数として利用可能になります。</p>
183
184     <p>例えば、<code>/test/</code> が、<code>here.html</code> というファイル
185     一つのみがあるディレクトリを指しているとします。そうすると、
186     <code>/test/here.html/more</code> と <code>/test/nothere.html/more</code>
187     へのリクエストは両方とも <code>/more</code> を <code>PATH_INFO</code> とします。</p>
188
189     <p><code class="directive">AcceptPathInfo</code> ディレクティブに指定可能な
190     三つの引数は:</p>
191
192     <dl>
193     <dt><code>Off</code></dt><dd>リクエストは存在するパスにそのまま
194     マップされる場合にのみ受け付けられます。ですから、上の例の
195     <code>/test/here.html/more</code> のように、本当のファイル名の
196     後にパス名情報が続くリクエストには 404 NOT FOUND エラーが返ります。</dd>
197
198     <dt><code>On</code></dt><dd>前の方のパスが存在するファイルにマップする場合は
199     リクエストが受け付けられます。上の例の <code>/test/here.html/more</code>
200     は <code>/test/here.html</code> が有効なファイルにマップすれば
201     受け付けられます。</dd>
202     
203     <dt><code>Default</code></dt><dd>続きのパス名情報の扱いはリクエストの
204     <a href="../handler.html">ハンドラ</a>で決まります。
205     普通のファイルのためのコアハンドラのデフォルトは <code>PATH_INFO</code> を拒否します。
206     <a href="mod_cgi.html">cgi-script</a> や <a href="mod_isapi.html">isapi-handler</a> のようにスクリプトを扱うハンドラは
207     一般的にデフォルトで <code>PATH_INFO</code> を受け付けます。</dd>
208     </dl>
209
210     <p><code>AcceptPathInfo</code> の主な目的はハンドラの <code>PATH_INFO</code> を
211     受け付けるか拒否するかの選択を上書きできるようにすることです。
212     例えば、これは例えば <a href="mod_include.html">INCLUDES</a> のような
213     <a href="../filter.html">フィルタ</a>を使って <code>PATH_INFO</code> に
214     基づいてコンテンツを生成しているときに必要になります。
215     コアハンドラでは通常拒否されるので、そういったスクリプトを動作させるには
216     次のような設定を使います。</p>
217
218     <div class="example"><p><code>
219       &lt;Files "mypaths.shtml"&gt;<br />
220       <span class="indent">
221         Options +Includes<br />
222         SetOutputFilter INCLUDES<br />
223         AcceptPathInfo On<br />
224       </span>
225       &lt;/Files&gt;
226     </code></p></div>
227
228 </div>
229 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
230 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">ディレクティブ</a></h2>
231 <table class="directive">
232 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>分散設定ファイルの名前</td></tr>
233 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AccessFileName <var>filename</var> [<var>filename</var>] ...</code></td></tr>
234 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
235 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
236 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
237 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
238 </table>
239     <p>リクエストを処理するとき、サーバはディレクトリに
240     対して分散設定ファイルが<a href="#allowoverride">有効になっていれば</a>、
241     そのドキュメントへの
242     パス上にある全てのディレクトリから、ここで指定された名前の一覧の中で
243     最初に見つかったファイルをそれぞれ設定ファイルとして読み込みます。例えば:</p>
244
245     <div class="example"><p><code>
246       AccessFileName .acl
247     </code></p></div>
248
249     <p>という設定があると、以下のようにして無効にされていない限り、
250     ドキュメント <code>/usr/local/web/index.html</code>
251     を返す前に、サーバは <code>/.acl</code>, <code>/usr/.acl</code>,
252     <code>/usr/local/.acl</code>, <code>/usr/local/web/.acl</code> から
253     ディレクティブを読み込みます。</p>
254
255     <div class="example"><p><code>
256       &lt;Directory /&gt;<br />
257       <span class="indent">
258         AllowOverride None<br />
259       </span>
260       &lt;/Directory&gt;
261     </code></p></div>
262
263 <h3>参照</h3>
264 <ul>
265 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
266 <li><a href="../configuring.html">設定ファイル</a></li>
267 <li><a href="../howto/htaccess.html">.htaccess ファイル</a></li>
268 </ul>
269 </div>
270 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
271 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">ディレクティブ</a></h2>
272 <table class="directive">
273 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>レスポンスのコンテントタイプが <code>text/plain</code> あるいは
274 <code>text/html</code> の場合に追加するデフォルトの charset パラメータ</td></tr>
275 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AddDefaultCharset On|Off|<var>charset</var></code></td></tr>
276 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
277 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
278 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
279 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
280 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
281 </table>
282     <p>レスポンスのコンテントタイプが <code>text/plain</code> 
283     あるいは <code>text/html</code> 
284     の場合に限りますが、レスポンスに追加するメディアタイプの文字セットパラメータ
285     (文字エンコーディングの名前) のデフォルト値を、このディレクティブで指定します。
286     これはレスポンス <span class="transnote">(<em>訳注:</em> レスポンスの HTML)</span> 内で <code>META</code> 
287     要素で指定された、どのような文字セットも無効にしますが、
288     最終的な挙動はユーザのクライアント側の設定で決まります。
289     この機能は <code>AddDefaultCharset Off</code> という設定で無効になります。
290     <code>AddDefaultCharset On</code> にすれば、
291     Apache 内部のデフォルト文字セット <code>iso-8859-1</code> に設定されます。
292     その他 <var>charset</var> に指定できる値であれば、どんな値でも使えます。
293     指定する値は、MIME メディアタイプとして使われる
294     <a href="http://www.iana.org/assignments/character-sets">IANA 
295     に登録されている文字セット名</a>のうちの一つにすべきです。
296     例えば:</p>
297
298     <div class="example"><p><code>
299       AddDefaultCharset utf-8
300     </code></p></div>
301
302     <p><code class="directive">AddDefaultCharset</code> を使うときは、全てのテキストリソースが
303     指定する文字エンコードになっていると分かっていて、かつ、
304     リソースの個々に文字セットを指定するのが大変な場合のみです。
305     例を挙げると、レガシーな CGI スクリプトなどの、動的に生成される
306     コンテンツを含むリソースに文字セットパラメータを追加する場合で、
307     ユーザの入力データが出力に入り、クロスサイトスクリプティングが
308     引き起こされうる場合です。デフォルト文字セットをセットしたとしても、
309     ブラウザの "文字エンコードの自動選択" 機能が有効になっているユーザを
310     守ることにはならないので、もちろんより良い解決策は単にスクリプトを修正
311     (あるいは削除) することです。</p>
312
313 <h3>参照</h3>
314 <ul>
315 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
316 </ul>
317 </div>
318 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
319 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">ディレクティブ</a></h2>
320 <table class="directive">
321 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>URL 中の符号化されたパス分離文字が先に伝えられるのを許可するかどうかを
322 決定する</td></tr>
323 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
324 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
325 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
326 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
327 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
328 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.46 以降で使用可能</td></tr>
329 </table>
330     <p><code class="directive">AllowEncodedSlashes</code> ディレクティブは符号化された
331     パス分離文字 (<code>/</code> は <code>%2F</code>、さらにシステムによっては
332     <code>\</code> に対応する <code>%5C</code>) が存在する URL の使用を
333     許可するかどうかを決定します。通常はそのような URL は 404 (Not found) エラー
334     で拒否されます。</p>
335
336     <p><code class="directive">AllowEncodedSlashes</code> <code>On</code> による
337     パス分離文字の使用は、<code>PATH_INFO</code> と合わせて
338     使うときに一番役に立ちます。</p>
339
340     <div class="note"><h3>注</h3>
341       <p>符号化されたスラッシュを許可することは、<em>復号</em>をすることを
342        意味<em>しません</em>。<code>%2F</code> や (関係するシステムでの)
343        <code>%5C</code> は、他の部分が復号された URL の中でもそのままの形式で
344        残されます。</p>
345     </div>
346
347 <h3>参照</h3>
348 <ul>
349 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
350 </ul>
351 </div>
352 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
353 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">ディレクティブ</a></h2>
354 <table class="directive">
355 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>.htaccess</code> で許可されるディレクティブの種類</td></tr>
356 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AllowOverride All|None|<var>directive-type</var> 
357 [<var>directive-type</var>] ...</code></td></tr>
358 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AllowOverride All</code></td></tr>
359 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr>
360 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
361 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
362 </table>
363     <p>サーバが (<code class="directive"><a href="#accessfilename">AccessFileName</a></code> によって指定された)
364     <code>.htaccess</code> ファイルを見つけた時、そのファイルの中で
365     宣言されたどのディレクティブがより前に定義された設定ディレクティブを
366     上書きできるかを知る必要があります。</p>
367
368     <div class="note"><h3>&lt;Directory&gt; セクションでのみ使用可能</h3>
369     <code class="directive">AllowOverride</code> は正規表現無しの<code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
370     セクションでのみ有効で、<code class="directive"><a href="#location">&lt;Location&gt;</a></code> や <code class="directive"><a href="#directorymatch">&lt;DirectoryMatch&gt;</a></code>
371     や <code class="directive"><a href="#files">&lt;Files&gt;</a></code> セクションでは無効です。
372     </div>
373
374     <p>このディレクティブを <code>None</code> に設定すると、<a href="#accessfilename">.htaccess</a> ファイルは完全に
375     無視されます。
376     この場合、サーバはファイルシステムの <code>.htaccess</code> ファイルを読むことを
377     試みさえしません。</p>
378
379     <p>このディレクティブが <code>All</code> に設定されている時には、
380     <code>.htaccess</code> という <a href="directive-dict.html#Context">コンテキスト</a> を持つ
381     全てのディレクティブが利用できます。</p>
382
383     <p><var>directive-type</var> には、以下のディレクティブ群の
384     キーワードのどれかを指定します。</p>
385
386     <dl>
387       <dt>AuthConfig</dt>
388
389       <dd>
390
391       認証に関するディレクティブの使用を許可する (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
392       <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
393       <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
394       <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>, 
395       <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>
396
397       <dt>FileInfo</dt>
398
399       <dd>
400       ドキュメントタイプを制御するためのディレクティブの使用を許可する (<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>,
401       <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>, 
402       <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> の Add* と Remove*
403       ディレクティブ<em>など</em>),
404       ドキュメントのメタデータ (<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>),
405       <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>) と
406       <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code> の
407       <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code>
408       ディレクティブ。
409       </dd>
410
411       <dt>Indexes</dt>
412
413       <dd>
414       ディレクトリインデックスを制御するためのディレクティブの使用を許可する
415       (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
416       <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>,
417       <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
418       <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>
419       <em>など</em>)。</dd>
420
421       <dt>Limit</dt>
422
423       <dd>
424       ホストへのアクセス制御を行うためのディレクティブの使用を許可する (<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>
425
426       <dt>Options[=<var>Option</var>,...]</dt>
427
428       <dd>
429       特定のディレクトリにおける機能を指定するためのディレクティブの使用を許可する
430       (<code class="directive"><a href="#options">Options</a></code> と
431       <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>)。
432       <code class="directive"><a href="#options">Options</a></code> で設定するオプション
433       を、(空白を含めない) コンマ区切りのリストにして等号の後に続けることで
434       設定できます。</dd>
435     </dl>
436
437     <p>例:</p>
438
439     <div class="example"><p><code>
440       AllowOverride AuthConfig Indexes
441     </code></p></div>
442
443     <p>上の例では <code>AuthConfig</code> と <code>Indexes</code> のどちらにも
444     属さないディレクティブはすべて内部サーバエラーを引き起こします。</p>
445
446 <h3>参照</h3>
447 <ul>
448 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
449 <li><a href="../configuring.html">設定ファイル</a></li>
450 <li><a href="../howto/htaccess.html">.htaccess ファイル</a></li>
451 </ul>
452 </div>
453 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
454 <div class="directive-section"><h2><a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a name="allowoverridelist" id="allowoverridelist">ディレクティブ</a></h2>
455 <table class="directive">
456 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Individual directives that are allowed in
457 <code>.htaccess</code> files</td></tr>
458 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>AllowOverrideList None|<var>directive</var>
459 [<var>directive-type</var>] ...</code></td></tr>
460 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>AllowOverrideList None</code></td></tr>
461 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr>
462 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
463 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
464 </table><p>The documentation for this directive has
465             not been translated yet. Please have a look at the English
466             version.</p><h3>参照</h3>
467 <ul>
468 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
469 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
470 <li><a href="../configuring.html">Configuration Files</a></li>
471 <li><a href="../howto/htaccess.html">.htaccess Files</a></li>
472 </ul>
473 </div>
474 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
475 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">ディレクティブ</a></h2>
476 <table class="directive">
477 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>CGI スクリプトのインタープリタの位置を調べるための手法</td></tr>
478 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CGIMapExtension <var>cgi-path</var> <var>.extension</var></code></td></tr>
479 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
480 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
481 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
482 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
483 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>NetWare のみ</td></tr>
484 </table>
485     <p>このディレクティブは Apache が CGI スクリプトを実行するための
486     インタープリタを探す方法を制御します。
487     例えば、<code>CGIMapExtension sys:\foo.nlm .foo</code> と設定すると
488     <code>.foo</code> という拡張子のすべての CGI スクリプトは FOO インタープリタに
489     渡されます。</p>
490
491 </div>
492 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
493 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">ディレクティブ</a></h2>
494 <table class="directive">
495 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>Content-MD5</code> HTTP 応答ヘッダの生成を有効にする</td></tr>
496 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ContentDigest On|Off</code></td></tr>
497 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ContentDigest Off</code></td></tr>
498 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
499 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Options</td></tr>
500 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
501 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
502 </table>
503     <p>このディレクティブは、RFC1864 及び RFC2616 において定義されている
504     <code>Content-MD5</code> ヘッダーの生成を有効にします。</p>
505
506     <p>MD5 は、任意長のデータの「メッセージダイジェスト」(「指紋」
507     と表現されることもある) を計算するアルゴリズムで、
508     データの変更があった場合には非常に高い信頼度でメッセージダイジェストに変更が
509     反映されます。</p>
510
511     <p><code>Content-MD5</code> ヘッダは、エンドツーエンドで
512     エンティティボディーに含まれるメッセージの完全性チェック
513     (Message Integrity Check - MIC)を提供します。
514     このヘッダを調べることで、プロキシやクライアントは、
515     途中経路におけるエンティティボディの予期せぬ変更などを
516     検出することができます。ヘッダの例:</p>
517
518     <div class="example"><p><code>
519       Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
520     </code></p></div>
521
522     <p>リクエスト毎にメッセージダイジェストを計算する (値はキャッシュされません)
523     ことから、
524     サーバパフォーマンスが低下することについて注意してください。</p>
525
526     <p><code>Content-MD5</code>は、<code class="module"><a href="../mod/core.html">core</a></code> 機能により処理された
527     ドキュメントを送るときのみ有効であり、
528     SSI ドキュメントや CGI スクリプトの出力、バイトレンジを指定した
529     応答の場合にはこのヘッダは付与されません。
530     </p>
531
532 </div>
533 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
534 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">ディレクティブ</a></h2>
535 <table class="directive">
536 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバがコンテントタイプを決定できないときに
537 送られる MIME コンテントタイプ</td></tr>
538 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>DefaultType <var>MIME-type|none</var></code></td></tr>
539 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>DefaultType text/plain</code></td></tr>
540 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
541 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
542 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
543 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
544 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>引数 <code>none</code> は Apache 2.2.7 以降で利用可能</td></tr>
545 </table>
546     <p>サーバは、<a class="glossarylink" href="../glossary.html#mime-type" title="用語集を参照">MIME タイプ</a>
547     のマップからは決定できないドキュメントの送信を要求されることがあります。</p>
548
549     <p>サーバは、ドキュメントのコンテントタイプをクライアントに通知するべきです。
550     サーバで通常の方法ではこれが判定できない場合は、
551     <code>DefaultType</code> で指定されたタイプを利用します。
552     例:</p>
553
554     <div class="example"><p><code>
555       DefaultType image/gif
556     </code></p></div>
557
558     <p>これは <code>.gif</code> という拡張子がファイル名に含まれていない
559     多くの GIF 画像が含まれているディレクトリに適しているでしょう。</p>
560
561     <p>サーバでも管理者でも判定することができない (例えばプロクシの) 場合、
562     誤った情報を与えるよりは MIME タイプの指定がない状態が望ましいことも
563     あります。この場合は次のようにします :</p>
564     <div class="example"><p><code>
565       DefaultType None
566     </code></p></div>
567     <p><code>DefaultType None</code> は httpd-2.2.7 
568     以降でのみ利用できます。</p>
569
570     <p><code class="directive"><a href="#forcetype">ForceType</a></code> ディレクティブと
571     違って、このディレクティブはデフォルトの MIME タイプを提供するだけで
572     あることに注意してください。ファイル名の拡張子を含め、
573     メディアタイプを決定できる他の MIME タイプの定義があれば
574     このデフォルトは上書きされます。</p>
575
576 </div>
577 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
578 <div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">ディレクティブ</a></h2>
579 <table class="directive">
580 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>変数の存在を宣言する</td></tr>
581 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Define <var>parameter-name</var></code></td></tr>
582 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
583 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
584 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
585 </table>
586     <p><code class="program"><a href="../programs/httpd.html">httpd</a></code> の <code>-D</code>
587     引数と同じものです。</p>
588     <p>このディレクティブを使うと、スタートアップスクリプトに
589     記載されている <code>-D</code> 引数を書き換える必要なく、
590     <code class="directive"><a href="#ifdefine">&lt;IfDefine&gt;</a></code>
591     セクションを切り替えることができます。</p>
592
593 </div>
594 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
595 <div class="directive-section"><h2><a name="Directory" id="Directory">&lt;Directory&gt;</a> <a name="directory" id="directory">ディレクティブ</a></h2>
596 <table class="directive">
597 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>指定のファイルシステムのディレクトリとサブディレクトリとのみに
598 適用されるディレクティブを囲む</td></tr>
599 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;Directory <var>directory-path</var>&gt;
600 ... &lt;/Directory&gt;</code></td></tr>
601 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
602 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
603 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
604 </table>
605     <p>指定されたディレクトリとそのサブディレクトリにのみ
606     ディレクティブを適用させるためには、
607     <code class="directive">&lt;Directory&gt;</code> と 
608     <code>&lt;/Directory&gt;</code> を対として、ディレクティブ群を囲います。
609     その中には、ディレクトリコンテキストで許可された全てのディレクティブを
610     利用できます。
611     <var>directive-path</var> は、フルパスもしくは Unix のシェル形式の
612     ワイルドカードを指定します。
613     <code>?</code> は任意の 1 文字、<code>*</code> は任意の文字列にマッチします。
614     シェルにおける指定同様、文字の範囲を <code>[]</code> で指定できます。
615     ワイルドカードは `/' 文字にはマッチしませんので、
616     <code>/home/user/public_html</code> には
617     <code>&lt;Directory /*/public_html&gt;</code> はマッチしませんが、
618     <code>&lt;Directory /home/*/public_html&gt;</code> はマッチします。
619     例:</p>
620
621     <div class="example"><p><code>
622       &lt;Directory /usr/local/httpd/htdocs&gt;<br />
623       <span class="indent">
624         Options Indexes FollowSymLinks<br />
625       </span>
626       &lt;/Directory&gt;
627     </code></p></div>
628
629     <div class="note">
630       <p><var>directory-path</var> 引数には注意してください: その引数は
631       Apache がファイルをアクセスするために使うファイルシステムのパスに
632       そのままマッチする必要があります。ある <code>&lt;Directory&gt;</code> に
633       適用されるディレクティブは、別のシンボリックリンクをたどったりして
634       同じディレクトリを違うパスでアクセスした場合には適用されません。</p>
635     </div>
636
637     <p><code>~</code> という文字を
638     付加することで<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を利用することもできます。
639     例えば:</p>
640
641     <div class="example"><p><code>
642       &lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
643     </code></p></div>
644
645     <p>といった指定の場合、<code>/www/</code> 以下にある数字
646     3 文字のディレクトリにマッチします。</p>
647
648     <p>もし複数の (正規表現以外の) <code class="directive">&lt;Directory&gt;</code>セクションが
649     ドキュメントを含むディレクトリ (やその上位ディレクトリのどれか) とマッチしたならば、
650     <a href="#accessfilename">.htaccess</a> ファイルのディレクティブも読み込みつつ、
651     短いパスから順に適用されます。
652     例えば、</p>
653
654     <div class="example"><p><code>
655       &lt;Directory /&gt;<br />
656       <span class="indent">
657         AllowOverride None<br />
658       </span>
659       &lt;/Directory&gt;<br />
660       <br />
661       &lt;Directory /home/&gt;<br />
662       <span class="indent">
663         AllowOverride FileInfo<br />
664       </span>
665       &lt;/Directory&gt;
666     </code></p></div>
667
668     <p>と設定し、ドキュメント <code>/home/web/dir/doc.html</code> への
669     アクセスがあった場合には以下のように動作します:</p>
670
671     <ul>
672       <li><code>AllowOverride None</code> が適用される。
673       (<code>.htaccess</code> ファイルは無効になる)</li>
674
675       <li><code>AllowOverride FileInfo</code> が適用される
676       (<code>/home</code> ディレクトリに対して)。</li>
677
678       <li><code>/home/.htaccess</code>, <code>/home/web/.htaccess</code>,
679       <code>/home/web/dir/.htaccess</code> の順にそれらのファイル中の
680        FileInfo ディレクティブが適用される。</li>
681     </ul>
682
683     <p>正規表現は、通常のセクションがすべて適用されるまで
684     考慮されません。
685     その後、全ての正規表現が設定ファイルに現れた順で試されます。
686     例えば、以下のような場合に</p>
687
688     <div class="example"><p><code>
689       &lt;Directory ~ abc$&gt;<br />
690       <span class="indent">
691         # ... directives here ...<br />
692       </span>
693       &lt;/Directory&gt;
694     </code></p></div>
695
696     <p>正規表現のセクションはすべての通常の <code class="directive">&lt;Directory&gt;</code> と
697     <code>.htaccess</code> の適用が終わるまで考慮されません。
698     その後で、正規表現は <code>/home/abc/public_html/abc</code> にマッチし、
699     対応する <code class="directive">&lt;Directory&gt;</code> が適用されます。</p>
700
701     <p><strong>Apache のデフォルトでは <code>&lt;Directory /&gt;</code> へのアクセスは
702     <code>Allow from All</code> になっていることに注意してください。
703     これは、URL からマップされたどのファイルでも Apache は送るということです。
704     これは以下のようにして変更することが推奨されています。</strong></p>
705
706     <div class="example"><p><code>
707       &lt;Directory /&gt;<br />
708       <span class="indent">
709         Order Deny,Allow<br />
710         Deny from All<br />
711       </span>
712       &lt;/Directory&gt;
713     </code></p></div>
714
715     <p><strong>そしてアクセスを<em>可能にしたい</em>ディレクトリに対して
716     個別に設定すればよいでしょう。
717     このあたりについては、<a href="../misc/security_tips.html">セキュリティに関するコツ</a>を
718     参照してください。</strong></p>
719
720     <p>ディレクトリセクションは <code>httpd.conf</code> ファイルに書きます。
721     <code class="directive">&lt;Directory&gt;</code>
722     ディレクティブは入れ子にすることができず、
723     <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> や <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> セクションの中にも
724     記述できません。</p>
725
726
727 <h3>参照</h3>
728 <ul>
729 <li>リクエストを受けた際にこれらの異なるセクションが
730     組み合わされる方法については <a href="../sections.html">
731     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
732 </ul>
733 </div>
734 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
735 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a> <a name="directorymatch" id="directorymatch">ディレクティブ</a></h2>
736 <table class="directive">
737 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>正規表現にマッチするファイルシステムのディレクトリと
738 サブディレクトリとのみに適用されるディレクティブを囲む</td></tr>
739 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
740 ... &lt;/DirectoryMatch&gt;</code></td></tr>
741 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
742 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
743 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
744 </table>
745     <p><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
746     ディレクティブと同様に、<code class="directive">&lt;DirectoryMatch&gt;</code>
747     と <code>&lt;/DirectoryMatch&gt;</code> は指定されたディレクトリと
748     そのサブディレクトリにのみ適用されるディレクティブ群を囲います。
749     しかし、このディレクティブは引数として<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>をとります。例えば:</p>
750
751     <div class="example"><p><code>
752       &lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}"&gt;
753     </code></p></div>
754
755     <p>は <code>/www/</code> 以下にある数字 3 文字のディレクトリにマッチします。</p>
756
757
758 <h3>参照</h3>
759 <ul>
760 <li>通常の <code class="directive">&lt;Directory&gt;</code> と正規表現の指定が
761 適用される順番については <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code></li>
762 <li>リクエストを受けた際にこれらの異なるセクションが
763     組み合わされる方法については <a href="../sections.html">
764     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
765 </ul>
766 </div>
767 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
768 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">ディレクティブ</a></h2>
769 <table class="directive">
770 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ウェブから見えるメインのドキュメントツリーになる
771 ディレクトリ</td></tr>
772 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>DocumentRoot <var>directory-path</var></code></td></tr>
773 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
774 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
775 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
776 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
777 </table>
778     <p>このディレクティブは、<code class="program"><a href="../programs/httpd.html">httpd</a></code>
779     がファイルを提供するディレクトリを設定します。
780      <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> のようなディレクティブにマッチしない場合には、
781     ドキュメントの (訳注:ファイルシステム上の) パスを生成するために、
782     リクエストされた URL のパス部分をドキュメントルートに付与します。
783     例:</p>
784
785     <div class="example"><p><code>
786       DocumentRoot /usr/web
787     </code></p></div>
788
789     <p>この場合、
790     <code>http://www.my.host.com/index.html</code> へのアクセスがあれば
791     <code>/usr/web/index.html</code> が返されます。
792     <var>directory-path</var> が絶対パスでない場合は、
793     <code class="directive"><a href="#serverroot">ServerRoot</a></code> 
794     からの相対パスとみなされます。</p>
795
796     <p><code class="directive">DocumentRoot</code> は最後のスラッシュ無しで
797     指定する必要があります。</p>
798
799 <h3>参照</h3>
800 <ul>
801 <li><a href="../urlmapping.html#documentroot">URL をファイルシステムの位置に
802 マップする</a></li>
803 </ul>
804 </div>
805 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
806 <div class="directive-section"><h2><a name="Else" id="Else">&lt;Else&gt;</a> <a name="else" id="else">ディレクティブ</a></h2>
807 <table class="directive">
808 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Contains directives that apply only if the condition of a
809 previous <code class="directive"><a href="#if">&lt;If&gt;</a></code> or
810 <code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code> section is not
811 satisfied by a request at runtime</td></tr>
812 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;Else&gt; ... &lt;/Else&gt;</code></td></tr>
813 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
814 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
815 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
816 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
817 </table><p>The documentation for this directive has
818             not been translated yet. Please have a look at the English
819             version.</p><h3>参照</h3>
820 <ul>
821 <li><code class="directive"><a href="#if">&lt;If&gt;</a></code></li>
822 <li><code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code></li>
823 <li><a href="../sections.html">How &lt;Directory&gt;, &lt;Location&gt;,
824     &lt;Files&gt; sections work</a> for an explanation of how these
825     different sections are combined when a request is received.
826     <code class="directive">&lt;If&gt;</code>,
827     <code class="directive">&lt;ElseIf&gt;</code>, and
828     <code class="directive">&lt;Else&gt;</code> are applied last.</li>
829 </ul>
830 </div>
831 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
832 <div class="directive-section"><h2><a name="ElseIf" id="ElseIf">&lt;ElseIf&gt;</a> <a name="elseif" id="elseif">ディレクティブ</a></h2>
833 <table class="directive">
834 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Contains directives that apply only if a condition is satisfied
835 by a request at runtime while the condition of a previous
836 <code class="directive"><a href="#if">&lt;If&gt;</a></code> or
837 <code class="directive">&lt;ElseIf&gt;</code> section is not
838 satisfied</td></tr>
839 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;ElseIf <var>expression</var>&gt; ... &lt;/ElseIf&gt;</code></td></tr>
840 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
841 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
842 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
843 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
844 </table><p>The documentation for this directive has
845             not been translated yet. Please have a look at the English
846             version.</p><h3>参照</h3>
847 <ul>
848 <li><a href="../expr.html">Expressions in Apache HTTP Server</a>,
849 for a complete reference and more examples.</li>
850 <li><code class="directive"><a href="#if">&lt;If&gt;</a></code></li>
851 <li><code class="directive"><a href="#else">&lt;Else&gt;</a></code></li>
852 <li><a href="../sections.html">How &lt;Directory&gt;, &lt;Location&gt;,
853     &lt;Files&gt; sections work</a> for an explanation of how these
854     different sections are combined when a request is received.
855     <code class="directive">&lt;If&gt;</code>,
856     <code class="directive">&lt;ElseIf&gt;</code>, and
857     <code class="directive">&lt;Else&gt;</code> are applied last.</li>
858 </ul>
859 </div>
860 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
861 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">ディレクティブ</a></h2>
862 <table class="directive">
863 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>配送中にファイルを読み込むためにメモリマッピングを
864 使うかどうか</td></tr>
865 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
866 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>EnableMMAP On</code></td></tr>
867 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
868 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
869 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
870 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
871 </table>
872     <p>このディレクティブは配送中にファイルの内容を読み込む必要があるときに
873     <code class="program"><a href="../programs/httpd.html">httpd</a></code> がメモリマッピングを使うかどうかを制御します。
874     デフォルトでは、
875     例えば、<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> を使って SSI ファイルを配送
876     するときのように、ファイルの途中のデータをアクセスする必要があるときには
877     Apache は OS がサポートしていればファイルをメモリにマップします。</p>
878
879     <p>
880     このメモリマップは性能の向上をもたらすことがあります。
881     しかし、環境によっては運用上の問題を防ぐためにメモリマッピングを
882     使用しないようにした方が良い場合もあります:</p>
883
884     <ul>
885     <li>マルチプロセッサシステムの中にはメモリマッピングをすると
886     <code class="program"><a href="../programs/httpd.html">httpd</a></code> の性能が落ちるものがあります。</li>
887     <li>NFS マウントされた <code class="directive"><a href="#documentroot">DocumentRoot</a></code>
888     では、<code class="program"><a href="../programs/httpd.html">httpd</a></code> がメモリマップしている間にファイルが削除されたり
889     短くなったりしたときに起こるセグメンテーションフォールトのために
890     <code class="program"><a href="../programs/httpd.html">httpd</a></code> がクラッシュする可能性があります。</li>
891     </ul>
892
893     <p>これらの問題に当てはまるサーバの設定の場合は、以下のようにして
894     ファイルの配送時のメモリマッピングを使用不可にしてください:</p>
895
896     <div class="example"><p><code>
897       EnableMMAP Off
898     </code></p></div>
899
900     <p>NFS マウントされたファイルには、問題のあるファイルにのみ明示的に
901     この機能を使用不可にします:</p>
902
903     <div class="example"><p><code>
904       &lt;Directory "/path-to-nfs-files"&gt;
905       <span class="indent">
906         EnableMMAP Off
907       </span>
908       &lt;/Directory&gt;
909     </code></p></div>
910
911 </div>
912 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
913 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">ディレクティブ</a></h2>
914 <table class="directive">
915 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ファイルのクライアントへの配送時にカーネルの sendfile サポートを
916 使うかどうか</td></tr>
917 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
918 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>EnableSendfile On</code></td></tr>
919 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
920 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
921 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
922 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
923 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>バージョン 2.0.44 以降で使用可能</td></tr>
924 </table>
925     <p>このディレクティブはクライアントにファイルの内容を送るときに
926     <code class="program"><a href="../programs/httpd.html">httpd</a></code> がカーネルの
927     sendfile サポートを使うかどうかを制御します。デフォルトでは、
928     例えば静的なファイルの配送のように、リクエストの処理にファイルの
929     途中のデータのアクセスを必要としないときには、Apache は OS が
930     サポートしていればファイルを読み込むことなく sendfile を使って
931     ファイルの内容を送ります。</p>
932
933     <p>sendfile は read と send を別々に行なうことと、バッファの割り当てを
934     回避します。しかし、プラットフォームやファイルシステムの中には
935     運用上の問題を避けるためにこの機能を使用不可にした方が良い場合があります:</p>
936
937     <ul>
938     <li>プラットフォームの中にはビルドシステムが検知できなかった、壊れた
939     sendfile のサポートが存在するものがあります。これは特に
940     バイナリが別のマシンでビルドされ、壊れた sendfile のあるマシンに
941     移動したときに起こります。</li>
942     <li>Linux では、sendfile を用いると、
943     IPv6 使用時に存在する特定ネットワークカードの TCP-checksum
944     オフロードのバグを踏んでしまいます。</li>
945     <li>Itanium 上の Linux では、sendfile では 2GB 以上の
946     ファイルを扱うことができません。</li>
947     <li>ネットワークマウントされた <code class="directive"><a href="#documentroot">DocumentRoot</a></code>
948     (例えば NFS や SMB)
949     では、カーネルは自身のキャッシュを使ってネットワークからのファイルを
950     送ることができないことがあります。</li>
951     </ul>
952
953     <p>これらの問題に当てはまるサーバの設定の場合は、以下のようにして
954     この機能を使用不可にしてください:</p>
955
956
957     <div class="example"><p><code>
958       EnableSendfile Off
959     </code></p></div>
960
961     <p>NFS や SMB マウントされたファイルには、問題のあるファイルにのみ明示的に
962     この機能を使用不可にします:</p>
963
964     <div class="example"><p><code>
965       &lt;Directory "/path-to-nfs-files"&gt;
966       <span class="indent">
967         EnableSendfile Off
968       </span>
969       &lt;/Directory&gt;
970     </code></p></div>
971
972 </div>
973 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
974 <div class="directive-section"><h2><a name="Error" id="Error">Error</a> <a name="error" id="error">ディレクティブ</a></h2>
975 <table class="directive">
976 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Abort configuration parsing with a custom error message</td></tr>
977 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Error <var>message</var></code></td></tr>
978 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
979 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
980 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
981 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.3.9 and later</td></tr>
982 </table><p>The documentation for this directive has
983             not been translated yet. Please have a look at the English
984             version.</p></div>
985 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
986 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">ディレクティブ</a></h2>
987 <table class="directive">
988 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>エラーが発生したときにサーバがクライアントに送るもの</td></tr>
989 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ErrorDocument <var>error-code document</var></code></td></tr>
990 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
991 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
992 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
993 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
994 </table>
995     <p>問題やエラーが発生したときの動作として、
996     Apache には以下の四つのうち一つの動作を設定することができます。</p>
997
998     <ol>
999       <li>Apache 標準の簡単なエラーメッセージを表示</li>
1000
1001       <li>自分で指定したメッセージを表示</li>
1002
1003       <li>問題やエラーの処理をする為に、自サーバ内の
1004       <var>URL-path</var> へリダイレクト</li>
1005
1006       <li>問題やエラーの処理をする為に、外部の <var>URL</var> へリダイレクト</li>
1007     </ol>
1008
1009     <p>最初のものがデフォルトの動作で、2 番目から 4 番目は、
1010     <code class="directive">ErrorDocument</code>ディレクティブにより、
1011     HTTP のレスポンスコードと、メッセージか URL を指定することで設定します。
1012     Apache が問題もしくはエラーに関する追加情報を提供することがあります。</p>
1013
1014     <p>URL の場合は、スラッシュで始まる (/) ローカルの web-path (
1015     <code class="directive"><a href="#documentroot">DocumentRoot</a></code> からの相対パス
1016     ) か、クライアントが解決できる完全な URL を指定します。
1017     もしくは、ブラウザに表示されるメッセージを指定できます。
1018     例:</p>
1019
1020     <div class="example"><p><code>
1021       ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1022       ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
1023       ErrorDocument 401 /subscription_info.html<br />
1024       ErrorDocument 403 "Sorry can't allow you access today"
1025     </code></p></div>
1026
1027     <p>加えて、特別な値 <code>default</code> を使って Apache に
1028     ハードコードされている簡単なメッセージを指定することができます。
1029     通常は必要ではありませんが、<code>default</code> を使うと
1030     既存の <code class="directive">ErrorDocument</code> ディレクティブの設定を
1031     継承するところで、Apache のハードコードされた簡単なメッセージに
1032     戻すことができます。</p>
1033
1034     <div class="example"><p><code>
1035       ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1036       &lt;Directory /web/docs&gt;<br />
1037       <span class="indent">
1038         ErrorDocument 404 default<br />
1039       </span>
1040       &lt;/Directory&gt;
1041     </code></p></div>
1042
1043     <p>リモート URL (例えば、頭に <code>http</code> と付与した方法) を
1044     <code class="directive">ErrorDocument</code> に指定するとき、
1045     たとえ文書が同じサーバにあろうとも、ドキュメントがどこにあるかを通知するために、
1046     Apache はリダイレクトをクライアントに送出するということに、注意してください。
1047     これにはいろいろと関連して起こる問題があります。
1048     中でも最も重要なのは、クライアントは元々のエラーステータスコードを受け取らず、
1049     代わりにリダイレクトのステータスコードを受け取るということです。
1050     これにより、ステータスコードを使って URL が有効であるかどうかを決定しようとする
1051     ウェブロボットやその他クライアントを、混乱させるかもしれません。
1052     さらに、<code>ErrorDocument 401</code> にリモートの URL を指定すると、
1053     クライアントは 401 というステータスコードを受け取らないため、
1054     パスワードをユーザーに入力要求しなければならないことがわかりません。
1055     従って、<strong><code>ErrorDocument 401</code> というディレクティブを使う場合は、
1056     必ずローカルな文書を参照しなければなりません。</strong></p>
1057
1058     <p>Microsoft Internet Explorer (MSIE) はデフォルトではサーバが生成したエラーメッセージが
1059     「小さすぎる」ときには無視をして自分自身の「やさしい」エラーメッセージで
1060     置換します。サイズのしきい値はエラーの種類によって異なりますが、
1061     一般的にはエラーの文書を 512 バイトよりも大きくすると、MSIE は
1062     サーバが生成したエラーを隠さずに表示します。詳しい情報は Microsoft
1063     Knowledge Base の記事 <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>
1064     にあります。</p>
1065
1066     <p>ほとんどのエラーメッセージを上書きすることができますが、特定の状況下では
1067     <code class="directive"><a href="#errordocument">ErrorDocument</a></code> の設定にかかわらず
1068     内蔵のメッセージが使われます。
1069     特に、不正な形式のリクエストが検出された場合、通常のリクエスト処理は
1070     即座に中止され、内蔵のエラーメッセージが返されます。
1071     この処置は不正なリクエストによって引き起こされる、セキュリティ問題から
1072     守るために必要な措置です。</p>
1073
1074     <p>2.0 より前のバージョンでは、対になっていない二重引用符を
1075     先頭に付けることによりメッセージであることを指定していました。</p>
1076
1077
1078 <h3>参照</h3>
1079 <ul>
1080 <li><a href="../custom-error.html">カスタマイズ可能な
1081 エラー応答のドキュメンテーション</a></li>
1082 </ul>
1083 </div>
1084 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1085 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">ディレクティブ</a></h2>
1086 <table class="directive">
1087 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバがエラーをログ収集する場所</td></tr>
1088 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:<var>facility</var>]</code></td></tr>
1089 <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>
1090 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1091 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1092 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1093 </table>
1094     <p><code class="directive">ErrorLog</code> ディレクティブは、
1095     サーバに生じたさまざまなエラーを
1096     記録する為のファイルの名前を設定します。
1097     <var>file-path</var> が絶対パスでないときは、<code class="directive"><a href="#serverroot">ServerRoot</a></code> からの相対パスとみなされます。</p>
1098
1099     <div class="example"><h3>例</h3><p><code>
1100     ErrorLog /var/log/httpd/error_log
1101     </code></p></div>
1102     
1103     <p><var>file-path</var> がパイプ (|) から始まる場合は、
1104     エラーログを処理するために実行されるコマンドが
1105     指定されていると解釈されます。</p>
1106
1107     <div class="example"><h3>例</h3><p><code>
1108     ErrorLog "|/usr/local/bin/httpd_errors"
1109     </code></p></div>
1110
1111     <p>ファイル名の変わりに <code>syslog</code> と指定することによって、
1112     システムがサポートしていれば syslogd(8) を利用したロギングが有効になります。
1113     デフォルトでは、<code>local7</code> ファシリティとなりますが、
1114     <code>syslog:<var>facility</var></code> といった形で記述することにより、
1115     通常 syslog(1) のドキュメントで説明されているファシリティの一つを使うように
1116     することができます。</p>
1117
1118     <div class="example"><h3>例</h3><p><code>
1119     ErrorLog syslog:user
1120     </code></p></div>
1121
1122     <p>セキュリティ: 
1123     ログファイルを格納するディレクトリが、サーバを起動したユーザ以外の
1124     ユーザによって書き込める場合にセキュリティが破られる可能性があることに
1125     関する詳細は <a href="../misc/security_tips.html#serverroot">セキュリティに関するコツ</a> を
1126     参照してください。</p>
1127     <div class="warning"><h3>注</h3>
1128       <p>Unix 以外のプラットフォームでファイルのパスを入力するときは、
1129       プラットフォームがバックスラッシュの使用を許していたとしても、
1130       確実にスラッシュのみが使用されるように注意してください。一般的には、
1131       設定ファイル全般でスラッシュのみを使う方が良いでしょう。</p>
1132     </div>
1133
1134 <h3>参照</h3>
1135 <ul>
1136 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1137 <li><a href="../logs.html">Apache ログファイル</a></li>
1138 </ul>
1139 </div>
1140 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1141 <div class="directive-section"><h2><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">ディレクティブ</a></h2>
1142 <table class="directive">
1143 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Format specification for error log entries</td></tr>
1144 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr>
1145 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1146 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1147 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1148 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache httpd 2.3.9 and later</td></tr>
1149 </table><p>The documentation for this directive has
1150             not been translated yet. Please have a look at the English
1151             version.</p><h3>参照</h3>
1152 <ul>
1153 <li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
1154 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1155 <li><a href="../logs.html">Apache HTTP Server Log Files</a></li>
1156 </ul>
1157 </div>
1158 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1159 <div class="directive-section"><h2><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">ディレクティブ</a></h2>
1160 <table class="directive">
1161 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Keep track of extended status information for each
1162 request</td></tr>
1163 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
1164 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ExtendedStatus Off[*]</code></td></tr>
1165 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1166 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1167 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1168 </table><p>The documentation for this directive has
1169             not been translated yet. Please have a look at the English
1170             version.</p></div>
1171 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1172 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">ディレクティブ</a></h2>
1173 <table class="directive">
1174 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ETag HTTP 応答ヘッダを作成するために使用される
1175 ファイルの属性</td></tr>
1176 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>FileETag <var>component</var> ...</code></td></tr>
1177 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1178 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1179 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
1180 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1181 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1182 </table>
1183     <p>
1184     <code class="directive">FileETag</code> ディレクティブは
1185     ドキュメントがファイルに基づいたものであるときに、
1186     <code>ETag</code> (エンティティタグ) 応答ヘッダフィールドを作成するときに使用する
1187     ファイルの属性を設定します。 (<code>ETag</code> の値はネットワークの帯域を節約するための
1188     キャッシュの管理で使われます。) Apache 1.3.22 以前では、<code>ETag</code> の値は
1189     <em>常に</em>ファイルの inode, サイズ、最終修正時刻 (mtime) から作成
1190     されていました。<code class="directive">FileETag</code> ディレクティブにより、これらのどれを使うかを
1191     選ぶことができます。認識されるキーワードは:
1192     </p>
1193
1194     <dl>
1195      <dt><strong>INode</strong></dt>
1196      <dd>ファイルの inode 番号を計算に使います</dd>
1197      <dt><strong>MTime</strong></dt>
1198      <dd>ファイルの最終修正時刻を使います</dd>
1199      <dt><strong>Size</strong></dt>
1200      <dd>ファイルの中身のバイト数を使います</dd>
1201      <dt><strong>All</strong></dt>
1202      <dd>使用可能なすべてのフィールドを使います。
1203      これは <div class="example"><p><code>FileETag INode MTime Size</code></p></div> と等価です。</dd>
1204      <dt><strong>None</strong></dt>
1205      <dd>ドキュメントがファイルに基づいたものでも、<code>ETag</code> フィールドを
1206     応答に付加しません</dd>
1207     </dl>
1208
1209     <p><code>INode</code>, <code>MTime</code>, <code>Size</code> キーワードには
1210     <code>+</code> や <code>-</code> を前に付けて
1211     指定することもできます。この場合は、より広い範囲から継承された
1212     デフォルトの設定に変更を加えるようになります。そのような接頭辞の
1213     無いキーワードを指定すると、即座に継承した設定を無効にします。</p>
1214
1215     <p>あるディレクトリの設定に
1216     <code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code> があり、
1217     サブディレクトリの設定に <code>FileETag&nbsp;-INode</code> があるときは、
1218     そのサブディレクトリの設定は (設定が上書きされなければサブディレクトリの
1219     サブディレクトリにも継承されます) <code>FileETag&nbsp;MTime&nbsp;Size</code>
1220     と同じになります。</p>
1221     <div class="warning"><h3>警告</h3>
1222     WebDAV を使っていて、<code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> をストレージプロバイダとして
1223     使っているような Directory や Location では、デフォルト値を変更しないでください。
1224     <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> では、条件付リクエストでの比較演算に
1225     <code>INode&nbsp;MTime&nbsp;Size</code>
1226     の固定フォーマットを使っています。
1227     <code class="directive">FileETag</code> で <code>ETag</code> フォーマットを
1228     変更してしまうと、条件付リクエストでうまく動作しなくなります。
1229     </div>
1230
1231 </div>
1232 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1233 <div class="directive-section"><h2><a name="Files" id="Files">&lt;Files&gt;</a> <a name="files" id="files">ディレクティブ</a></h2>
1234 <table class="directive">
1235 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>マッチするファイル名に適用されるディレクティブを囲む</td></tr>
1236 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;Files <var>filename</var>&gt; ... &lt;/Files&gt;</code></td></tr>
1237 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1238 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1239 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1240 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1241 </table>
1242     <p><code class="directive">&lt;Files&gt;</code> ディレクティブは、
1243     その中にあるディレクティブの適用範囲をファイル名で制限します。
1244     <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> ディレクティブや <code class="directive"><a href="#location">&lt;Location&gt;</a></code> ディレクティブと
1245     同じような機能を持ちます。
1246     これは、<code>&lt;/Files&gt;</code> ディレクティブと対に
1247     なっていなければなりません。
1248     このセクション中のディレクティブは、ベース名 (ファイル名の最後の部分)
1249     が指定されたファイル名にマッチするすべてのオブジェクトに適用されます。
1250     <code class="directive">&lt;Files&gt;</code> セクションは
1251     <code class="directive">&lt;Directory&gt;</code> セクションと
1252     <code>.htaccess</code> が読み込まれた後、
1253     <code class="directive">&lt;Location&gt;</code> セクションよりは先に
1254     設定ファイルに現れた順に適用されます。
1255     <code class="directive">&lt;Files&gt;</code> は、
1256     <code class="directive">&lt;Directory&gt;</code> セクション内に
1257     ネストさせることができ、
1258     ファイルシステムの一部にのみ限定して適用させることができます。</p>
1259
1260     <p><var>filename</var> 引数は、ファイル名かワイルドカード文字列
1261     で、ワイルドカードでは <code>?</code> は一つの文字、<code>*</code> は任意の文字列にマッチします。
1262     <code>~</code> という文字を付加することで<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を使うこともできます。
1263     例えば、</p>
1264
1265     <div class="example"><p><code>
1266       &lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
1267     </code></p></div>
1268
1269     <p>とすることにより、一般的なインターネットの画像フォーマットにマッチします。
1270     ただし、
1271     <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code> を使う方が
1272     推奨されています。</p>
1273
1274     <p>ちなみに、<code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> と <code class="directive"><a href="#location">&lt;Location&gt;</a></code> セクションとは異なり、
1275     <code class="directive">&lt;Files&gt;</code>
1276     は <code>.htaccess</code> ファイル内で利用することができます。
1277     これにより、ユーザがファイル毎にアクセスの制御を行なうことができるように
1278     なっています。</p>
1279
1280
1281 <h3>参照</h3>
1282 <ul>
1283 <li>リクエストを受けた際にこれらの異なるセクションが
1284     組み合わされる方法については <a href="../sections.html">
1285     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
1286 </ul>
1287 </div>
1288 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1289 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a> <a name="filesmatch" id="filesmatch">ディレクティブ</a></h2>
1290 <table class="directive">
1291 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>正規表現にマッチするファイル名に適用される
1292 ディレクティブを囲む</td></tr>
1293 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;FilesMatch <var>regex</var>&gt; ... &lt;/FilesMatch&gt;</code></td></tr>
1294 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1295 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1296 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1297 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1298 </table>
1299     <p><code class="directive">&lt;FilesMatch&gt;</code> ディレクティブは、
1300     <code class="directive"><a href="#files">&lt;Files&gt;</a></code>
1301     ディレクティブ同様にその中にあるディレクティブの適用範囲をファイル名で制限します。ただし、
1302     このディレクティブには<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を指定します。
1303     例えば:</p>
1304
1305     <div class="example"><p><code>
1306       &lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
1307     </code></p></div>
1308
1309     <p>は一般的なインターネットの画像形式にマッチします。</p>
1310
1311 <h3>参照</h3>
1312 <ul>
1313 <li>リクエストを受けた際にこれらの異なるセクションが
1314     組み合わされる方法については <a href="../sections.html">
1315     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
1316 </ul>
1317 </div>
1318 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1319 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">ディレクティブ</a></h2>
1320 <table class="directive">
1321 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>すべてのマッチするファイルが指定の MIME コンテントタイプで
1322 送られるようにする</td></tr>
1323 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ForceType <var>MIME-type</var>|None</code></td></tr>
1324 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ, .htaccess</td></tr>
1325 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
1326 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1327 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1328 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 で core に移動</td></tr>
1329 </table>
1330     <p><code>.htaccess</code> や <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> セクション、
1331     <code class="directive"><a href="#location">&lt;Location&gt;</a></code> セクション、
1332     <code class="directive"><a href="#files">&lt;Files&gt;</a></code> セクションに
1333     書かれた場合、このディレクティブはそこにあるすべてのファイルが
1334     <var>MIME-type</var>
1335     で指定されたコンテントタイプとして扱われるようにします。たとえば、
1336     GIF ファイルばかりのディレクトリがあって、すべてのファイルを <code>.gif</code>
1337     で終わらせたくはないときに、以下のものを使用します:</p>
1338
1339     <div class="example"><p><code>
1340       ForceType image/gif
1341     </code></p></div>
1342
1343     <p><code class="directive"><a href="#defaulttype">DefaultType</a></code> と違って
1344     このディレクティブはメディアタイプを決めることができるかもしれない
1345     ファイルの拡張子も含め、すべての MIME タイプの関連付けを
1346     上書きすることに注意してください。</p>
1347
1348     <p><code>None</code> という値を使うことで <code class="directive">ForceType</code> の
1349     設定を無効にできます:</p>
1350
1351     <div class="example"><p><code>
1352       # force all files to be image/gif:<br />
1353       &lt;Location /images&gt;<br />
1354         <span class="indent">
1355           ForceType image/gif<br />
1356         </span>
1357       &lt;/Location&gt;<br />
1358       <br />
1359       # but normal mime-type associations here:<br />
1360       &lt;Location /images/mixed&gt;<br />
1361       <span class="indent">
1362         ForceType None<br />
1363       </span>
1364       &lt;/Location&gt;
1365     </code></p></div>
1366
1367 </div>
1368 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1369 <div class="directive-section"><h2><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">ディレクティブ</a></h2>
1370 <table class="directive">
1371 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Directory to write gmon.out profiling data to.  </td></tr>
1372 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr>
1373 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1374 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1375 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1376 </table><p>The documentation for this directive has
1377             not been translated yet. Please have a look at the English
1378             version.</p></div>
1379 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1380 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">ディレクティブ</a></h2>
1381 <table class="directive">
1382 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントの IP アドレスの DNS ルックアップを
1383 有効にする</td></tr>
1384 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1385 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>HostnameLookups Off</code></td></tr>
1386 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
1387 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1388 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1389 </table>
1390     <p>このディレクティブは、ホスト名をログ収集できるように
1391     DNS ルックアップを有効にします
1392     (さらに、CGI/SSI に <code>REMOTE_HOST</code> 変数として渡します)。
1393     <code>Double</code>を指定した場合、2 重の逆引きを行ないます。
1394     つまり、逆引きの後に、その結果に対して正引きを行ないます。正引きの
1395     結果の IP アドレスの中にオリジナルのアドレスと一致するものがなければ
1396     なりません。("tcpwrappers" の用語では <code>PARANOID</code> と呼ばれています。)</p>
1397
1398     <p><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> でホスト名によるアクセス
1399     制御を行なう場合には、
1400     設定の如何によらず 2 重の逆引きが実行されます。
1401     これは、セキュリティを保つために必要です。
1402     <code>HostnameLookups Double</code> を設定しない限り、
1403     他の部分はこの 2 重逆引きの結果を使うことはできません。
1404     例えば、<code>HostnameLookups On</code> と設定してある状態で、
1405     ホスト名によるアクセス制限を行なったオブジェクトへの
1406     リクエストを受けたとすると、2 重の逆引きが成功するか否かによらず、
1407     <code>REMOTE_HOST</code> には通常の逆引き結果が渡されます。</p>
1408
1409     <p>ディレクティブのデフォルトは
1410     本当に逆引きを必要としているわけではないサイトの
1411     ネットワークトラフィックを低減させるために、<code>Off</code> になっています。
1412     ルックアップによる余計な遅延がなくなるため、
1413     エンドユーザにとっても良いでしょう。
1414     DNS のルックアップには、かなりの時間が必要となる場合が多く、
1415     負荷の高いサイトではこのディレクティブは <code>Off</code> にすべきです。
1416     なお、<var>/support</var> ディレクトリに含まれ、デフォルトでは
1417     インストールディレクトリの <code>bin</code> サブディレクトリに
1418     インストールされる <code class="program"><a href="../programs/logresolve.html">logresolve</a></code> ユーティリティにより、
1419     Apache の動作とは別に、ログに残されている IP アドレスからホスト名を
1420     ルックアップすることが可能です。</p>
1421
1422 </div>
1423 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1424 <div class="directive-section"><h2><a name="If" id="If">&lt;If&gt;</a> <a name="if" id="if">ディレクティブ</a></h2>
1425 <table class="directive">
1426 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>実行時、リクエストが条件を満たした場合にのみ適用される
1427 ディレクティブを包含する</td></tr>
1428 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;If <var>expression</var>&gt; ... &lt;/If&gt;</code></td></tr>
1429 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1430 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1431 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1432 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1433 </table>
1434     <p><code class="directive">&lt;If&gt;</code> ディレクティブは
1435     実行時に式を評価し、条件式が真になるときにのみ
1436     内包するディレクティブを適用します。
1437     例えば</p>
1438
1439     <div class="example"><p><code>
1440         &lt;If "$req{Host} = ''"&gt;
1441     </code></p></div>
1442
1443     <p>上記例は <var>Host:</var> ヘッダの存在しない HTTP/1.0 のリクエストに
1444     マッチします。</p>
1445
1446 <h3>参照</h3>
1447 <ul>
1448 <li><a href="../sections.html">どのように &lt;Directory&gt;, &lt;Location&gt;,
1449     &lt;Files&gt; セクションが動作するか</a> では、リクエストを受けたときに、
1450     これらの異なるセクションがどのように組み合わさるかについて記載されています。
1451     <code class="directive">&lt;If&gt;</code> は
1452     <code class="directive">&lt;Files&gt;</code>
1453     と同じ処理順と用法になっています。</li>
1454 </ul>
1455 </div>
1456 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1457 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine">&lt;IfDefine&gt;</a> <a name="ifdefine" id="ifdefine">ディレクティブ</a></h2>
1458 <table class="directive">
1459 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>起動時にテストが真であるときのみに処理されるディレクティブを
1460 囲む</td></tr>
1461 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;IfDefine [!]<var>parameter-name</var>&gt; ...
1462     &lt;/IfDefine&gt;</code></td></tr>
1463 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1464 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1465 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1466 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1467 </table>
1468     <p><code>&lt;IfDefine <var>test</var>&gt;...&lt;/IfDefine&gt;</code>
1469     セクションは、
1470     ディレクティブを条件付きで指定するために利用します。
1471     <code class="directive">&lt;IfDefine&gt;</code> セクションに
1472     含まれるディレクティブは、<var>test</var>が
1473     定義されているときのみ処理されます。
1474     もし <var>test</var> が定義されていなければ、
1475     開始と終了の指定の間のディレクティブは無視されます。</p>
1476
1477     <p><code class="directive">&lt;IfDefine&gt;</code> セクションディレクティブに
1478     指定する <var>test</var> は、
1479     次の二つの形式のうちの一つをとります:</p>
1480
1481     <ul>
1482       <li><var>parameter-name</var></li>
1483
1484       <li><code>!</code><var>parameter-name</var></li>
1485     </ul>
1486
1487     <p>前者の場合には、<var>parameter-name</var> と名付けられたパラメータが
1488     定義されていれば開始と終了の間のディレクティブが処理されます。
1489     後者の場合は逆で、<em>parameter-name</em> が指定されて<strong>いない</strong>
1490     場合に処理されます。</p>
1491
1492     <p><var>parameter-name</var> 引数は、サーバを起動する際に
1493     <code class="program"><a href="../programs/httpd.html">httpd</a></code> のコマンドラインに
1494     <code>-D<var>parameter</var></code> という形で指定するか
1495     あるいは <code class="directive"><a href="#define">Define</a></code>
1496     ディレクティブで指定されると定義されます。 </p>
1497
1498     <p><code class="directive">&lt;IfDefine&gt;</code> セクションは
1499     入れ子にすることができ、複数のパラメータによるテストをするために使用できます。
1500     例:</p>
1501
1502     <div class="example"><p><code>
1503       httpd -DReverseProxy -DUseCache -DMemCache ...<br />
1504       <br />
1505       # httpd.conf<br />
1506       &lt;IfDefine ReverseProxy&gt;<br />
1507       <span class="indent">
1508         LoadModule proxy_module   modules/mod_proxy.so<br />
1509         LoadModule proxy_http_module   modules/mod_proxy_http.so<br />
1510         &lt;IfDefine UseCache&gt;<br />
1511         <span class="indent">
1512           LoadModule cache_module   modules/mod_cache.so<br />
1513           &lt;IfDefine MemCache&gt;<br />
1514           <span class="indent">
1515             LoadModule mem_cache_module   modules/mod_mem_cache.so<br />
1516       </span>
1517           &lt;/IfDefine&gt;<br />
1518           &lt;IfDefine !MemCache&gt;<br />
1519           <span class="indent">
1520             LoadModule cache_disk_module   modules/mod_cache_disk.so<br />
1521           </span>
1522       &lt;/IfDefine&gt;
1523         </span>
1524         &lt;/IfDefine&gt;
1525       </span>
1526       &lt;/IfDefine&gt;
1527     </code></p></div>
1528
1529 </div>
1530 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1531 <div class="directive-section"><h2><a name="IfModule" id="IfModule">&lt;IfModule&gt;</a> <a name="ifmodule" id="ifmodule">ディレクティブ</a></h2>
1532 <table class="directive">
1533 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>モジュールの存在するかしないかに応じて処理される
1534 ディレクティブを囲む</td></tr>
1535 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;IfModule [!]<var>module-file</var>|<var>module-identifier</var>&gt; ...
1536     &lt;/IfModule&gt;</code></td></tr>
1537 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1538 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1539 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1540 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1541 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>モジュール識別子はバージョン 2.1 以降で使用可能。</td></tr>
1542 </table>
1543     <p><code>&lt;IfModule <var>test</var>&gt;...&lt;/IfModule&gt;</code>
1544     セクションは、モジュールが存在するときに処理されるディレクティブを
1545     指定するために利用します。
1546     <code class="directive">&lt;IfModule&gt;</code> セクションに
1547     含まれるディレクティブは、<var>test</var>
1548     で指定するモジュールが組み込まれているときのみ処理されます。
1549     もし <var>test</var> が組み込まれていなければ、開始と終了の間のディレクティブ
1550     は無視されます。</p>
1551
1552     <p><code class="directive">&lt;IfModule&gt;</code> セクションディレクティブに
1553     指定する <var>test</var> は、
1554     次の二つの形式のうちの一つをとります。</p>
1555
1556     <ul>
1557       <li><var>module</var></li>
1558
1559       <li>!<var>module</var></li>
1560     </ul>
1561
1562     <p>前者の場合は、<var>module</var> と名付けられたモジュールが
1563     Apache に組み込まれていれば
1564     (コンパイル済みのものと、<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> を利用して
1565     動的に読み込んだものの両方)、
1566     開始と終了の間のディレクティブが処理されます。
1567     後者の場合は逆で、<var>module</var> が組み込まれて<strong>いない</strong>
1568     場合に処理されます。</p>
1569
1570     <p><var>module</var> 引数は、モジュール識別子か
1571     コンパイルをした時のモジュールのファイル名です。
1572     例えば、<code>rewrite_module</code> は識別子で
1573     <code>mod_rewrite.c</code> はファイル名です。
1574     モジュールが複数のソースファイルから構成されている場合は、文字列
1575     <code>STANDARD20_MODULE_STUFF</code> があるファイルの名前を
1576     使ってください。</p>
1577
1578     <p><code class="directive">&lt;IfModule&gt;</code> セクションは
1579     入れ子にすることが可能であり、
1580     複数のモジュールのテストを行なうために使用できます。</p>
1581
1582     <div class="note">特定のモジュールの存在に関わらず動作する
1583     設定ファイルの原本が必要なときにのみこのセクションを使用してください。
1584     通常の動作では、ディレクティブを
1585     <code class="directive">&lt;IfModule&gt;</code> セクションの中に
1586     入れる必要はありません。</div>
1587
1588 </div>
1589 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1590 <div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">ディレクティブ</a></h2>
1591 <table class="directive">
1592 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバ設定ファイル中から他の設定ファイルを取り込む</td></tr>
1593 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Include <var>file-path</var>|<var>directory-path</var></code></td></tr>
1594 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
1595 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1596 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1597 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>ワイルドカードによるマッチは 2.0.41 以降で使用可能</td></tr>
1598 </table>
1599     <p>このディレクティブにより、サーバの設定ファイルから
1600     他の設定ファイルをインクルードすることができます。</p>
1601
1602     <p>複数のファイルをアルファベット順に一度に読み込むために、
1603     シェル形式 (<code>fnmatch</code>) のワイルドカード文字を使うことができます。
1604     さらに、<code class="directive">Include</code> にディレクトリを指定した場合は、
1605     ディレクトリとそのサブディレクトリ内の全てのファイルを
1606     アルファベット順に読み込んで、設定ファイルとして処理します。
1607     しかし、ディレクトリ全体を読み込むのはお勧めできません。
1608     ふとしたことから <code>httpd</code> が読み込みに失敗するような
1609     一時ファイルをディレクトリに残してしまうようなことがよくあるからです。</p>
1610
1611     <p>指定するファイルパスは絶対パスか、
1612     <code class="directive"><a href="#serverroot">ServerRoot</a></code> ディレクトリからの
1613     相対パスか、のどちらかです。</p>
1614
1615     <p>例:</p>
1616
1617     <div class="example"><p><code>
1618       Include /usr/local/apache2/conf/ssl.conf<br />
1619       Include /usr/local/apache2/conf/vhosts/*.conf
1620     </code></p></div>
1621
1622      <p><code class="directive"><a href="#serverroot">ServerRoot</a></code> からの相対パスの場合は:</p>
1623
1624     <div class="example"><p><code>
1625       Include conf/ssl.conf<br />
1626       Include conf/vhosts/*.conf
1627     </code></p></div>
1628
1629 <h3>参照</h3>
1630 <ul>
1631 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1632 </ul>
1633 </div>
1634 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1635 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">ディレクティブ</a></h2>
1636 <table class="directive">
1637 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>HTTP の持続的な接続を有効にする</td></tr>
1638 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1639 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>KeepAlive On</code></td></tr>
1640 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1641 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1642 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1643 </table>
1644     <p>HTTP/1.0 の Keep-Alive 拡張と HTTP/1.1 の持続的接続の機能は、
1645     複数のリクエストが同じ TCP の接続で送られる、長時間持続する
1646     HTTP セッションを提供します。たくさんの画像が
1647     含まれる HTML ドキュメントでは場合によっては遅延時間が 50% 短縮される結果も
1648     でています。Keep-Alive 接続を有効にするには
1649     <code>KeepAlive On</code> と設定します。</p>
1650
1651     <p>HTTP/1.0 に対応したクライアントの際には、
1652     クライアントより特に要求があった場合のみ Keep-Alive 接続となります。
1653     さらに、HTTP/1.0 クライアントでは、コンテンツの容量が先に
1654     (訳注: 要求に対して応答を返す前に) わかる場合のみ Keep-Alive
1655     接続を利用できます。
1656     これは、CGI の出力や SSI のページ、
1657     サーバが生成したディレクトリのリストのような動的コンテンツを
1658     HTTP/1.0 クライアントに送る場合には Keep-Alive 接続を使えないことを意味します。
1659     HTTP/1.1 に対応したクライアントの際には、
1660     特に指定されない限りはデフォルトとして持続的な接続が行なわれます。
1661     クライアントが要求すれば、コンテンツの容量を判別できないものを
1662     持続的な接続を通して送るために、チャンクエンコーディングが用いられます。</p>
1663
1664     <p>クライアントが Keep-Alive コネクションを使用している場合、
1665     そのコネクションを通してどれだけたくさんのリクエストが処理されても、
1666     それは「リクエスト」1 つとして、MaxRequestsPerChild ディレクティブでは
1667     数えられます。</p>
1668
1669 <h3>参照</h3>
1670 <ul>
1671 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1672 </ul>
1673 </div>
1674 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1675 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">ディレクティブ</a></h2>
1676 <table class="directive">
1677 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>持続的な接続で次のリクエストが来るまでサーバが待つ時間</td></tr>
1678 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>KeepAliveTimeout <var>seconds</var></code></td></tr>
1679 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
1680 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1681 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1682 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1683 </table>
1684     <p>接続を閉じる前に、Apache が次のリクエストを何秒待つかを指定します。
1685     リクエストを受け付けた後は、<code class="directive"><a href="#timeout">Timeout</a></code> ディレクティブによって
1686     指定されたタイムアウト値が使われます。</p>
1687
1688     <p><code class="directive">KeepAliveTimeout</code> を大きな値に設定すると、
1689     負荷の高いサーバにおいてはパフォーマンスの問題を引き起こす場合があります。
1690     タイムアウトが長ければ長いほど、より多くのサーバプロセスが
1691     活性でないクライアントからの接続の終了を待ち続けることになります。</p>
1692     
1693     <p>名前ベースのバーチャルホストコンテキストでは、
1694     <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code>
1695     のセットの中で最初に定義されたバーチャルホストの値
1696     (デフォルトホスト) が使われます。
1697     その他の値は無視されます。</p>
1698
1699 </div>
1700 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1701 <div class="directive-section"><h2><a name="Limit" id="Limit">&lt;Limit&gt;</a> <a name="limit" id="limit">ディレクティブ</a></h2>
1702 <table class="directive">
1703 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>囲いの中にあるアクセス制御の適用を特定の HTTP メソッドのみに
1704 制限する</td></tr>
1705 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;Limit <var>method</var> [<var>method</var>] ... &gt; ...
1706     &lt;/Limit&gt;</code></td></tr>
1707 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1708 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1709 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1710 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1711 </table>
1712     <p>アクセス制御は、通常<strong>全ての</strong>アクセスメソッドに対して
1713     影響し、普通はこれが望ましい挙動です。
1714     <strong>そうしたことから、大部分の場合にはアクセス制御に関わるディレクティブを
1715     <code class="directive">&lt;Limit&gt;</code> セクション内に
1716     書くべきではありません。 </strong></p>
1717
1718     <p><code class="directive">&lt;Limit&gt;</code> ディレクティブの
1719     目的は、アクセス制御の範囲を
1720     指定された HTTP メソッドに限定するためです。
1721     それ以外のメソッドは、<code class="directive">&lt;Limit&gt;</code> で囲われたアクセス制御の
1722     <strong>影響を受けません</strong>。
1723     以下の例は、<code>POST</code>, <code>PUT</code>, <code>DELETE</code> のメソッドに対してのみアクセスの制御を行ない、
1724     それ以外のメソッドについては制限しません:</p>
1725
1726     <div class="example"><p><code>
1727       &lt;Limit POST PUT DELETE&gt;<br />
1728       <span class="indent">
1729         Require valid-user<br />
1730       </span>
1731       &lt;/Limit&gt;
1732     </code></p></div>
1733
1734     <p>メソッド名には以下の中から一つ以上を列挙することができます:
1735     <code>GET</code>,
1736     <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1737     <code>CONNECT</code>, <code>OPTIONS</code>,
1738     <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1739     <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1740     <code>LOCK</code>, <code>UNLOCK</code>. <strong>メソッド名は
1741     大文字小文字を区別します。</strong> <code>GET</code> を指定した場合には
1742     <code>HEAD</code> リクエストにも制限がかかります。<code>TRACE</code>
1743     メソッドに制限をかけることはできません
1744     (<code class="directive"><a href="#traceenable">&lt;TraceEnable&gt;</a></code> 参照)。</p>
1745
1746     <div class="warning">アクセス制御が目的の場合は
1747     <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> 
1748     セクションの代わりに <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> セクションを使用した方が良いでしょう。
1749     <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>
1750     セクションでは不特定のメソッドに対しても防御できるからです。</div>
1751
1752
1753 </div>
1754 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1755 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept">&lt;LimitExcept&gt;</a> <a name="limitexcept" id="limitexcept">ディレクティブ</a></h2>
1756 <table class="directive">
1757 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>指定されたもの以外の HTTP メソッドにアクセス制御を
1758 制限する</td></tr>
1759 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;LimitExcept <var>method</var> [<var>method</var>] ... &gt; ...
1760     &lt;/LimitExcept&gt;</code></td></tr>
1761 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1762 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1763 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1764 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1765 </table>
1766     <p><code class="directive">&lt;LimitExcept&gt;</code> と
1767     <code>&lt;/LimitExcept&gt;</code> は、引数に
1768     <strong>含まれていない</strong>
1769     HTTP のアクセスメソッドに適用するためのアクセス制御
1770     ディレクティブを括るために利用します。
1771     つまり、<code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> セクションの反対の動作をし、
1772     標準のメソッドと標準外や未認識のメソッドの場合の両方を設定できます。
1773     <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> のドキュメントも
1774     併せて参照してください。</p>
1775
1776     <p>例:</p>
1777
1778     <div class="example"><p><code>
1779       &lt;LimitExcept POST GET&gt;<br />
1780       <span class="indent">
1781         Require valid-user<br />
1782       </span>
1783       &lt;/LimitExcept&gt;
1784     </code></p></div>
1785
1786
1787 </div>
1788 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1789 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">ディレクティブ</a></h2>
1790 <table class="directive">
1791 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>内部リダイレクトと入れ子になったサブリクエストの最大数を決定する</td></tr>
1792 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitInternalRecursion <var>number</var> [<var>number</var>]</code></td></tr>
1793 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1794 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1795 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1796 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1797 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.47 以降で使用可能</td></tr>
1798 </table>
1799     <p>内部リダイレクトは例えば <code class="directive">Action</code> ディレクティブを
1800     使っているときに起こります。<code class="directive">Action</code> ディレクティブは
1801     元々のリクエストを CGI スクリプトに内部リダイレクトを行ないます。
1802     サブリクエストはいくつかの URI に対して、リクエストされたときに
1803     何が起こるかを調べるための Apache の機構です。例えば、<code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>
1804     は <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> ディレクティブ
1805     がリストするファイルを調べるためにサブリクエストを使います。</p>
1806
1807     <p><code class="directive">LimitInternalRecursion</code> は内部リダイレクトや
1808     サブリクエストが無限ループに陥ったときのサーバクラッシュを防ぎます。
1809     普通、そのようなループは設定に失敗したときに発生します。</p>
1810
1811     <p>このディレクティブは、リクエスト毎に評価される、二つの違う限界値を
1812     設定します。最初の <var>number</var> は、起こり得る
1813     内部リクエストの最大値を設定します。二つめの <var>number</var> は
1814     サブリクエストが入れ子にできる深さを設定します。<var>number</var> を
1815     一つだけ指定したときは、両方の限界値にその値が設定されます。</p>
1816
1817     <div class="example"><h3>例</h3><p><code>
1818       LimitInternalRecursion 5
1819     </code></p></div>
1820
1821 </div>
1822 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1823 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">ディレクティブ</a></h2>
1824 <table class="directive">
1825 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントから送られる HTTP リクエストのボディの
1826 総量を制限する</td></tr>
1827 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestBody <var>bytes</var></code></td></tr>
1828 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1829 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1830 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1831 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1832 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1833 </table>
1834     <p>このディレクティブは、リクエストボディに許されるバイト数、<var>bytes</var>
1835     を 0 (無制限を意味します) から 2147483647 (2GB) までの数値で指定します。</p>
1836
1837     <p><code class="directive">LimitRequestBody</code> ディレクティブは、
1838     ディレクティブが書かれたコンテキスト
1839     (サーバ全体、ディレクトリ、ファイル、ロケーション) 内で
1840     許容する  HTTP リクエストメッセージボディのサイズに制限をかけることができます。
1841     クライアントのリクエストがその制限値を越えていれば、
1842     サーバはリクエストを処理せずにエラーを返します。
1843     普通のリクエストメッセージボディのサイズは、リソースの種類や
1844     許可されているメソッドによって大きく変わります。
1845     CGI スクリプトは、よく情報を受信するために
1846     メッセージボディを使います。
1847     <code>PUT</code> メソッドの実装は、このディレクティブの値として
1848     少なくともあるリソースに対してサーバが受け付けようとする
1849     表現の大きさほどの値を必要とします。</p>
1850
1851     <p>このディレクティブは、
1852     管理者にクライアントからの異常なリクエストを制御できるようにし、
1853     何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
1854
1855     <p>ある場所へのファイルアップロードを許可する場合に、
1856     アップロードできるファイルのサイズを 100K に制限したければ、
1857     以下のように指定します:</p>
1858
1859     <div class="example"><p><code>
1860       LimitRequestBody 102400
1861     </code></p></div>
1862
1863
1864 </div>
1865 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1866 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">ディレクティブ</a></h2>
1867 <table class="directive">
1868 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントからの HTTP リクエストのヘッダフィールドの数を
1869 制限する</td></tr>
1870 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestFields <var>number</var></code></td></tr>
1871 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1872 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1873 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1874 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1875 </table>
1876     <p><var>number</var> には、0 (無制限を意味します) から 32767
1877     までの整数を指定します。
1878     デフォルト値は、定数 <code>DEFAULT_LIMIT_REQUEST_FIELDS</code>
1879     によりコンパイル時に定義されます (配布時には 100 と指定されています)。</p>
1880
1881     <p><code class="directive">LimitRequestBody</code> ディレクティブは、
1882     サーバ管理者が HTTP リクエスト中において許可するリクエストヘッダフィールド数を
1883     指定します。
1884     サーバはこの値には通常のクライアントからのリクエストに含まれるであろう
1885     フィールドの数より大きな値が必要とします。
1886     クライアントにより使われた要求ヘッダーフィールドの数が
1887     20 を超えることはほとんどありませんが、
1888     これは種々のクライアントの実装によって変わり、
1889     詳細なコンテントネゴシエーションをするためのブラウザの設定までにも
1890     影響されることがあります。
1891     オプションの HTTP 拡張はリクエストヘッダフィールドを使って表される場合が
1892     多くあります。</p>
1893
1894     <p>このディレクティブは、
1895     管理者にクライアントからの異常なリクエストを制御できるようにし、
1896     何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。
1897     リクエストのフィールドが多過ぎることを意味するエラー応答が
1898     普通のクライアントに返されるような時はこの値を増やしてください。</p>
1899
1900     <p>例:</p>
1901
1902     <div class="example"><p><code>
1903       LimitRequestFields 50
1904     </code></p></div>
1905
1906
1907 </div>
1908 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1909 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">ディレクティブ</a></h2>
1910 <table class="directive">
1911 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントからの HTTP リクエストのヘッダの
1912 サイズを制限する</td></tr>
1913 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestFieldSize <var>bytes</var></code></td></tr>
1914 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
1915 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1916 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1917 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1918 </table>
1919     <p>このディレクティブは、HTTP リクエストヘッダ一つで受付ける
1920     バイト数 <var>bytes</var> を指定します。</p>
1921
1922     <p><code class="directive">LimitRequestFieldSize</code> ディレクティブは、
1923     HTTP リクエストヘッダで許容されるサイズを増減させることができます。
1924     サーバは、このディレクティブの値として、
1925     一般的なクライアントからリクエストが送られた際に、そのリクエストに
1926     付属しているどのヘッダフィールドについても、
1927     十分足りる大きさになっていなければなりません。
1928     一般的なリクエストヘッダのサイズといっても、その大きさは個々の
1929     クライアントの実装によって大きく異なり、
1930     詳細なコンテントネゴシエーションをサポートするかどうかの、
1931     ブラウザの設定にも影響されたりします。
1932     SPNEGO 認証ヘッダでは 12392 バイトにまで及ぶことすらあります。</p>
1933
1934     <p>このディレクティブは、
1935     管理者にクライアントからの異常なリクエストを制御できるようにし、
1936     何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
1937
1938     <p>例:</p>
1939
1940     <div class="example"><p><code>
1941       LimitRequestFieldSize 4094
1942     </code></p></div>
1943
1944     <div class="note">通常はデフォルトから変更する必要はありません。</div>
1945
1946
1947 </div>
1948 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1949 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">ディレクティブ</a></h2>
1950 <table class="directive">
1951 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントからの HTTP リクエスト行のサイズを制限する</td></tr>
1952 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitRequestLine <var>bytes</var></code></td></tr>
1953 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
1954 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
1955 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1956 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1957 </table>
1958     <p>このディレクティブは、HTTP リクエスト行内で許容されるバイト数
1959     <var>bytes</var> を指定します。</p>
1960
1961     <p><code class="directive">LimitRequestLine</code> ディレクティブにより、
1962     クライアントからの HTTP リクエスト行の許容サイズを増減できます。 
1963     リクエスト行は、HTTPメソッド、URI、プロトコルバージョンから成っており、
1964     <code class="directive">LimitRequestLine</code> はサーバへのリクエストに対して
1965     許容するリクエスト URI の長さを制限することになります。
1966     サーバは、<code>GET</code> リクエストのクエリ部分も含めて、リソースの名前が入るに足る
1967     大きさを必要とします。</p>
1968
1969     <p>このディレクティブは、
1970     管理者にクライアントからの異常なリクエストを制御できるようにし、
1971     何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。</p>
1972
1973     <p>例:</p>
1974
1975     <div class="example"><p><code>
1976       LimitRequestLine 4094
1977     </code></p></div>
1978
1979     <div class="note">通常はデフォルトから変更する必要はありません。</div>
1980
1981 </div>
1982 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1983 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">ディレクティブ</a></h2>
1984 <table class="directive">
1985 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>XML 形式のリクエストのボディのサイズを制限する</td></tr>
1986 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LimitXMLRequestBody <var>bytes</var></code></td></tr>
1987 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
1988 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
1989 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
1990 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
1991 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
1992 </table>
1993     <p>XML 形式のリクエストのボディの最大値を (バイト単位で) 制限します。
1994     値に <code>0</code> を指定するとチェックを無効にします。</p>
1995
1996     <p>例:</p>
1997
1998     <div class="example"><p><code>
1999     LimitXMLRequestBody 0
2000     </code></p></div>
2001
2002
2003 </div>
2004 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2005 <div class="directive-section"><h2><a name="Location" id="Location">&lt;Location&gt;</a> <a name="location" id="location">ディレクティブ</a></h2>
2006 <table class="directive">
2007 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>囲んだディレクティブをマッチする URL のみに適用</td></tr>
2008 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;Location
2009     <var>URL-path</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</code></td></tr>
2010 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2011 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2012 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2013 </table>
2014     <p><code class="directive">&lt;Location&gt;</code> ディレクティブは、
2015     URL により中に書かれたディレクティブの適用範囲を制限します。
2016     <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
2017     ディレクティブと似ていて、
2018     <code>&lt;/Location&gt;</code> ディレクティブで終了する
2019     サブセクションを開始します。
2020     <code class="directive">&lt;Location&gt;</code> セクションは、
2021     <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> セクションと
2022     <code>.htaccess</code> の読み込みの後、
2023     <code class="directive"><a href="#files">&lt;Files&gt;</a></code> セクションを
2024     適用した後に、設定ファイルに現れた順に処理されます。</p>
2025
2026     <p><code class="directive">&lt;Location&gt;</code> セクションは
2027     完全にファイルシステムと関連せずに動作します。このことから導かれる
2028     結果にはいくつか注意する点があります。最も重要なものは、
2029     ファイルシステムの位置へのアクセス制御に <code class="directive">&lt;Location&gt;</code> ディレクティブを使うべきではない
2030     ということです。複数の URL がファイルシステムの同じ位置にマップされる
2031     可能がありますので、そのようなアクセス制御は回避されてしまう可能性が
2032     あります。</p>
2033
2034     <div class="note"><h3>いつ <code class="directive">&lt;Location&gt;</code> を使うか</h3>
2035
2036     <p><code class="directive">&lt;Location&gt;</code> ディレクティブは
2037     ファイルシステム外のコンテンツにディレクティブを適用するときに
2038     使用してください。ファイルシステムに存在するコンテンツに対しては、
2039     <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> と <code class="directive"><a href="#files">&lt;Files&gt;</a></code> を使ってください。
2040     例外は、<code>&lt;Location /&gt;</code> で、これはサーバ全体に対して
2041     設定を適用する簡単な方法です。</p>
2042     </div>
2043
2044     <p>全ての (プロキシ以外の) リクエストに対し、
2045     URL は <code>/path/</code> という、
2046     接頭辞 <code>http://servername</code> を含まない形でマッチします。
2047     プロキシリクエストの場合には、<code>scheme://servername/path</code>
2048     という接頭辞を含む形でマッチし、接頭辞を含めて指定する必要があります。</p>
2049
2050     <p>URL にはワイルドカードを利用することができます。
2051     <code>?</code> は任意の一文字、<code>*</code> は任意の文字列にマッチします。
2052     どちらのワイルドカードも URL パス中の / にはマッチしません。</p>
2053
2054     <p><code>~</code> という文字を追加することで、<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>を
2055     利用することもできます。
2056     例えば:</p>
2057
2058     <div class="example"><p><code>
2059       &lt;Location ~ "/(extra|special)/data"&gt;
2060     </code></p></div>
2061
2062     <p>は URL に <code>/extra/data</code> か <code>/special/data</code> という文字列が
2063     含まれている場合にマッチします。
2064    <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> ディレクティブは
2065     <code class="directive">&lt;Location&gt;</code> の正規表現
2066     版とまったく同じ動作をします。</p>
2067
2068     <p><code class="directive">&lt;Location&gt;</code> 機能は、<code class="directive"><a href="#sethandler">SetHandler</a></code> ディレクティブと
2069     組合わせて利用すると特に便利です。
2070     例えば、<code>example.com</code> のブラウザからのみステータスの参照を有効にしたければ、
2071     次のようにすれば良いでしょう。</p>
2072
2073     <div class="example"><p><code>
2074       &lt;Location /status&gt;<br />
2075       <span class="indent">
2076         SetHandler server-status<br />
2077         Order Deny,Allow<br />
2078         Deny from all<br />
2079         Allow from .example.com<br />
2080       </span>
2081       &lt;/Location&gt;
2082     </code></p></div>
2083
2084 <div class="note"><h3>/ (スラッシュ) に関する注</h3>
2085     <p>スラッシュ文字は、URL 内に現れる場所に応じて変化する
2086     特別な意味を持っています。
2087     ファイルシステムにおいて利用する場合には複数のスラッシュでも一つの
2088     スラッシュとして扱われることが多いですが、
2089     (<em>すなわち</em>、<code>/home///foo</code> は
2090     <code>/home/foo</code> と同じといったように)
2091     URL においては必ずしもそうなるわけではありません。
2092     <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code>
2093     ディレクティブや正規表現を利用した
2094     <code class="directive">&lt;Location&gt;</code> ディレクティブで、
2095     複数のスラッシュにマッチさせたいときには、明示的に記述する
2096     必要があります。</p>
2097
2098     <p>例えば、<code>&lt;LocationMatch ^/abc&gt;</code> は、
2099     <code>/abc</code> というリクエスト URL にマッチしますが、
2100     <code>//abc</code> というリクエスト URL にはマッチしません。
2101     (正規表現でない) <code class="directive">&lt;Location&gt;</code>
2102     ディレクティブは、
2103     proxy リクエストに対して利用する際には同様の振る舞いをしますが、
2104     (正規表現でない) <code class="directive">&lt;Location&gt;</code> を proxy
2105     でないリクエストに対して利用する際には、
2106     一つのスラッシュで複数のスラッシュにマッチします。
2107     例えば、<code>&lt;Location /abc/def&gt;</code> と指定し、
2108     <code>/abc//def</code> というリクエストがあれば、
2109     マッチすることになります。</p></div>
2110
2111
2112 <h3>参照</h3>
2113 <ul>
2114 <li>リクエストを受けた際にこれらの異なるセクションが
2115     組み合わされる方法については <a href="../sections.html">
2116     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
2117 </ul>
2118 </div>
2119 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2120 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch">&lt;LocationMatch&gt;</a> <a name="locationmatch" id="locationmatch">ディレクティブ</a></h2>
2121 <table class="directive">
2122 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>囲んだディレクティブを正規表現にマッチする URL のみに
2123 適用</td></tr>
2124 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;LocationMatch
2125     <var>regex</var>&gt; ... &lt;/LocationMatch&gt;</code></td></tr>
2126 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2127 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2128 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2129 </table>
2130     <p><code class="directive">&lt;LocationMatch&gt;</code> ディレクティブは、
2131     <code class="directive"><a href="#location">&lt;Location&gt;</a></code> と同じ様に
2132     URL により中に書かれたディレクティブの適用範囲を制限します。
2133     但し、引数は普通の文字列ではなく、<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>となります。
2134     例えば、</p>
2135
2136     <div class="example"><p><code>
2137       &lt;LocationMatch "/(extra|special)/data"&gt;
2138     </code></p></div>
2139
2140     <p>は URL に <code>/extra/data</code> か <code>/special/data</code>
2141     という文字列が含まれている場合にマッチします。</p>
2142
2143 <h3>参照</h3>
2144 <ul>
2145 <li>リクエストを受けた際にこれらの異なるセクションが
2146     組み合わされる方法については <a href="../sections.html">
2147     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
2148 </ul>
2149 </div>
2150 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2151 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">ディレクティブ</a></h2>
2152 <table class="directive">
2153 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ErrorLog の冗長性を制御する</td></tr>
2154 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LogLevel <var>level</var></code></td></tr>
2155 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LogLevel warn</code></td></tr>
2156 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2157 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2158 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2159 </table>
2160     <p><code class="directive">LogLevel</code> は、エラーログ (<code class="directive"><a href="#errorlog">ErrorLog</a></code> ディレクティブを
2161     見てください) へ記録するメッセージの冗長性を調整します。
2162     以下の <var>level</var> を指定でき、順に重要度が下がっていきます。</p>
2163
2164     <table class="bordered">
2165       <tr>
2166         <th><strong>レベル</strong> </th>
2167
2168         <th><strong>説明</strong> </th>
2169
2170         <th><strong>例</strong> </th>
2171       </tr>
2172
2173       <tr>
2174         <td><code>emerg</code> </td>
2175
2176         <td>緊急 - システムが利用できない</td>
2177
2178         <td>Child cannot open lock file. Exiting 
2179         (子プロセスがロックファイルを開けないため終了した)</td>
2180       </tr>
2181
2182       <tr>
2183         <td><code>alert</code> </td>
2184
2185         <td>直ちに対処が必要</td>
2186
2187         <td>getpwuid: couldn't determine user name from uid
2188         (getpwuid: UID からユーザ名を特定できなかった)</td>
2189       </tr>
2190
2191       <tr>
2192         <td><code>crit</code> </td>
2193
2194         <td>致命的な状態</td>
2195
2196         <td>socket: Failed to get a socket, exiting child
2197         (socket: ソケットが得られないため、子プロセスを終了させた)</td>
2198       </tr>
2199
2200       <tr>
2201         <td><code>error</code> </td>
2202
2203         <td>エラー</td>
2204
2205         <td>Premature end of script headers
2206         (スクリプトのヘッダが足りないままで終わった)</td>
2207       </tr>
2208
2209       <tr>
2210         <td><code>warn</code> </td>
2211
2212         <td>警告</td>
2213
2214         <td>child process 1234 did not exit, sending another SIGHUP
2215         (子プロセス 1234 が終了しなかった。もう一度 SIGHUP を送る)</td>
2216       </tr>
2217
2218       <tr>
2219         <td><code>notice</code> </td>
2220
2221         <td>普通だが、重要な情報</td>
2222
2223         <td>httpd: caught SIGBUS, attempting to dump core in ...
2224         (httpd: SIGBUS シグナルを受け、... へコアダンプをした)</td>
2225       </tr>
2226
2227       <tr>
2228         <td><code>info</code> </td>
2229
2230         <td>追加情報</td>
2231
2232         <td>"Server seems busy, (you may need to increase
2233         StartServers, or Min/MaxSpareServers)..." (「サーバは負荷が高い、
2234         (StartServers や Min/MaxSpareServers の値を増やす必要があるかも)」)</td>
2235       </tr>
2236
2237       <tr>
2238         <td><code>debug</code> </td>
2239
2240         <td>デバッグメッセージ</td>
2241
2242         <td>"Opening config file ..." (設定ファイルを開いている...)</td>
2243       </tr>
2244     </table>
2245
2246     <p>特定のレベルが指定された場合、それより高いレベルの全てのメッセージが
2247     報告されます。
2248     <em>例えば</em>、<code>LogLevel info</code> に指定すると、
2249     <code>notice</code> と <code>warn</code> も報告されます。</p>
2250
2251     <p>なお <code>crit</code> 以上のレベルを指定することが推奨されます。</p>
2252
2253     <p>例:</p>
2254
2255     <div class="example"><p><code>
2256       LogLevel notice
2257     </code></p></div>
2258
2259     <div class="note"><h3>注</h3>
2260       <p>ファイルにログを出力する場合、<code>notice</code>
2261       レベルのメッセージは抑制されず、すべてログに出力されます。
2262       しかし <code>syslog</code> を使用している場合は、
2263       これは当てはまりません。</p>
2264     </div>
2265
2266 </div>
2267 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2268 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">ディレクティブ</a></h2>
2269 <table class="directive">
2270 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>持続的な接続上で許可されるリクエストの数</td></tr>
2271 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>MaxKeepAliveRequests <var>number</var></code></td></tr>
2272 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2273 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2274 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2275 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2276 </table>
2277     <p><code class="directive">MaxKeepAliveRequests</code> ディレクティブは、
2278     <code class="directive"><a href="#keepalive">KeepAlive</a></code> が有効な場合に、
2279     一回の接続で受け付け可能なリクエストの数を制限します。
2280     <code>0</code> に設定していれば、受け付けるリクエストは無制限になります。
2281     この設定は、サーバ性能を向上させるために、大きな数値を指定することを勧めます。
2282     </p>
2283
2284     <p>例:</p>
2285
2286     <div class="example"><p><code>
2287       MaxKeepAliveRequests 500
2288     </code></p></div>
2289
2290 </div>
2291 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2292 <div class="directive-section"><h2><a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a> <a name="maxrangeoverlaps" id="maxrangeoverlaps">ディレクティブ</a></h2>
2293 <table class="directive">
2294 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Number of overlapping ranges (eg: <code>100-200,150-300</code>) allowed before returning the complete
2295         resource </td></tr>
2296 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
2297 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>MaxRangeOverlaps 20</code></td></tr>
2298 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
2299 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2300 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2301 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
2302 </table><p>The documentation for this directive has
2303             not been translated yet. Please have a look at the English
2304             version.</p></div>
2305 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2306 <div class="directive-section"><h2><a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a> <a name="maxrangereversals" id="maxrangereversals">ディレクティブ</a></h2>
2307 <table class="directive">
2308 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Number of range reversals (eg: <code>100-200,50-70</code>) allowed before returning the complete
2309         resource </td></tr>
2310 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
2311 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>MaxRangeReversals 20</code></td></tr>
2312 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
2313 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2314 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2315 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
2316 </table><p>The documentation for this directive has
2317             not been translated yet. Please have a look at the English
2318             version.</p></div>
2319 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2320 <div class="directive-section"><h2><a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a name="maxranges" id="maxranges">ディレクティブ</a></h2>
2321 <table class="directive">
2322 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Number of ranges allowed before returning the complete
2323 resource </td></tr>
2324 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>MaxRanges default | unlimited | none | <var>number-of-ranges</var></code></td></tr>
2325 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>MaxRanges 200</code></td></tr>
2326 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
2327 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2328 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2329 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.3.15 and later</td></tr>
2330 </table><p>The documentation for this directive has
2331             not been translated yet. Please have a look at the English
2332             version.</p></div>
2333 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2334 <div class="directive-section"><h2><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">ディレクティブ</a></h2>
2335 <table class="directive">
2336 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Configures mutex mechanism and lock file directory for all
2337 or specified mutexes</td></tr>
2338 <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>
2339 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>Mutex default</code></td></tr>
2340 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2341 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2342 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2343 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.3.4 and later</td></tr>
2344 </table><p>The documentation for this directive has
2345             not been translated yet. Please have a look at the English
2346             version.</p></div>
2347 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2348 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">ディレクティブ</a></h2>
2349 <table class="directive">
2350 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>名前ベースのバーチャルホストのための IP アドレスを指定</td></tr>
2351 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>NameVirtualHost <var>addr</var>[:<var>port</var>]</code></td></tr>
2352 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2353 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2354 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2355 </table>
2356     <p><code class="directive">NameVirtualHost</code> ディレクティブは、
2357     <a href="../vhosts/">名前ベースのバーチャルホスト</a>の設定を行ないたい場合に
2358     必要となるものです。</p>
2359
2360     <p><var>addr</var> にはホスト名を指定できますが、
2361     常に IP アドレスを指定するのが推奨されます。
2362     例えば、</p>
2363
2364     <div class="example"><p><code>
2365       NameVirtualHost 111.22.33.44
2366     </code></p></div>
2367
2368     <p><code class="directive">NameVirtualHost</code> ディレクティブは、
2369     名前ベースのバーチャルホストを
2370     利用してリクエストを受け付ける IP アドレスを指定します。
2371     これは、普通は名前ベースのバーチャルホストアドレスです。
2372     ただし、ファイアーウォールや他のプロキシがリクエストを受け付け、
2373     違う IP アドレスのサーバにフォワードするという場合は、
2374     リクエストを提供したいマシン上の物理インターフェースの
2375     IP アドレスを指定する必要があります。
2376     複数のアドレスで複数の名前ベースのバーチャルホストを指定する場合は
2377     各アドレスに対してディレクティブを書いてください。</p>
2378
2379     <div class="note"><h3>中</h3>
2380       <p>「主サーバ」や、どの <code>_default_</code> サーバも、
2381       <code class="directive">NameVirtualHost</code> で指定した IP アドレスへのリクエスト
2382       を処理することは<strong>ありません</strong> (なぜか
2383       <code class="directive">NameVirtualHost</code> を
2384       指定したけどそのアドレスに <code class="directive">VirtualHost</code> を定義しなかった場合を除く)。</p>
2385     </div>
2386
2387     <p>名前ベースのバーチャルホストにポート番号を指定することも可能です。
2388     例えば</p>
2389
2390     <div class="example"><p><code>
2391       NameVirtualHost 111.22.33.44:8080
2392     </code></p></div>
2393
2394     <p>IPV6 のアドレスは次の例のように角括弧で囲む必要があります:</p>
2395  
2396     <div class="example"><p><code>
2397       NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2398     </code></p></div>
2399
2400     <p>すべてのインタフェースへのリクエストを受け取るようにするためには、
2401     引数として <code>*</code> を使います。</p>
2402
2403     <div class="example"><p><code>
2404       NameVirtualHost *
2405     </code></p></div>
2406
2407     <div class="note"><h3><code class="directive">&lt;VirtualHost&gt;</code> ディレクティブの引数</h3>
2408       <p><code class="directive">&lt;VirtualHost&gt;</code> ディレクティブの引数は <code class="directive">NameVirtualHost</code> ディレクティブの引数に正確に
2409       合っている必要があることに注意してください。</p>
2410
2411       <div class="example"><p><code>
2412         NameVirtualHost 1.2.3.4<br />
2413         &lt;VirtualHost 1.2.3.4&gt;<br />
2414         # ...<br />
2415         &lt;/VirtualHost&gt;<br />
2416       </code></p></div>
2417     </div>
2418
2419
2420 <h3>参照</h3>
2421 <ul>
2422 <li><a href="../vhosts/">バーチャルホスト説明書
2423 </a></li>
2424 </ul>
2425 </div>
2426 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2427 <div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">ディレクティブ</a></h2>
2428 <table class="directive">
2429 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディレクトリに対して使用可能な機能を設定する</td></tr>
2430 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Options
2431     [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
2432 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>Options All</code></td></tr>
2433 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2434 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>Options</td></tr>
2435 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2436 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2437 </table>
2438     <p><code class="directive">Options</code> ディレクティブは、特定のディレクトリに対して
2439     どの機能が使用可能かを制御します。</p>
2440
2441     <p><var>option</var> を <code>None</code>に指定すると、
2442     特別な機能は全て無効になります。
2443     また、以下の示す 1 個以上のものを指定できます。</p>
2444
2445     <dl>
2446       <dt><code>All</code></dt>
2447
2448       <dd><code>MultiViews</code> を除いた全ての機能が有効となります。
2449       これがデフォルトです。</dd>
2450
2451       <dt><code>ExecCGI</code></dt>
2452
2453       <dd>
2454       <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> による CGI スクリプトの実行を許可します。</dd>
2455
2456       <dt><code>FollowSymLinks</code></dt>
2457
2458       <dd>
2459       サーバが、このディレクトリ内でシンボリックリンクをたどれるようにします。
2460       <div class="note"><p>サーバがシンボリックリンクをたどる場合でも、
2461       <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> セクションに
2462       マッチさせるための
2463       パス名は<em>変更されません</em>。</p>
2464       <p><code class="directive"><a href="#location">&lt;Location&gt;</a></code> 内に
2465       このオプションを指定しても<strong>無視される</strong>ことに
2466       注意してください。</p>
2467       <p>このオプションを省略したからといってセキュリティの強化にはなりません。
2468       なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、
2469       そのため回避可能になるからです。</p>
2470       </div></dd>
2471
2472       <dt><code>Includes</code></dt>
2473
2474       <dd>
2475       <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> が提供する SSI を有効にします。</dd>
2476
2477       <dt><code>IncludesNOEXEC</code></dt>
2478
2479       <dd>
2480       SSI は有効になりますが、<code>#exec</code> コマンド と <code>#exec CGI</code> は無効になります。
2481       ただし、<code>#include virtual</code> により、<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> されたディレクトリで
2482       CGI を実行することは可能です。</dd>
2483
2484       <dt><code>Indexes</code></dt>
2485
2486       <dd>
2487       もし、URL がディレクトリにマップするリクエストであって、
2488       且つ <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> で指定したファイル (例えば、<code>index.html</code>) が
2489       ディレクトリ内に無ければ、<code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> が
2490       ディレクトリ内の一覧を整形して返します。</dd>
2491
2492       <dt><code>MultiViews</code></dt>
2493
2494       <dd>
2495       <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> による
2496       <a href="../content-negotiation.html">コンテントネゴシエーション</a> 
2497       された "MultiViews" を許可します。</dd>
2498
2499       <dt><code>SymLinksIfOwnerMatch</code></dt>
2500
2501       <dd>
2502       シンボリック先のファイルまたはディレクトリが、
2503       シンボリックリンクの所有ユーザ ID と同じ場合にのみシンボリックリンクを
2504       たどれるようにします。
2505
2506       <div class="note"><h3>注</h3> <p><code class="directive"><a href="#location">&lt;Location&gt;</a></code> 内にこのオプションを
2507       指定しても無視されます。</p>
2508       <p>このオプションはセキュリティの強化にはなりません。
2509       なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、
2510       そのため回避可能になるからです。</p>
2511       </div>
2512       </dd>
2513     </dl>
2514
2515     <p>通常、ディレクトリに対して複数の <code class="directive">Options</code> が
2516     適用可能な場合、
2517     最も近いもの一つのみが適用され、他のものは無視されます。
2518     複数の指定がマージされるわけではありません。(<a href="../sections.html#mergin">セクションのマージ方法</a>を参照してください。)
2519     しかし、すべての <code class="directive">Options</code> ディレクティブが <code>+</code> や <code>-</code> 付きで
2520     指定された場合はオプションの値はマージされます。
2521     <code>+</code> を頭につければ現在の設定に加えられ、
2522     <code>-</code> を付ければ現在の設定から削除されます。</p>
2523
2524     <div class="warning"><h3>警告</h3>
2525     <p><code class="directive">Options</code> で <code>+</code> や
2526     <code>-</code> のついたものを、つけないものと組み合わせて
2527     指定する構文は正しい構文ではありませんので、期待する結果に
2528     ならないことがあります。</p>
2529     </div>
2530
2531     <p>例えば、<code>+</code> や <code>-</code> を利用しない場合は:</p>
2532
2533     <div class="example"><p><code>
2534       &lt;Directory /web/docs&gt;<br />
2535       <span class="indent">
2536         Options Indexes FollowSymLinks<br />
2537       </span>
2538       &lt;/Directory&gt;<br />
2539       <br />
2540       &lt;Directory /web/docs/spec&gt;<br />
2541       <span class="indent">
2542         Options Includes<br />
2543       </span>
2544       &lt;/Directory&gt;
2545     </code></p></div>
2546
2547     <p><code>/web/docs/spec</code> というディレクトリには、
2548     <code>Includes</code> だけが適用されます。
2549     しかし、2 番目の <code class="directive">Options</code> で <code>+</code> や <code>-</code> を利用してみると:</p>
2550  
2551     <div class="example"><p><code>
2552       &lt;Directory /web/docs&gt;<br />
2553       <span class="indent">
2554         Options Indexes FollowSymLinks<br />
2555       </span>
2556       &lt;/Directory&gt;<br />
2557       <br />
2558       &lt;Directory /web/docs/spec&gt;<br />
2559       <span class="indent">
2560         Options +Includes -Indexes<br />
2561       </span>
2562       &lt;/Directory&gt;
2563     </code></p></div>
2564
2565     <p><code>/web/docs/spec</code> というディレクトリには、 <code>FollowSymLinks</code> と
2566     <code>Includes</code> が適用されます。</p>
2567
2568     <div class="note"><h3>注</h3>
2569       <p><code>-IncludesNOEXEC</code> もしくは
2570       <code>-Includes</code> を指定すると、
2571       前の設定がどのようになっていようとも SSI は無効となります。</p>
2572     </div>
2573
2574     <p>どのような設定もされていなければ、デフォルトでは <code>All</code> に
2575     なります。</p>
2576
2577 </div>
2578 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2579 <div class="directive-section"><h2><a name="Protocol" id="Protocol">Protocol</a> <a name="protocol" id="protocol">ディレクティブ</a></h2>
2580 <table class="directive">
2581 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Protocol for a listening socket</td></tr>
2582 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>Protocol <var>protocol</var></code></td></tr>
2583 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2584 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2585 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2586 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache 2.1.5 and later.
2587 On Windows from Apache 2.3.3 and later.</td></tr>
2588 </table><p>The documentation for this directive has
2589             not been translated yet. Please have a look at the English
2590             version.</p><h3>参照</h3>
2591 <ul>
2592 <li><code class="directive">AcceptFilter</code></li>
2593 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
2594 </ul>
2595 </div>
2596 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2597 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">ディレクティブ</a></h2>
2598 <table class="directive">
2599 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Apache の子プロセスから起動されたプロセスの CPU 消費量を
2600 制限する</td></tr>
2601 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>RLimitCPU <var>seconds</var>|max [<var>seconds</var>|max]</code></td></tr>
2602 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>未設定。オペレーティングシステムのデフォルトを使用</code></td></tr>
2603 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2604 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
2605 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2606 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2607 </table>
2608     <p>一つか二つのパラメータをとります。
2609     最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2610     2 番目のパラメータは最大のリソースリミットを設定します。
2611     パラメータには数字か、オペレーティングシステムの最大となる
2612     <code>max</code> のどちらかを指定することができます。
2613     最大のリソースリミットを上げるためには、サーバを
2614     <code>root</code> で実行するか起動されなければいけません。</p>
2615
2616     <p>ちなみに、この設定は Apache の子プロセス自体ではなく、
2617     リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
2618     適用されます。
2619     これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
2620     親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
2621
2622     <p>CPU リソースのリミットはプロセスあたりの秒数で表わされます。</p>
2623
2624
2625 <h3>参照</h3>
2626 <ul>
2627 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2628 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2629 </ul>
2630 </div>
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="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">ディレクティブ</a></h2>
2633 <table class="directive">
2634 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Apache の子プロセスから起動されたプロセスのメモリ消費量を
2635 制限する</td></tr>
2636 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>RLimitMEM <var>bytes</var>|max [<var>bytes</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>
2642 </table>
2643     <p>一つか二つのパラメータをとります。
2644     最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2645     2 番目のパラメータは最大のリソースリミットを設定します。
2646     パラメータには数字か、オペレーティングシステムの最大となる
2647     <code>max</code> のどちらかを指定することができます。
2648     最大のリソースリミットを上げるためには、サーバを
2649     <code>root</code> で実行するか起動されなければいけません。</p>
2650
2651     <p>この設定は Apache の子プロセス自体ではなく、
2652     リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
2653     適用されます。
2654     これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
2655     親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
2656
2657     <p>メモリリソースのリミットはプロセスあたりのバイト数で表わされます。</p>
2658
2659 <h3>参照</h3>
2660 <ul>
2661 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2662 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2663 </ul>
2664 </div>
2665 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2666 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">ディレクティブ</a></h2>
2667 <table class="directive">
2668 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Apache の子プロセスから起動されたプロセスが起動するプロセスの
2669 数を制限する</td></tr>
2670 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>RLimitNPROC <var>number</var>|max [<var>number</var>|max]</code></td></tr>
2671 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>未設定。オペレーティングシステムのデフォルトを使用</code></td></tr>
2672 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2673 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
2674 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2675 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2676 </table>
2677     <p>一つか二つのパラメータをとります。
2678     最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2679     2 番目のパラメータは最大のリソースリミットを設定します。
2680     パラメータには数字か、オペレーティングシステムの最大となる
2681     <code>max</code> のどちらかを指定することができます。
2682     最大のリソースリミットを上げるためには、サーバを
2683     <code>root</code> で実行するか起動されなければいけません。</p>
2684
2685     <p>この設定は Apache の子プロセス自体ではなく、
2686     リクエストを受け付けた Apache の子プロセスから fork されたプロセスに
2687     適用されます。
2688     これには CGI や SSI から実行されたコマンドが含まれますが、Apache の
2689     親プロセスから fork されたログのパイププロセスなどには適用されません。</p>
2690
2691     <p>プロセスの制限は、ユーザあたりのプロセス数で制御されます。</p>
2692
2693     <div class="note"><h3>注</h3>
2694       <p> CGI プロセスがウェブサーバのユーザ ID 以外で実行されるので
2695       <strong>無ければ</strong>、
2696       このディレクティブは、サーバ自身が生成できるプロセスの数を制限することになります。
2697       そのような状況になっているかどうかは、<code>error_log</code> 中の
2698       <strong><code>cannot fork</code></strong> というメッセージにより
2699       確認することができます。</p>
2700     </div>
2701
2702 <h3>参照</h3>
2703 <ul>
2704 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2705 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2706 </ul>
2707 </div>
2708 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2709 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">ディレクティブ</a></h2>
2710 <table class="directive">
2711 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>CGI スクリプトのインタープリタの位置を調べるための手法</td></tr>
2712 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2713 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2714 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2715 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
2716 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2717 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2718 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Win32 のみ。
2719 オプション <code>Registry-Strict</code> は Apache 2.0 以降で使用可能</td></tr>
2720 </table>
2721     <p>このディレクティブは、Apache で CGI スクリプトを
2722     実行する場合に利用するインタープリタを、
2723     どのように探し出すかについて制御するために使用します。
2724     デフォルトの設定は <code>Script</code> です。これはスクリプトの
2725     shebang 行 (最初の行で <code>#!</code> から始まるもの)
2726     に指されているインタープリタを使用します。Win32 ではその行は
2727     以下の様になります。</p>
2728
2729     <div class="example"><p><code>
2730       #!C:/Perl/bin/perl.exe
2731     </code></p></div>
2732
2733     <p>もしくは、<code>perl</code> が <code>PATH</code> にある場合は単に:</p>
2734
2735     <div class="example"><p><code>
2736       #!perl
2737     </code></p></div>
2738
2739     <p><code>ScriptInterpreterSource Registry</code> を指定すると、
2740     スクリプトファイルの拡張子 (例えば、<code>.pl</code>) を
2741     キーとして、Windows のレジストリツリー <code>HKEY_CLASSES_ROOT</code>
2742     を検索するようになります。レジストリのサブキー
2743     <code>Shell\ExecCGI\Command</code> か、それが存在しない場合は
2744     <code>Shell\Open\Command</code> がスクリプトファイルを開くために
2745     使われます。レジストリキーが見つからないときは、Apache は <code>Script</code>
2746     オプションが指定されたときの動作に戻ります。</p>
2747
2748     <div class="warning"><h3>セキュリティ</h3> 
2749     <p><code>ScriptInterpreterSource Registry</code> を <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> されたディレクトリで使うときは
2750     注意してください。Apache はそのディレクトリ中の<em>すべての</em>ファイルを
2751     実行しようとします。<code>Registry</code> という設定は通常は実行されない
2752     ファイルに対して望ましくないプログラムの実行が発生する可能性があります。
2753     例えば、ほとんどの Windows システムで、
2754     <code>.htm</code> ファイルのデフォルトの「開く」コマンドは
2755     Microsoft Internet Explorer を実行しますので、スクリプトに指定された
2756     ディレクトリにある <code>.htm</code> ファイルへのリクエストはサーバの
2757     バックグラウンドでブラウザを実行することになります。これは、一分内くらいで
2758     システムをクラッシュさるための良い方法です。</p>
2759     </div>
2760
2761     <p>Apache 2.0 から導入されたオプション <code>Registry-Strict</code> は
2762     <code>Registry</code> と同じことを行ないますが、サブキー
2763     <code>Shell\ExecCGI\Command</code> のみを使います。
2764     <code>ExecCGI</code> キーは普通に使われるキーではありません。Windows 
2765     レジストリに手動で設定する必要がありますので、システムでの偶発的なプログラムの
2766     実行を防ぐことができます。</p>
2767
2768 </div>
2769 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2770 <div class="directive-section"><h2><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">ディレクティブ</a></h2>
2771 <table class="directive">
2772 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Determine if mod_status displays the first 63 characters
2773 of a request or the last 63, assuming the request itself is greater than
2774 63 chars.</td></tr>
2775 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
2776 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>SeeRequestTail Off</code></td></tr>
2777 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2778 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2779 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2780 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache httpd 2.2.7 and later.</td></tr>
2781 </table><p>The documentation for this directive has
2782             not been translated yet. Please have a look at the English
2783             version.</p></div>
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="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">ディレクティブ</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>ServerAdmin <var>email-address</var>|<var>URL</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>
2793 </table>
2794     <p><code class="directive">ServerAdmin</code> は、クライアントに返すさまざまな
2795     エラーメッセージ中に記述する、
2796     問合せアドレスを設定します。与えられた引数を <code>httpd</code> が
2797     URL と認識しない場合は、<var>email-address</var> だと解釈して、
2798     ハイパーリンクのターゲットに <code>mailto:</code> を付けます。
2799     実際には、ここには電子メールアドレスを使うことが推奨されています。
2800     多くの CGI スクリプトはそうなっていることを仮定しています。
2801     URL を使う場合は、あなたの管理下にある別サーバを指すようにしてください。
2802     そうでないと、エラーが起こったときに連絡をすることができなくなって
2803     しまいます。
2804 </p>
2805
2806     <p>その際、これのために専用のアドレスを設定するのが良いでしょう。
2807     例えば、</p>
2808
2809     <div class="example"><p><code>
2810       ServerAdmin www-admin@foo.example.com
2811     </code></p></div>
2812
2813     <p>といったようにします。ユーザはいつもサーバに関する話であるということを
2814     明記してくるわけではありませんので。</p>
2815
2816
2817 </div>
2818 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2819 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">ディレクティブ</a></h2>
2820 <table class="directive">
2821 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リクエストを名前ベースのバーチャルホストにマッチさせているときに
2822 使用されるホストの別名</td></tr>
2823 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerAlias <var>hostname</var> [<var>hostname</var>] ...</code></td></tr>
2824 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>バーチャルホスト</td></tr>
2825 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2826 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2827 </table>
2828     <p><code class="directive">ServerAlias</code> ディレクティブは、<a href="../vhosts/name-based.html">ネームベースのバーチャルホスト</a>において
2829     使用するホストの別名を指定します。
2830     適切であれば、<code class="directive">ServerAlias</code> ディレクティブでは
2831     ワイルドカードを使うこともできます。</p>
2832
2833     <div class="example"><p><code>
2834       &lt;VirtualHost *&gt;<br />
2835       ServerName server.domain.com<br />
2836       ServerAlias server server2.domain.com server2<br />
2837       # ...<br />
2838       &lt;/VirtualHost&gt;
2839     </code></p></div>
2840
2841 <h3>参照</h3>
2842 <ul>
2843 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
2844 </ul>
2845 </div>
2846 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2847 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">ディレクティブ</a></h2>
2848 <table class="directive">
2849 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが自分自身を示すときに使うホスト名とポート</td></tr>
2850 <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>
2851 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
2852 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2853 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2854 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>このディレクティブはバージョン 2.0 ではバージョン 1.3 の
2855     <code class="directive">Port</code> ディレクティブの機能も含みます。</td></tr>
2856 </table>
2857     <p><code class="directive">ServerName</code> ディレクティブは、
2858     サーバが自分自身を示すスキーム名、ホスト名とポート番号を設定します。
2859     これは、リダイレクトする URL を生成する際に利用されます。
2860     例えば、ウェブサーバを動かしているマシンは <code>simple.example.com</code>
2861     で、DNS のエイリアス <code>www.example.com</code> もあるときに、
2862     ウェブサーバが後者として認識されて欲しいときは、以下のようにディレクティブを
2863     使います。</p>
2864
2865     <div class="example"><p><code>
2866       ServerName www.example.com:80
2867     </code></p></div>
2868
2869     <p><code class="directive">ServerName</code> が指定されていないときは、
2870     サーバは IP アドレスから逆引きを行なうことでホスト名を知ろうとします。
2871     <code class="directive">ServerName</code> にポートが指定されていないときは、
2872     サーバはリクエストが来ている
2873     ポートを使います。最高の信頼性と確実性をもたらすためには、
2874     <code class="directive">ServerName</code> を使ってホスト名とポートを明示的に
2875     指定してください。</p>
2876
2877     <p><a href="../vhosts/name-based.html">名前ベースのバーチャルホスト</a>
2878     を利用している場合、<code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> セクション内の
2879     <code class="directive">ServerName</code> はこのバーチャルホストにマッチするために
2880     何がリクエストの Host: ヘッダに現れる必要があるのかを指定します。</p>
2881
2882     <p>SSL を処理するデバイス、例えばリバースプロクシやロードバランサや
2883     SSL 処理軽減アプライアンスの裏側でサーバが稼動する場合もあるでしょう。
2884     そういった場合では、クライアントが接続するときに使う
2885     <code>https://</code> スキームとポート番号を <code class="directive">ServerName</code>
2886     ディレクティブで指定して、自己参照 URL が正しく生成できるようにします。</p>
2887
2888     <p>自己参照 URL (例えば <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> モジュールによるものなど)
2889     が指定されたポートを使うか、クライアントのリクエストのポート番号を使うかを
2890     決定する設定は <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> 
2891     ディレクティブと <code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
2892     ディレクティブを参照してください。</p>
2893
2894
2895 <h3>参照</h3>
2896 <ul>
2897 <li><a href="../dns-caveats.html">DNS と Apache に関する話</a></li>
2898 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
2899 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2900 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
2901 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2902 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2903 </ul>
2904 </div>
2905 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2906 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">ディレクティブ</a></h2>
2907 <table class="directive">
2908 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>非互換のブラウザが名前ベースのバーチャルホストにアクセスしたときの
2909 ための互換用 URL パス名</td></tr>
2910 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
2911 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>バーチャルホスト</td></tr>
2912 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2913 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2914 </table>
2915     <p><code class="directive">ServerPath</code> ディレクティブは、<a href="../vhosts/">ネームベースのバーチャルホスト</a>において利用する
2916     互換用 URL パス名を設定します。</p>
2917
2918 <h3>参照</h3>
2919 <ul>
2920 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
2921 </ul>
2922 </div>
2923 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2924 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">ディレクティブ</a></h2>
2925 <table class="directive">
2926 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>インストールされたサーバのベースディレクトリ</td></tr>
2927 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
2928 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
2929 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2930 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2931 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2932 </table>
2933     <p><code class="directive">ServerRoot</code> ディレクティブは、
2934     サーバが存在するディレクトリを設定します。
2935     通常、<code>conf/</code> や <code>logs/</code> といったサブディレクトリが
2936     存在します。
2937     また、他の設定ディレクティブ (例えば <code class="directive"><a href="#include">Include</a></code> や <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> など) における相対パスは、
2938     このディレクトリからの相対位置となります。</p>
2939
2940     <div class="example"><h3>例</h3><p><code>
2941       ServerRoot /home/httpd
2942     </code></p></div>
2943
2944
2945
2946 <h3>参照</h3>
2947 <ul>
2948 <li><a href="../invoking.html"><code>httpd</code> の <code>-d</code>
2949     オプション</a></li>
2950 <li><code class="directive">ServerRoot</code> の権限を適切に設定する方法は<a href="../misc/security_tips.html#serverroot">セキュリティのこつ</a></li>
2951 </ul>
2952 </div>
2953 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2954 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">ディレクティブ</a></h2>
2955 <table class="directive">
2956 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが生成するドキュメントのフッタを設定</td></tr>
2957 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
2958 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerSignature Off</code></td></tr>
2959 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
2960 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</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>
2963 </table>
2964     <p><code class="directive">ServerSignature</code> ディレクティブは、
2965     サーバが生成するドキュメント
2966     (エラーメッセージ、<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> における FTP のディレクトリリスト、
2967     <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> の出力、等々)
2968     の最下行に付与するフッタの設定を行ないます。
2969     そのようなフッタ行を有効にしたい理由には、
2970     プロキシが複数連なっている場合に、ユーザはどのサーバが返した
2971     エラーメッセージかを知る手段がほとんど無いというものがあります。</p>
2972
2973
2974     <p>デフォルトである <code>Off</code> に設定をすると、フッタ行が抑制されます
2975     (そして、Apache-1.2 以前と互換の動作をします)。
2976     <code>On</code> に設定した場合は、単にドキュメントの中に、サーバのバージョン、
2977     稼動中のバーチャルホストの <a href="#servername">ServerName</a> の書かれた行を追加し、
2978     <code>EMail</code> にした場合はさらに参照されたドキュメントに対する <a href="#serveradmin">ServerAdmin</a> を指す "mailto:" が追加されます。</p>
2979
2980     <p>バージョン 2.0.44 以降では、表示されるサーバーのバージョン番号の詳細は<code class="directive"><a href="#servertokens">ServerTokens</a></code>
2981     ディレクティブにより制御されます。</p>
2982
2983 <h3>参照</h3>
2984 <ul>
2985 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
2986 </ul>
2987 </div>
2988 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2989 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">ディレクティブ</a></h2>
2990 <table class="directive">
2991 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>Server</code> HTTP 応答ヘッダを設定する</td></tr>
2992 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
2993 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerTokens Full</code></td></tr>
2994 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
2995 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
2996 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
2997 </table>
2998     <p>このディレクティブは、クライアントに送り返す <code>Server</code>
2999     応答ヘッダ内に、サーバの一般的な OS 種別や、
3000     コンパイルされて組み込まれているモジュールの情報を
3001     含めるかどうかを指定します。</p>
3002
3003     <dl>
3004       <dt><code>ServerTokens Prod[uctOnly]</code></dt>
3005
3006       <dd>サーバは (例えば): <code>Server:
3007       Apache</code> といったように送ります。</dd>
3008
3009       <dt><code>ServerTokens Major</code></dt>
3010
3011       <dd>Server sends (<em>e.g.</em>): <code>Server:
3012       Apache/2</code></dd>
3013
3014       <dt><code>ServerTokens Minor</code></dt>
3015
3016       <dd>Server sends (<em>e.g.</em>): <code>Server:
3017       Apache/2.0</code></dd>
3018
3019       <dt><code>ServerTokens Min[imal]</code></dt>
3020
3021       <dd>サーバは (例えば): <code>Server:
3022       Apache/2.0.41</code> といったように送ります。</dd>
3023
3024       <dt><code>ServerTokens OS</code></dt>
3025
3026       <dd>サーバは (例えば): <code>Server: Apache/2.0.41
3027       (Unix)</code> といったように送ります。</dd>
3028
3029       <dt><code>ServerTokens Full</code> (もしくは未指定)</dt>
3030
3031       <dd>サーバは (例えば): <code>Server: Apache/2.0.41
3032       (Unix) PHP/4.2.2 MyMod/1.2</code> といったように送ります。</dd>
3033     </dl>
3034
3035     <p>この設定はサーバ全体に適用され、バーチャルホスト上で有効にしたり
3036     無効にしたりはできません。</p>
3037
3038     <p>バージョン 2.0.44 以降ではこのディレクティブは <code class="directive"><a href="#serversignature">ServerSignature</a></code>
3039     ディレクティブにより表示される情報も制御します。</p>
3040
3041 <h3>参照</h3>
3042 <ul>
3043 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3044 </ul>
3045 </div>
3046 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3047 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">ディレクティブ</a></h2>
3048 <table class="directive">
3049 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>マッチするファイルがハンドラで処理されるようにする</td></tr>
3050 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
3051 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
3052 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
3053 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3054 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3055 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 で core に移動</td></tr>
3056 </table>
3057     <p><code>.htaccess</code> や <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
3058     セクション、<code class="directive"><a href="#location">&lt;Location&gt;</a></code>
3059     セクションに書かれた場合、
3060     このディレクティブはそこにあるすべてのファイルが
3061     <var>handler-name</var> で指定された<a href="../handler.html">ハンドラ</a>で扱われることを強制します。例えば、拡張子に関わらず、
3062     ディレクトリ全体がイメージマップファイルとして解析して欲しい場合には、
3063     以下をそのディレクトリの <code>.htaccess</code>
3064     ファイルに記述します:</p>
3065
3066     <div class="example"><p><code>
3067       SetHandler imap-file
3068     </code></p></div>
3069
3070     <p>別の例: URL <code>http://servername/status</code>
3071     が指定されたときにサーバが状態報告をするようにしたいときは、以下を
3072     <code>httpd.conf</code> に記述します:</p>
3073
3074     <div class="example"><p><code>
3075       &lt;Location /status&gt;<br />
3076       <span class="indent">
3077         SetHandler server-status<br />
3078       </span>
3079       &lt;/Location&gt;
3080     </code></p></div>
3081
3082     <p><code>None</code> という値を設定することで、
3083     前の方の <code class="directive">SetHandler</code> で定義された設定を無効にすることが
3084     できます。</p>
3085     <p><strong>注意:</strong>SetHandler はデフォルトのハンドラをオーバーライド
3086     しますので、通常の挙動、たとえば、スラッシュ (/) で終わる URL が
3087     リクエストされたときにディレクトリやインデックスファイルを返すよう取り扱う挙動は、
3088     行われなくなります。
3089     </p>
3090
3091
3092 <h3>参照</h3>
3093 <ul>
3094 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3095 </ul>
3096 </div>
3097 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3098 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">ディレクティブ</a></h2>
3099 <table class="directive">
3100 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントのリクエストや POST の入力を処理するフィルタを設定する</td></tr>
3101 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
3102 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
3103 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
3104 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3105 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3106 </table>
3107     <p><code class="directive">SetInputFilter</code> ディレクティブはクライアントの
3108     リクエストや POST の入力をサーバが受け取ったときに処理するフィルタを
3109     設定します。これは <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>
3110     ディレクティブを含め、他の場所で定義されているフィルタの設定に
3111     追加されます。</p>
3112
3113     <p>複数のフィルタを指定するときは、データを処理する順番に
3114     セミコロンで区切る必要があります。</p>
3115
3116
3117 <h3>参照</h3>
3118 <ul>
3119 <li><a href="../filter.html">フィルタ</a>説明書</li>
3120 </ul>
3121 </div>
3122 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3123 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">ディレクティブ</a></h2>
3124 <table class="directive">
3125 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバの応答を処理するフィルタを設定する</td></tr>
3126 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
3127 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
3128 <tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
3129 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3130 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3131 </table>
3132     <p><code class="directive">SetOutputFilter</code> ディレクティブは
3133     サーバの応答をクライアントに送り返される前に処理するフィルタを設定します。
3134     これは <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>
3135     ディレクティブを含め、他の場所で定義されているフィルタの設定に
3136     追加されます。</p>    
3137
3138     <p>例えば、以下の設定は <code>/www/data/</code> ディレクトリのすべての
3139     ファイルを SSI で処理します。</p>
3140
3141     <div class="example"><p><code>
3142       &lt;Directory /www/data/&gt;<br />
3143       <span class="indent">
3144         SetOutputFilter INCLUDES<br />
3145       </span>
3146       &lt;/Directory&gt;
3147     </code></p></div>
3148
3149     <p>複数のフィルタを指定するときは、データを処理する順番に
3150     セミコロンで区切る必要があります。</p>
3151
3152 <h3>参照</h3>
3153 <ul>
3154 <li><a href="../filter.html">フィルタ</a>説明書</li>
3155 </ul>
3156 </div>
3157 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3158 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">ディレクティブ</a></h2>
3159 <table class="directive">
3160 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>各イベントについて、リクエストを失敗させるまでにサーバが
3161 待つ時間を設定</td></tr>
3162 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
3163 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>TimeOut 60</code></td></tr>
3164 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
3165 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3166 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3167 </table>
3168     <p><code class="directive">TimeOut</code> ディレクティブは、
3169     様々な条件下での I/O 待ち時間を定義します:</p>
3170
3171     <ol>
3172       <li>クライアントからのデータを読み込む時。
3173       受信バッファが空になっていて、TCP パケットが届くまで
3174       待つ時間の長さ</li>
3175
3176       <li>クライアントに対してデータを送り出す時。
3177       送信バッファがいっぱいで、パケットの受信完了 <span class="transnote">(<em>訳注:</em> ACK)</span> 
3178       が届くまで待つ時間の長さ</li>
3179
3180       <li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> 内で、CGI スクリプトが出力を
3181       返すまでの待ち時間の長さ</li>
3182
3183       <li><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> 内で、フィルタ処理で出力を
3184       待つ時間の長さ</li>
3185
3186       <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> 内で、
3187       <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code>
3188       が設定されていない場合のデフォルトの待ち時間</li>
3189     </ol>
3190
3191
3192 </div>
3193 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3194 <div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">ディレクティブ</a></h2>
3195 <table class="directive">
3196 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>TRACE</code> メソッドのリクエストに対する応答方法を決める
3197 </td></tr>
3198 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
3199 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>TraceEnable on</code></td></tr>
3200 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
3201 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3202 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3203 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 1.3.34, 2.0.55 以降</td></tr>
3204 </table>
3205     <p>Apache のコア機能<span class="transnote">(<em>訳注:</em> <code class="module"><a href="../mod/core.html">core</a></code>)</span>と
3206     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> 両方の <code>TRACE</code>
3207     の挙動をオーバーライドします。デフォルトの <code>TraceEnable on</code>
3208     は、リクエストボディを受け入れないような、RFC2616 に準拠した
3209     <code>TRACE</code> リクエストを受け付けます。
3210     <code>TraceEnable off</code> と設定すると、コアサーバと
3211     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> は <code>405</code> (メソッド不許可)
3212     エラーをクライアントに返します。</p>
3213
3214     <p>最後に、テストや調査目的などの限定用途として、仕様に準拠しない
3215     <code>TraceEnable extended</code> を使って、リクエストボディを
3216     受け付けるように挙動を変更できます。(オリジンサーバとしての)
3217     Apache のコアでは、リクエストボディのサイズは 64k (
3218     <code>Transfer-Encoding: chunked</code> が使われている場合は 
3219     chunk ヘッダ用に +8k) に制限されます。
3220     Apache のコアは、ヘッダと全ての chunk ヘッダをレスポンスの
3221     ボディとして返却します。
3222     proxy サーバとしては、リクエストボディのサイズは 64k に制限されません。</p>
3223
3224 </div>
3225 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3226 <div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">ディレクティブ</a></h2>
3227 <table class="directive">
3228 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Undefine the existence of a variable</td></tr>
3229 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr>
3230 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
3231 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3232 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3233 </table><p>The documentation for this directive has
3234             not been translated yet. Please have a look at the English
3235             version.</p></div>
3236 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3237 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">ディレクティブ</a></h2>
3238 <table class="directive">
3239 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが自分自身の名前とポートを決定する方法を設定する</td></tr>
3240 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UseCanonicalName On|Off|Dns</code></td></tr>
3241 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>UseCanonicalName Off</code></td></tr>
3242 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
3243 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3244 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3245 </table>
3246     <p>多くの状況で Apache は<em>自己参照</em> URL、すなわち
3247     同じサーバを指す URL、を作成する必要があります。
3248     <code>UseCanonicalName On</code> の場合は、<code class="directive"><a href="#servername">ServerName</a></code> ディレクティブで指定されている
3249     ホスト名とポート番号を使って、その正規名 (自己参照の名前) を生成します。
3250     この名前は、すべての自己参照 URL で使われますし、CGI の 
3251     <code>SERVER_NAME</code> と <code>SERVER_PORT</code> でも使われます。</p>
3252
3253     <p><code>UseCanonicalName Off</code> の場合、
3254     クライアントがホスト名とポートを指定したときには、
3255     それらを元に自己参照 URL を作成します (指定がなかったときは
3256     上の定義と同様にして正規名を解決します)。
3257     これらの値は<a href="../vhosts/name-based.html">名前ベースの
3258     バーチャルホスト</a>を実装で使われているのと同じ値で、
3259     同じクライアントで取得できる値になっています。
3260     CGI 変数 <code>SERVER_NAME</code> と <code>SERVER_PORT</code> 
3261     もクライアントから与えられた値から作成されます。</p>
3262
3263     <p>このような挙動が便利な例は、イントラネットのサーバで <code>www</code>
3264     のような短い名前でユーザがマシンに接続するときです。
3265     ユーザの入力で短いホスト名が使われていて、URL が<em>最後のスラッシュ無しの</em>
3266     ディレクトリになっている <code>http://www/splat</code> のようなとき、
3267     Apache はリクエストを <code>http://www.domain.com/splat/</code> 
3268     へリダイレクトします。
3269     認証をするように設定していると、この場合
3270     ユーザは 2 回認証をしなければならなくなります (<code>www</code> に
3271     対して 1 回、<code>www.domain.com</code> に対してもう 1 回 -- 
3272     詳細は <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">この話題の
3273     FAQ</a> を参照してください)。
3274     しかし <code class="directive">UseCanonicalName</code> が <code>Off</code> になっていると、
3275     Apache は <code>http://www/splat/</code> にリダイレクトします。</p>
3276
3277     <p>三つ目のオプション <code>UseCanonicalName DNS</code> は、
3278     大規模な IP ベースのバーチャルホスティングで、
3279     <code>Host:</code> ヘッダを提供しない古いクライアントを
3280     サポートする場合を想定しています。
3281     このオプションでは Apache は、クライアントが接続した IP アドレスに対して
3282     DNS の逆引きを行なって、自己参照 URL を作成します。</p>
3283
3284     <div class="warning"><h3>警告</h3>
3285     <p>CGI が <code>SERVER_NAME</code> に関して何らかの前提条件を
3286     仮定しているときには、このオプションの設定によっては動作しなく
3287     なるかもしれません。クライアントは実質的にはホスト名として
3288     何でも望みの値を指定することができます。CGI が
3289     <code>SERVER_NAME</code> を使って自己参照 URL を作成することしかしない
3290     場合は、どの設定を行なっても大丈夫なはずです。</p></div>
3291
3292 <h3>参照</h3>
3293 <ul>
3294 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
3295 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3296 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3297 </ul>
3298 </div>
3299 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3300 <div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">ディレクティブ</a></h2>
3301 <table class="directive">
3302 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>自分自身の名前とポート番号を解決する方法を設定する
3303 </td></tr>
3304 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
3305 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
3306 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
3307 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3308 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3309 </table>
3310     <p>さまざまな局面で <em>自己参照</em> URL -- それ自体のサーバを参照する URL
3311     を作ることになります。<code>UseCanonicalPhysicalPort On</code> と設定すると、
3312     <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> に従って別名を
3313     生成する場合に、実際の物理ポート番号を使って構成するようになります。
3314     <code>UseCanonicalPhysicalPort Off</code> の場合は、実際の物理ポート番号は
3315     使用せず、設定された情報を元にポート番号を決めます。</p>
3316
3317     <div class="note"><h3>注意</h3>
3318     <p>物理ポートが使われる場合の順番は次のようになっています:<br /><br />
3319      <code>UseCanonicalName On</code></p>
3320      <ul>
3321       <li><code>ServerName</code> で指定されているポート番号</li>
3322       <li>物理ポート番号</li>
3323       <li>デフォルトのポート番号</li>
3324      </ul>
3325      <code>UseCanonicalName Off | DNS</code>
3326      <ul>
3327       <li><code>Host:</code> ヘッダをパースして取得されるポート番号</li>
3328       <li>物理ポート番号</li>
3329       <li><code>ServerName</code> で指定されているポート番号</li>
3330       <li>デフォルトのポート番号</li>
3331      </ul>
3332     
3333     <p><code>UseCanonicalPhysicalPort Off</code> で、
3334     物理ポート番号が上記の順序付けから除外されます。</p>
3335     </div>
3336
3337
3338 <h3>参照</h3>
3339 <ul>
3340 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
3341 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3342 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3343 </ul>
3344 </div>
3345 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3346 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a> <a name="virtualhost" id="virtualhost">ディレクティブ</a></h2>
3347 <table class="directive">
3348 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>特定のホスト名や IP アドレスのみに適用されるディレクティブを
3349 囲む</td></tr>
3350 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;VirtualHost
3351     <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
3352     ...&gt; ... &lt;/VirtualHost&gt;</code></td></tr>
3353 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
3354 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
3355 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
3356 </table>
3357     <p><code class="directive">&lt;VirtualHost&gt;</code> 及び
3358     <code>&lt;/VirtualHost&gt;</code> は、
3359     特定のバーチャルホストに対してのみ適用されるディレクティブ群を括る
3360     ために使われます。
3361     バーチャルホストコンテキストで許可される全てのディレクティブを指定可能です。
3362     サーバが、指定されたバーチャルホストにあるドキュメントへの
3363     リクエストを受け付けた場合、
3364     <code class="directive">&lt;VirtualHost&gt;</code> セクションの中にある
3365     ディレクティブが適用されます。
3366     <var>Addr</var>は、次のものが利用できます:</p>
3367
3368     <ul>
3369       <li>バーチャルホストの IP アドレス</li>
3370
3371       <li>バーチャルホストの IP に対応する完全なドメイン名 (非推奨)</li>
3372
3373       <li><code>NameVirtualHost *</code> と共に使われる、
3374       すべての IP アドレスにマッチする文字 <code>*</code></li>
3375
3376       <li>IP ベースのバーチャルホストで他のものにマッチしない IP アドレス
3377       のための文字列 <code>_default_</code></li>
3378     </ul>
3379
3380     <div class="example"><h3>例</h3><p><code>
3381       &lt;VirtualHost 10.1.2.3&gt;<br />
3382       <span class="indent">
3383         ServerAdmin webmaster@host.example.com<br />
3384         DocumentRoot /www/docs/host.example.com<br />
3385         ServerName host.example.com<br />
3386         ErrorLog logs/host.example.com-error_log<br />
3387         TransferLog logs/host.example.com-access_log<br />
3388       </span>
3389       &lt;/VirtualHost&gt;
3390     </code></p></div>
3391  
3392     <p>IPv6 アドレスはオプションのポート番号の指定と区別するために、
3393     角括弧で括って指定する必要があります。次は IPv6 の例です:</p>
3394
3395     <div class="example"><p><code>
3396       &lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
3397       <span class="indent">
3398         ServerAdmin webmaster@host.example.com<br />
3399         DocumentRoot /www/docs/host.example.com<br />
3400         ServerName host.example.com<br />
3401         ErrorLog logs/host.example.com-error_log<br />
3402         TransferLog logs/host.example.com-access_log<br />
3403       </span>
3404       &lt;/VirtualHost&gt;
3405     </code></p></div>
3406
3407     <p>各々のバーチャルホストにはそれぞれ違う IP アドレス、ポート番号
3408     もしくはホスト名に対応する必要があり、
3409     1 番目の場合には複数のアドレスで IP パケットを受信できるように
3410     サーバマシンを設定しなければなりません。
3411     (もし、マシンが複数のネットワークインターフェースを持たない場合は、
3412     (OSがサポートしていれば) <code>ifconfig alias</code> コマンドにより
3413     達成できます)。</p>
3414
3415     <div class="note"><h3>注意点</h3>
3416     <p><code class="directive">&lt;VirtualHost&gt;</code> は Apache が Listen する
3417     IP アドレスには影響を与え<strong>ません</strong>。
3418     <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> を
3419     使って Apache が正しいアドレスを listen するように設定する必要があります。</p>
3420     </div>
3421
3422     <p>IP ベースのバーチャルホストを使っている場合は、特別な名前
3423     <code>_default_</code> を指定することができます。その場合は
3424     そのバーチャルホストは他のバーチャルホストで明示的に挙げられていない
3425     すべての IP アドレスにマッチします。<code>_default_</code> バーチャルホストが無い
3426     場合に IP がバーチャルホストで指定されたものにマッチしないときは、
3427     VirtualHost セクションの外のすべての定義からなる「主」サーバ設定が
3428     使われます。(ただし、<code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> ディレクティブにマッチする
3429     すべての IP アドレスは「主」サーバ設定も <code>_default_</code> バーチャルホストも
3430     使わないことに注意してください。詳しくは <a href="../vhosts/name-based.html">ネームベースのバーチャルホスト</a> を
3431     参照してください。)</p>
3432
3433     <p><code>:port</code> といった形式で記述することにより、
3434     マッチさせるポートを変更可能です。
3435     この指定をしない場合には、主サーバ設定における
3436     一番最後に <code><a href="#port">Port</a></code> で指定されたポートが
3437     デフォルトとなります。
3438     <code>:*</code> を指定することにより、
3439     アドレス上の全てのポートにマッチします。(<code>_default_</code> のときは
3440     これを使うことが推奨されています。)</p>
3441
3442     <p><code class="directive">&lt;VirtualHost&gt;</code> ブロックごとに
3443     <code class="directive"><a href="#servername">ServerName</a></code> を指定すべきです。
3444     もしなければ、メインサーバ設定の
3445     <code class="directive"><a href="#servername">ServerName</a></code>
3446     が継承されます</p>
3447
3448     <div class="warning"><h3>セキュリティ</h3>
3449     <p>サーバーを起動した以外のユーザがログファイルが保管されるディレクトリに
3450     書き込み可能なときになぜセキュリティが破られる可能性があるかの詳細は
3451     <a href="../misc/security_tips.html">セキュリティに関するコツ</a> を
3452     参照してください。</p></div>
3453
3454 <h3>参照</h3>
3455 <ul>
3456 <li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
3457 <li><a href="../dns-caveats.html">DNS と Apache に関する話</a></li>
3458 <li><a href="../bind.html">Apache が使用するアドレスとポートの設定</a></li>
3459 <li>リクエストを受けた際にこれらの異なるセクションが
3460     組み合わされる方法については <a href="../sections.html">
3461     &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
3462 </ul>
3463 </div>
3464 </div>
3465 <div class="bottomlang">
3466 <p><span>言語: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
3467 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
3468 <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
3469 <a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
3470 <a href="../ja/mod/core.html" title="Japanese">&nbsp;ja&nbsp;</a> |
3471 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
3472 </div><div id="footer">
3473 <p class="apache">Copyright 2012 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>
3474 <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>
3475 </body></html>