core.html.ja.utf8 241 KB
Newer Older
powelld's avatar
powelld committed
3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419 3420 3421 3422 3423 3424 3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 3552 3553 3554 3555 3556 3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 3568 3569 3570 3571 3572 3573 3574 3575 3576 3577 3578 3579 3580 3581 3582 3583 3584 3585 3586 3587 3588 3589 3590 3591 3592 3593 3594 3595 3596 3597 3598 3599 3600 3601 3602 3603 3604 3605 3606 3607 3608 3609 3610 3611 3612 3613 3614 3615 3616 3617 3618 3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629 3630 3631 3632 3633 3634 3635 3636 3637 3638 3639 3640 3641 3642 3643 3644 3645 3646 3647 3648 3649 3650 3651 3652 3653 3654 3655 3656 3657 3658 3659 3660 3661 3662 3663 3664 3665 3666 3667 3668 3669 3670 3671 3672 3673
    使用するホストの別名を指定します。
    適切であれば、<code class="directive">ServerAlias</code> ディレクティブでは
    ワイルドカードを使うこともできます。</p>

    <div class="example"><p><code>
      &lt;VirtualHost *&gt;<br />
      ServerName server.domain.com<br />
      ServerAlias server server2.domain.com server2<br />
      # ...<br />
      &lt;/VirtualHost&gt;
    </code></p></div>

<h3>参照</h3>
<ul>
<li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが自分自身を示すときに使うホスト名とポート</td></tr>
<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>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>このディレクティブはバージョン 2.0 ではバージョン 1.3 の
    <code class="directive">Port</code> ディレクティブの機能も含みます。</td></tr>
</table>
    <p><code class="directive">ServerName</code> ディレクティブは、
    サーバが自分自身を示すスキーム名、ホスト名とポート番号を設定します。
    これは、リダイレクトする URL を生成する際に利用されます。
    例えば、ウェブサーバを動かしているマシンは <code>simple.example.com</code>
    で、DNS のエイリアス <code>www.example.com</code> もあるときに、
    ウェブサーバが後者として認識されて欲しいときは、以下のようにディレクティブを
    使います。</p>

    <div class="example"><p><code>
      ServerName www.example.com:80
    </code></p></div>

    <p><code class="directive">ServerName</code> が指定されていないときは、
    サーバは IP アドレスから逆引きを行なうことでホスト名を知ろうとします。
    <code class="directive">ServerName</code> にポートが指定されていないときは、
    サーバはリクエストが来ている
    ポートを使います。最高の信頼性と確実性をもたらすためには、
    <code class="directive">ServerName</code> を使ってホスト名とポートを明示的に
    指定してください。</p>

    <p><a href="../vhosts/name-based.html">名前ベースのバーチャルホスト</a>
    を利用している場合、<code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> セクション内の
    <code class="directive">ServerName</code> はこのバーチャルホストにマッチするために
    何がリクエストの Host: ヘッダに現れる必要があるのかを指定します。</p>

    <p>SSL を処理するデバイス、例えばリバースプロクシやロードバランサや
    SSL 処理軽減アプライアンスの裏側でサーバが稼動する場合もあるでしょう。
    そういった場合では、クライアントが接続するときに使う
    <code>https://</code> スキームとポート番号を <code class="directive">ServerName</code>
    ディレクティブで指定して、自己参照 URL が正しく生成できるようにします。</p>

    <p>自己参照 URL (例えば <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> モジュールによるものなど)
    が指定されたポートを使うか、クライアントのリクエストのポート番号を使うかを
    決定する設定は <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> 
    ディレクティブと <code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
    ディレクティブを参照してください。</p>


<h3>参照</h3>
<ul>
<li><a href="../dns-caveats.html">DNS と Apache に関する話</a></li>
<li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
<li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>非互換のブラウザが名前ベースのバーチャルホストにアクセスしたときの
ための互換用 URL パス名</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerPath <var>URL-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>バーチャルホスト</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">ServerPath</code> ディレクティブは、<a href="../vhosts/">ネームベースのバーチャルホスト</a>において利用する
    互換用 URL パス名を設定します。</p>

