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