<h3>参照</h3>
<ul>
<li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>インストールされたサーバのベースディレクトリ</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerRoot <var>directory-path</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">ServerRoot</code> ディレクティブは、
    サーバが存在するディレクトリを設定します。
    通常、<code>conf/</code><code>logs/</code> といったサブディレクトリが
    存在します。
    また、他の設定ディレクティブ (例えば <code class="directive"><a href="#include">Include</a></code><code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> など) における相対パスは、
    このディレクトリからの相対位置となります。</p>

    <div class="example"><h3></h3><p><code>
      ServerRoot /home/httpd
    </code></p></div>



<h3>参照</h3>
<ul>
<li><a href="../invoking.html"><code>httpd</code><code>-d</code>
    オプション</a></li>
<li><code class="directive">ServerRoot</code> の権限を適切に設定する方法は<a href="../misc/security_tips.html#serverroot">セキュリティのこつ</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが生成するドキュメントのフッタを設定</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerSignature Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">ServerSignature</code> ディレクティブは、
    サーバが生成するドキュメント
    (エラーメッセージ、<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> における FTP のディレクトリリスト、
    <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> の出力、等々)
    の最下行に付与するフッタの設定を行ないます。
    そのようなフッタ行を有効にしたい理由には、
    プロキシが複数連なっている場合に、ユーザはどのサーバが返した
    エラーメッセージかを知る手段がほとんど無いというものがあります。</p>


    <p>デフォルトである <code>Off</code> に設定をすると、フッタ行が抑制されます
    (そして、Apache-1.2 以前と互換の動作をします)。
    <code>On</code> に設定した場合は、単にドキュメントの中に、サーバのバージョン、
    稼動中のバーチャルホストの <a href="#servername">ServerName</a> の書かれた行を追加し、
    <code>EMail</code> にした場合はさらに参照されたドキュメントに対する <a href="#serveradmin">ServerAdmin</a> を指す "mailto:" が追加されます。</p>

    <p>バージョン 2.0.44 以降では、表示されるサーバーのバージョン番号の詳細は<code class="directive"><a href="#servertokens">ServerTokens</a></code>
    ディレクティブにより制御されます。</p>

<h3>参照</h3>
<ul>
<li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>Server</code> HTTP 応答ヘッダを設定する</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ServerTokens Full</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p>このディレクティブは、クライアントに送り返す <code>Server</code>
    応答ヘッダ内に、サーバの一般的な OS 種別や、
    コンパイルされて組み込まれているモジュールの情報を
    含めるかどうかを指定します。</p>

    <dl>
      <dt><code>ServerTokens Prod[uctOnly]</code></dt>

      <dd>サーバは (例えば): <code>Server:
      Apache</code> といったように送ります。</dd>

      <dt><code>ServerTokens Major</code></dt>

      <dd>Server sends (<em>e.g.</em>): <code>Server:
      Apache/2</code></dd>

      <dt><code>ServerTokens Minor</code></dt>

      <dd>Server sends (<em>e.g.</em>): <code>Server:
      Apache/2.0</code></dd>

      <dt><code>ServerTokens Min[imal]</code></dt>

      <dd>サーバは (例えば): <code>Server:
      Apache/2.0.41</code> といったように送ります。</dd>

      <dt><code>ServerTokens OS</code></dt>

      <dd>サーバは (例えば): <code>Server: Apache/2.0.41
      (Unix)</code> といったように送ります。</dd>

      <dt><code>ServerTokens Full</code> (もしくは未指定)</dt>

      <dd>サーバは (例えば): <code>Server: Apache/2.0.41
      (Unix) PHP/4.2.2 MyMod/1.2</code> といったように送ります。</dd>
    </dl>

    <p>この設定はサーバ全体に適用され、バーチャルホスト上で有効にしたり
    無効にしたりはできません。</p>

    <p>バージョン 2.0.44 以降ではこのディレクティブは <code class="directive"><a href="#serversignature">ServerSignature</a></code>
    ディレクティブにより表示される情報も制御します。</p>

<h3>参照</h3>
<ul>
<li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>マッチするファイルがハンドラで処理されるようにする</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetHandler <var>handler-name</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 で core に移動</td></tr>
</table>
    <p><code>.htaccess</code><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
    セクション、<code class="directive"><a href="#location">&lt;Location&gt;</a></code>
    セクションに書かれた場合、
    このディレクティブはそこにあるすべてのファイルが
    <var>handler-name</var> で指定された<a href="../handler.html">ハンドラ</a>で扱われることを強制します。例えば、拡張子に関わらず、
    ディレクトリ全体がイメージマップファイルとして解析して欲しい場合には、
    以下をそのディレクトリの <code>.htaccess</code>
    ファイルに記述します:</p>

    <div class="example"><p><code>
      SetHandler imap-file
    </code></p></div>

    <p>別の例: URL <code>http://servername/status</code>
    が指定されたときにサーバが状態報告をするようにしたいときは、以下を
    <code>httpd.conf</code> に記述します:</p>

    <div class="example"><p><code>
      &lt;Location /status&gt;<br />
      <span class="indent">
        SetHandler server-status<br />
      </span>
      &lt;/Location&gt;
    </code></p></div>

    <p><code>None</code> という値を設定することで、
    前の方の <code class="directive">SetHandler</code> で定義された設定を無効にすることが
    できます。</p>
    <p><strong>注意:</strong>SetHandler はデフォルトのハンドラをオーバーライド
    しますので、通常の挙動、たとえば、スラッシュ (/) で終わる URL が
    リクエストされたときにディレクトリやインデックスファイルを返すよう取り扱う挙動は、
    行われなくなります。
    </p>


<h3>参照</h3>
<ul>
<li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>クライアントのリクエストや POST の入力を処理するフィルタを設定する</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetInputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">SetInputFilter</code> ディレクティブはクライアントの
    リクエストや POST の入力をサーバが受け取ったときに処理するフィルタを
    設定します。これは <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>
    ディレクティブを含め、他の場所で定義されているフィルタの設定に
    追加されます。</p>

    <p>複数のフィルタを指定するときは、データを処理する順番に
    セミコロンで区切る必要があります。</p>


<h3>参照</h3>
<ul>
<li><a href="../filter.html">フィルタ</a>説明書</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバの応答を処理するフィルタを設定する</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>SetOutputFilter <var>filter</var>[;<var>filter</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">上書き:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">SetOutputFilter</code> ディレクティブは
    サーバの応答をクライアントに送り返される前に処理するフィルタを設定します。
    これは <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>
    ディレクティブを含め、他の場所で定義されているフィルタの設定に
    追加されます。</p>    

    <p>例えば、以下の設定は <code>/www/data/</code> ディレクトリのすべての
    ファイルを SSI で処理します。</p>

    <div class="example"><p><code>
      &lt;Directory /www/data/&gt;<br />
      <span class="indent">
        SetOutputFilter INCLUDES<br />
      </span>
      &lt;/Directory&gt;
    </code></p></div>

    <p>複数のフィルタを指定するときは、データを処理する順番に
    セミコロンで区切る必要があります。</p>

<h3>参照</h3>
<ul>
<li><a href="../filter.html">フィルタ</a>説明書</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>各イベントについて、リクエストを失敗させるまでにサーバが
待つ時間を設定</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TimeOut <var>seconds</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>TimeOut 60</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">TimeOut</code> ディレクティブは、
    様々な条件下での I/O 待ち時間を定義します:</p>

    <ol>
      <li>クライアントからのデータを読み込む時。
      受信バッファが空になっていて、TCP パケットが届くまで
      待つ時間の長さ</li>

      <li>クライアントに対してデータを送り出す時。
      送信バッファがいっぱいで、パケットの受信完了 <span class="transnote">(<em>訳注:</em> ACK)</span> 
      が届くまで待つ時間の長さ</li>

      <li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> 内で、CGI スクリプトが出力を
      返すまでの待ち時間の長さ</li>

      <li><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> 内で、フィルタ処理で出力を
      待つ時間の長さ</li>

      <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> 内で、
      <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code>
      が設定されていない場合のデフォルトの待ち時間</li>
    </ol>


</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td><code>TRACE</code> メソッドのリクエストに対する応答方法を決める
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>TraceEnable on</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 1.3.34, 2.0.55 以降</td></tr>
</table>
    <p>Apache のコア機能<span class="transnote">(<em>訳注:</em> <code class="module"><a href="../mod/core.html">core</a></code>)</span>
    <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> 両方の <code>TRACE</code>
    の挙動をオーバーライドします。デフォルトの <code>TraceEnable on</code>
    は、リクエストボディを受け入れないような、RFC2616 に準拠した
    <code>TRACE</code> リクエストを受け付けます。
    <code>TraceEnable off</code> と設定すると、コアサーバと
    <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code><code>405</code> (メソッド不許可)
    エラーをクライアントに返します。</p>

    <p>最後に、テストや調査目的などの限定用途として、仕様に準拠しない
    <code>TraceEnable extended</code> を使って、リクエストボディを
    受け付けるように挙動を変更できます。(オリジンサーバとしての)
    Apache のコアでは、リクエストボディのサイズは 64k (
    <code>Transfer-Encoding: chunked</code> が使われている場合は 
    chunk ヘッダ用に +8k) に制限されます。
    Apache のコアは、ヘッダと全ての chunk ヘッダをレスポンスの
    ボディとして返却します。
    proxy サーバとしては、リクエストボディのサイズは 64k に制限されません。</p>

</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Undefine the existence of a variable</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UnDefine <var>parameter-name</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table><p>このディレクティブの解説文書は
            まだ翻訳されていません。英語版をご覧ください。
            </p><h3>参照</h3>
<ul>
<li><code class="directive"><a href="#define">Define</a></code></li>
<li><code class="directive"><a href="#ifdefine">IfDefine</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>サーバが自分自身の名前とポートを決定する方法を設定する</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UseCanonicalName On|Off|Dns</code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>UseCanonicalName Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p>多くの状況で Apache は<em>自己参照</em> URL、すなわち
    同じサーバを指す URL、を作成する必要があります。
    <code>UseCanonicalName On</code> の場合は、<code class="directive"><a href="#servername">ServerName</a></code> ディレクティブで指定されている
    ホスト名とポート番号を使って、その正規名 (自己参照の名前) を生成します。
    この名前は、すべての自己参照 URL で使われますし、CGI の 
    <code>SERVER_NAME</code><code>SERVER_PORT</code> でも使われます。</p>

    <p><code>UseCanonicalName Off</code> の場合、
    クライアントがホスト名とポートを指定したときには、
    それらを元に自己参照 URL を作成します (指定がなかったときは
    上の定義と同様にして正規名を解決します)。
    これらの値は<a href="../vhosts/name-based.html">名前ベースの
    バーチャルホスト</a>を実装で使われているのと同じ値で、
    同じクライアントで取得できる値になっています。
    CGI 変数 <code>SERVER_NAME</code><code>SERVER_PORT</code> 
    もクライアントから与えられた値から作成されます。</p>

    <p>このような挙動が便利な例は、イントラネットのサーバで <code>www</code>
    のような短い名前でユーザがマシンに接続するときです。
    ユーザの入力で短いホスト名が使われていて、URL が<em>最後のスラッシュ無しの</em>
    ディレクトリになっている <code>http://www/splat</code> のようなとき、
    Apache はリクエストを <code>http://www.domain.com/splat/</code> 
    へリダイレクトします。
    認証をするように設定していると、この場合
    ユーザは 2 回認証をしなければならなくなります (<code>www</code>
    対して 1 回、<code>www.domain.com</code> に対してもう 1 回 -- 
    詳細は <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">この話題の
    FAQ</a> を参照してください)。
    しかし <code class="directive">UseCanonicalName</code><code>Off</code> になっていると、
    Apache は <code>http://www/splat/</code> にリダイレクトします。</p>

    <p>三つ目のオプション <code>UseCanonicalName DNS</code> は、
    大規模な IP ベースのバーチャルホスティングで、
    <code>Host:</code> ヘッダを提供しない古いクライアントを
    サポートする場合を想定しています。
    このオプションでは Apache は、クライアントが接続した IP アドレスに対して
    DNS の逆引きを行なって、自己参照 URL を作成します。</p>

    <div class="warning"><h3>警告</h3>
    <p>CGI が <code>SERVER_NAME</code> に関して何らかの前提条件を
    仮定しているときには、このオプションの設定によっては動作しなく
    なるかもしれません。クライアントは実質的にはホスト名として
    何でも望みの値を指定することができます。CGI が
    <code>SERVER_NAME</code> を使って自己参照 URL を作成することしかしない
    場合は、どの設定を行なっても大丈夫なはずです。</p></div>

<h3>参照</h3>
<ul>
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>自分自身の名前とポート番号を解決する方法を設定する
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p>さまざまな局面で <em>自己参照</em> URL -- それ自体のサーバを参照する URL
    を作ることになります。<code>UseCanonicalPhysicalPort On</code> と設定すると、
    <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> に従って別名を
    生成する場合に、実際の物理ポート番号を使って構成するようになります。
    <code>UseCanonicalPhysicalPort Off</code> の場合は、実際の物理ポート番号は
    使用せず、設定された情報を元にポート番号を決めます。</p>

    <div class="note"><h3>注意</h3>
    <p>物理ポートが使われる場合の順番は次のようになっています:<br /><br />
     <code>UseCanonicalName On</code></p>
     <ul>
      <li><code>ServerName</code> で指定されているポート番号</li>
      <li>物理ポート番号</li>
      <li>デフォルトのポート番号</li>
     </ul>
     <code>UseCanonicalName Off | DNS</code>
     <ul>
      <li><code>Host:</code> ヘッダをパースして取得されるポート番号</li>
      <li>物理ポート番号</li>
      <li><code>ServerName</code> で指定されているポート番号</li>
      <li>デフォルトのポート番号</li>
     </ul>
    
    <p><code>UseCanonicalPhysicalPort Off</code> で、
    物理ポート番号が上記の順序付けから除外されます。</p>
    </div>


<h3>参照</h3>
<ul>
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a> <a name="virtualhost" id="virtualhost">ディレクティブ</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>特定のホスト名や IP アドレスのみに適用されるディレクティブを
囲む</td></tr>
<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;VirtualHost
    <var>addr</var>[:<var>port</var>] [<var>addr</var>[:<var>port</var>]]
    ...&gt; ... &lt;/VirtualHost&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>core</td></tr>
</table>
    <p><code class="directive">&lt;VirtualHost&gt;</code> 及び
    <code>&lt;/VirtualHost&gt;</code> は、
    特定のバーチャルホストに対してのみ適用されるディレクティブ群を括る
    ために使われます。
    バーチャルホストコンテキストで許可される全てのディレクティブを指定可能です。
    サーバが、指定されたバーチャルホストにあるドキュメントへの
    リクエストを受け付けた場合、
    <code class="directive">&lt;VirtualHost&gt;</code> セクションの中にある
    ディレクティブが適用されます。
    <var>Addr</var>は、次のものが利用できます:</p>

    <ul>
      <li>バーチャルホストの IP アドレス</li>

      <li>バーチャルホストの IP に対応する完全なドメイン名 (非推奨)</li>

      <li><code>NameVirtualHost *</code> と共に使われる、
      すべての IP アドレスにマッチする文字 <code>*</code></li>

      <li>IP ベースのバーチャルホストで他のものにマッチしない IP アドレス
      のための文字列 <code>_default_</code></li>
    </ul>

    <div class="example"><h3></h3><p><code>
      &lt;VirtualHost 10.1.2.3&gt;<br />
      <span class="indent">
        ServerAdmin webmaster@host.example.com<br />
        DocumentRoot /www/docs/host.example.com<br />
        ServerName host.example.com<br />
        ErrorLog logs/host.example.com-error_log<br />
        TransferLog logs/host.example.com-access_log<br />
      </span>
      &lt;/VirtualHost&gt;
    </code></p></div>
 
    <p>IPv6 アドレスはオプションのポート番号の指定と区別するために、
    角括弧で括って指定する必要があります。次は IPv6 の例です:</p>

    <div class="example"><p><code>
      &lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
      <span class="indent">
        ServerAdmin webmaster@host.example.com<br />
        DocumentRoot /www/docs/host.example.com<br />
        ServerName host.example.com<br />
        ErrorLog logs/host.example.com-error_log<br />
        TransferLog logs/host.example.com-access_log<br />
      </span>
      &lt;/VirtualHost&gt;
    </code></p></div>

    <p>各々のバーチャルホストにはそれぞれ違う IP アドレス、ポート番号
    もしくはホスト名に対応する必要があり、
    1 番目の場合には複数のアドレスで IP パケットを受信できるように
    サーバマシンを設定しなければなりません。
    (もし、マシンが複数のネットワークインターフェースを持たない場合は、
    (OSがサポートしていれば) <code>ifconfig alias</code> コマンドにより
    達成できます)。</p>

    <div class="note"><h3>注意点</h3>
    <p><code class="directive">&lt;VirtualHost&gt;</code> は Apache が Listen する
    IP アドレスには影響を与え<strong>ません</strong>
    <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>
    使って Apache が正しいアドレスを listen するように設定する必要があります。</p>
    </div>

    <p>IP ベースのバーチャルホストを使っている場合は、特別な名前
    <code>_default_</code> を指定することができます。その場合は
    そのバーチャルホストは他のバーチャルホストで明示的に挙げられていない
    すべての IP アドレスにマッチします。<code>_default_</code> バーチャルホストが無い
    場合に IP がバーチャルホストで指定されたものにマッチしないときは、
    VirtualHost セクションの外のすべての定義からなる「主」サーバ設定が
    使われます。(ただし、<code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> ディレクティブにマッチする
    すべての IP アドレスは「主」サーバ設定も <code>_default_</code> バーチャルホストも
    使わないことに注意してください。詳しくは <a href="../vhosts/name-based.html">ネームベースのバーチャルホスト</a>
    参照してください。)</p>

    <p><code>:port</code> といった形式で記述することにより、
    マッチさせるポートを変更可能です。
    この指定をしない場合には、主サーバ設定における
    一番最後に <code><a href="#port">Port</a></code> で指定されたポートが
    デフォルトとなります。
    <code>:*</code> を指定することにより、
    アドレス上の全てのポートにマッチします。(<code>_default_</code> のときは
    これを使うことが推奨されています。)</p>

    <p><code class="directive">&lt;VirtualHost&gt;</code> ブロックごとに
    <code class="directive"><a href="#servername">ServerName</a></code> を指定すべきです。
    もしなければ、メインサーバ設定の
    <code class="directive"><a href="#servername">ServerName</a></code>
    が継承されます</p>

    <div class="warning"><h3>セキュリティ</h3>
    <p>サーバーを起動した以外のユーザがログファイルが保管されるディレクトリに
    書き込み可能なときになぜセキュリティが破られる可能性があるかの詳細は
    <a href="../misc/security_tips.html">セキュリティに関するコツ</a>
    参照してください。</p></div>

<h3>参照</h3>
<ul>
<li><a href="../vhosts/">Apache バーチャルホスト説明書</a></li>
<li><a href="../dns-caveats.html">DNS と Apache に関する話</a></li>
<li><a href="../bind.html">Apache が使用するアドレスとポートの設定</a></li>
<li>リクエストを受けた際にこれらの異なるセクションが
    組み合わされる方法については <a href="../sections.html">
    &lt;Directory&gt;, &lt;Location&gt;, &lt;Files&gt; セクションの動作法</a></li>
</ul>
</div>
</div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
<a href="../fr/mod/core.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/core.html" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/core.html';
(function(w, d) {
    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
        d.write('<div id="comments_thread"><\/div>');
        var s = d.createElement('script');
        s.type = 'text/javascript';
        s.async = true;
        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
    }
    else { 
        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
    }
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2017 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
    prettyPrint();
}
//--><!]]></script>
</body></html>