Blame docs/manual/mod/mod_negotiation.html.ja.utf8

Packit 90a5c9
Packit 90a5c9
Packit 90a5c9
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head>
Packit 90a5c9
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
Packit 90a5c9
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
              This file is generated from xml source: DO NOT EDIT
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
      -->
Packit 90a5c9
<title>mod_negotiation - Apache HTTP サーバ バージョン 2.4</title>
Packit 90a5c9
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
Packit 90a5c9
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
Packit 90a5c9
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
Packit 90a5c9
<script src="../style/scripts/prettify.min.js" type="text/javascript">
Packit 90a5c9
</script>
Packit 90a5c9
Packit 90a5c9
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
Packit 90a5c9
<body>
Packit 90a5c9
Packit 90a5c9

モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

Packit 90a5c9

Apache HTTP サーバ バージョン 2.4

Packit 90a5c9
Packit 90a5c9
<-
Packit 90a5c9
Packit 90a5c9
Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4 > モジュール
Packit 90a5c9
Packit 90a5c9

Apache モジュール mod_negotiation

Packit 90a5c9
Packit 90a5c9

翻訳済み言語:  en  |

Packit 90a5c9
 fr  |
Packit 90a5c9
 ja 

Packit 90a5c9
Packit 90a5c9
この日本語訳はすでに古くなっている
Packit 90a5c9
            可能性があります。
Packit 90a5c9
            最近更新された内容を見るには英語版をご覧下さい。
Packit 90a5c9
        
Packit 90a5c9
説明:コンテントネゴシエーション
Packit 90a5c9
  機能を提供する
Packit 90a5c9
ステータス:Base
Packit 90a5c9
モジュール識別子:negotiation_module
Packit 90a5c9
ソースファイル:mod_negotiation.c
Packit 90a5c9

概要

Packit 90a5c9
Packit 90a5c9
    

コンテントネゴシエーション、より正確にはコンテンツの選択機能は、

Packit 90a5c9
    複数用意されているドキュメントから、クライアントの能力に一番合った
Packit 90a5c9
    ドキュメントを選択する機能です。この実装は二つあります。

Packit 90a5c9
Packit 90a5c9
    
    Packit 90a5c9
          
  • タイプマップ (type-map
  • Packit 90a5c9
          ハンドラで扱われるファイル)。これは variants
    Packit 90a5c9
          を含んでいるファイルを明示的に指定します。
    Packit 90a5c9
    Packit 90a5c9
          
  • MultiViews の探索 (MultiViews Option で有効になります)。
  • Packit 90a5c9
          サーバが暗黙の内にファイル名のパターンマッチを行ない、
    Packit 90a5c9
          その結果から選択します。
    Packit 90a5c9
        
    Packit 90a5c9
    Packit 90a5c9
    Support Apache!

    トピック

    Packit 90a5c9
      Packit 90a5c9
    • タイプマップ
    • Packit 90a5c9
    • MultiViews
    • Packit 90a5c9

      ディレクティブ

      Packit 90a5c9
        Packit 90a5c9
      • CacheNegotiatedDocs
      • Packit 90a5c9
      • ForceLanguagePriority
      • Packit 90a5c9
      • LanguagePriority
      • Packit 90a5c9
        Packit 90a5c9

        Bugfix checklist

        参照

        Packit 90a5c9
          Packit 90a5c9
        • Options
        • Packit 90a5c9
        • mod_mime
        • Packit 90a5c9
        • コンテントネゴシエーション
        • Packit 90a5c9
        • 環境変数
        • Packit 90a5c9
        • コメント
        • Packit 90a5c9
          top
          Packit 90a5c9
          Packit 90a5c9

          タイプマップ

          Packit 90a5c9
              

          タイプマップは RFC 822 のメールヘッダに類似した書式です。

          Packit 90a5c9
              ドキュメントの記述が空行で分離されて書かれていて、ハッシュ文字
          Packit 90a5c9
              ('#') で始まる行はコメントとして扱われます。
          Packit 90a5c9
              ドキュメントの説明は複数のヘッダレコードから構成されます。
          Packit 90a5c9
              レコードは、続きの行が空白で始まっていると複数の行にまたがります。
          Packit 90a5c9
              最初の空白が消去されて、前の行とつなげて 1 行として扱われます。
          Packit 90a5c9
              ヘッダレコードはキーワード名の後に値が続くという形式で、
          Packit 90a5c9
              キーワード名は常にコロンで終わります。空白はヘッダ名と値の間、
          Packit 90a5c9
              値のトークンの間に入れることができます。
          Packit 90a5c9
              使用可能なヘッダは以下のとおりです:

          Packit 90a5c9
          Packit 90a5c9
              
          Packit 90a5c9
                
          Content-Encoding:
          Packit 90a5c9
                
          ファイルのエンコーディング。Apache は AddEncoding ディレクティブ
          Packit 90a5c9
                で定義されたエンコーディングだけを認識します。通常 compress
          Packit 90a5c9
                されたファイルのための x-compress と gzip
          Packit 90a5c9
                されたファイルのための x-gzip を含みます。
          Packit 90a5c9
                エンコーディングの比較をするときは、接頭辞 x-
          Packit 90a5c9
                は無視されます。
          Packit 90a5c9
          Packit 90a5c9
                
          Content-Language:
          Packit 90a5c9
                
          インターネット標準の言語タグ
          Packit 90a5c9
                (RFC 1766)
          Packit 90a5c9
                で定義されている言語の種類。例えば、en
          Packit 90a5c9
                は英語を表します。
          Packit 90a5c9
                複数の言語が格納される場合はコンマで区切られます。
          Packit 90a5c9
          Packit 90a5c9
                
          Content-Length:
          Packit 90a5c9
                
          ファイルの長さ (バイト数)。
          Packit 90a5c9
                このヘッダがない場合、ファイルの実際の長さが使用されます。
          Packit 90a5c9
          Packit 90a5c9
                
          Content-Type:
          Packit 90a5c9
                
          ドキュメントの MIME
          Packit 90a5c9
                メディアタイプ、オプショナルなパラメータ付き。パラメータの構文は
          Packit 90a5c9
                name=value
          Packit 90a5c9
                で、メディアタイプや他のパラメータとはセミコロンで分離されます。
          Packit 90a5c9
                共通のパラメータは以下のとおり:
          Packit 90a5c9
          Packit 90a5c9
                  
          Packit 90a5c9
                    
          level
          Packit 90a5c9
                    
          メディアタイプのバージョンを示す整数。
          Packit 90a5c9
                    text/html では 2 がデフォルトで、その他の場合は
          Packit 90a5c9
                    0 がデフォルトです。
          Packit 90a5c9
          Packit 90a5c9
                    
          qs
          Packit 90a5c9
                    
          クライアントの能力に関係なく、variant
          Packit 90a5c9
                    を他と比較したときの相対的な「品質」で、0.0 から 1.0
          Packit 90a5c9
                    の範囲の浮動点小数。
          Packit 90a5c9
                    例えば、写真を表現しようとしているときは普通は JPEG
          Packit 90a5c9
                    ファイルの方が ASCII ファイルよりも高い品質になります。
          Packit 90a5c9
                    しかし、リソースが ASCII アートで表現されているときは、ASCII
          Packit 90a5c9
                    ファイルの方が JPEG
          Packit 90a5c9
                    ファイルよりも高い品質になります。このように、qs
          Packit 90a5c9
                    はリソース毎に特有の値を取ります。
          Packit 90a5c9
                    
          Packit 90a5c9
                  
          Packit 90a5c9
          Packit 90a5c9
                  

          Packit 90a5c9
                    Content-Type: image/jpeg; qs=0.8
          Packit 90a5c9
                  

          Packit 90a5c9
                
          Packit 90a5c9
          Packit 90a5c9
                
          URI:
          Packit 90a5c9
                
          (指定のメディアタイプ、コンテントエンコーディングの) variant の
          Packit 90a5c9
                ファイルの uri.  これは、マップファイルからの相対 URL として
          Packit 90a5c9
                解釈されます。同じサーバに存在しなければならず、クライアントが
          Packit 90a5c9
                直接リクエストしたときにアクセスを許可されるものでなければなりません。
          Packit 90a5c9
          Packit 90a5c9
                
          Body:
          Packit 90a5c9
                
          Apache 2.0 で新設されたこの Body ヘッダを使って、
          Packit 90a5c9
                リソースの実際の内容をタイプマップファイルに書くことができます。
          Packit 90a5c9
                このヘッダは本文の内容の区切りとなる文字列で始まる必要があります。
          Packit 90a5c9
                タイプマップファイルの続く行は、区切り文字列が見つかるまで、
          Packit 90a5c9
                リソースの本文になります。
          Packit 90a5c9
          Packit 90a5c9
                

          Example:

          Packit 90a5c9
                  Body:----xyz----
          Packit 90a5c9
                  <html>
          Packit 90a5c9
                  <body>
          Packit 90a5c9
                  <p>Content of the page.</p>
          Packit 90a5c9
                  </body>
          Packit 90a5c9
                  </html>
          Packit 90a5c9
                  ----xyz----
          Packit 90a5c9
                

          Packit 90a5c9
                
          Packit 90a5c9
              
          Packit 90a5c9
          top
          Packit 90a5c9
          Packit 90a5c9

          MultiViews

          Packit 90a5c9
              

          MultiViews 探索は、Multiviews Options ディレクティブにより有効になります。

          Packit 90a5c9
              サーバが /some/dir/foo
          Packit 90a5c9
              へのリクエストを受け取り、/some/dir/foo が存在
          Packit 90a5c9
              しない場合、サーバはディレクトリを読んで、
          Packit 90a5c9
              foo.* にあてはまる全てのファイルを探し、
          Packit 90a5c9
              事実上それらのファイルをマップするタイプマップを作ります。
          Packit 90a5c9
              そのとき、メディアタイプとコンテントエンコーディングは、
          Packit 90a5c9
              そのファイル名を直接指定したときと同じものが割り当てられます。
          Packit 90a5c9
              それからクライアントの要求に一番合うものを選び、
          Packit 90a5c9
              そのドキュメントを返します。

          Packit 90a5c9
          Packit 90a5c9
              

          ファイルを選択する際に、関連するコンテントネゴシエーションの

          Packit 90a5c9
              メタ情報を持たないファイルについて、判定を行うかどうかを
          Packit 90a5c9
              MultiViewsMatch
          Packit 90a5c9
              ディレクティブで設定します。

          Packit 90a5c9
          Packit 90a5c9
          top
          Packit 90a5c9
          Packit 90a5c9
          Packit 90a5c9
          説明:コンテントネゴシエーションされたドキュメントをプロキシサーバが
          Packit 90a5c9
          キャッシュできるようにする
          Packit 90a5c9
          構文:CacheNegotiatedDocs On|Off
          Packit 90a5c9
          デフォルト:CacheNegotiatedDocs Off
          Packit 90a5c9
          コンテキスト:サーバ設定ファイル, バーチャルホスト
          Packit 90a5c9
          ステータス:Base
          Packit 90a5c9
          モジュール:mod_negotiation
          Packit 90a5c9
          互換性:バージョン 2.0で構文が変わりました
          Packit 90a5c9
          Packit 90a5c9
              

          このディレクティブが設定されていると、コンテントネゴシエーション

          Packit 90a5c9
              をした結果のドキュメントのキャッシュを許可します。
          Packit 90a5c9
              これは、プロキシの後ろにいるクライアントが能力に一番合った
          Packit 90a5c9
              ドキュメントではなく、
          Packit 90a5c9
              キャッシュをより効果的にするものを得る可能性があるということです。

          Packit 90a5c9
          Packit 90a5c9
              

          このディレクティブは HTTP/1.0 ブラウザからのリクエスト

          Packit 90a5c9
              のみに適用されます。HTTP/1.1 は、
          Packit 90a5c9
              交渉されたドキュメントのキャッシュに対してずっとよい制御が可能なので、
          Packit 90a5c9
              このディレクティブは HTTP/1.1 のリクエストには影響しません。

          Packit 90a5c9
              

          2.0 より前のバージョンでは、

          Packit 90a5c9
              CacheNegotiatedDocs は引数を取らず、
          Packit 90a5c9
              ディレクティブが存在することで on の動作をしていました。

          Packit 90a5c9
          Packit 90a5c9
          Packit 90a5c9
          top
          Packit 90a5c9
          Packit 90a5c9
          Packit 90a5c9
          説明:要求に合う単独のドキュメントが見つからなかったときに行なうことを指定
          Packit 90a5c9
          Packit 90a5c9
          構文:ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]
          Packit 90a5c9
          デフォルト:ForceLanguagePriority Prefer
          Packit 90a5c9
          コンテキスト:サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
          Packit 90a5c9
          上書き:FileInfo
          Packit 90a5c9
          ステータス:Base
          Packit 90a5c9
          モジュール:mod_negotiation
          Packit 90a5c9
          互換性:バージョン 2.0.30 以降で使用可能
          Packit 90a5c9
          Packit 90a5c9
              

          ForceLanguagePriority ディレクティブは

          Packit 90a5c9
              要求に合うドキュメントを一つだけ返すことができないときに、
          Packit 90a5c9
              LanguagePriority
          Packit 90a5c9
              ディレクティブを使ってネゴシエーションの結果を返します。

          Packit 90a5c9
          Packit 90a5c9
              

          ForceLanguagePriority Prefer は、同等の選択肢が

          Packit 90a5c9
              いくつかあるときに、HTTP の 300 (MULTIPLE CHOICES) を返す代わりに、
          Packit 90a5c9
              LanguagePriority を使って一つだけドキュメントを返すように
          Packit 90a5c9
              します。以下のディレクティブが指定されていて、ユーザの Accept-Language
          Packit 90a5c9
              ヘッダでは ende の品質が共に
          Packit 90a5c9
              .500 (同じくらい許容) であるときは、
          Packit 90a5c9
              最初にマッチする variant の en が送られます。

          Packit 90a5c9
          Packit 90a5c9
              

          Packit 90a5c9
                LanguagePriority en fr de
          Packit 90a5c9
                ForceLanguagePriority Prefer
          Packit 90a5c9
              

          Packit 90a5c9
          Packit 90a5c9
              

          ForceLanguagePriority Fallback では、HTTP 406

          Packit 90a5c9
              (NOT ACCEPTABLE) を送信する代わりに、
          Packit 90a5c9
              LanguagePriority
          Packit 90a5c9
              が正しい結果を送ります。
          Packit 90a5c9
              以下のディレクティブが指定されていて、ユーザの Accept-Language
          Packit 90a5c9
          es 言語のみを許可していて、さらにそのような variant がないときには、
          Packit 90a5c9
              以下の LanguagePriority
          Packit 90a5c9
              のリストの最初の variant が送られます。

          Packit 90a5c9
          Packit 90a5c9
              

          Packit 90a5c9
                LanguagePriority en fr de
          Packit 90a5c9
                ForceLanguagePriority Fallback
          Packit 90a5c9
              

          Packit 90a5c9
          Packit 90a5c9
              

          PreferFallback の両方のオプションを

          Packit 90a5c9
              同時に指定することができます。
          Packit 90a5c9
              ですから、複数の variant があるときは
          Packit 90a5c9
              LanguagePriority の最初の
          Packit 90a5c9
              variant が送られ、クライアントの許容言語に合う vaiant がないときは
          Packit 90a5c9
              存在するドキュメントで最初のものが送られる、という様にすることができます。

          Packit 90a5c9
          Packit 90a5c9

          参照

          Packit 90a5c9
            Packit 90a5c9
          • AddLanguage
          • Packit 90a5c9
            Packit 90a5c9
            Packit 90a5c9
            top
            Packit 90a5c9
            Packit 90a5c9
            Packit 90a5c9
            説明:クライアントが優先度を示さなかったときの言語の variant の優先度を
            Packit 90a5c9
            指定
            Packit 90a5c9
            構文:LanguagePriority MIME-lang [MIME-lang]
            Packit 90a5c9
            ...
            Packit 90a5c9
            コンテキスト:サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess
            Packit 90a5c9
            上書き:FileInfo
            Packit 90a5c9
            ステータス:Base
            Packit 90a5c9
            モジュール:mod_negotiation
            Packit 90a5c9
            Packit 90a5c9
                

            LanguagePriority は、MultiViews

            Packit 90a5c9
                リクエストを扱うときに、クライアントが優先順位を提供していない場合の
            Packit 90a5c9
                言語の優先順位を設定します。MIME-lang
            Packit 90a5c9
                のリストが優先度の降順に並びます。

            Packit 90a5c9
            Packit 90a5c9
                

            Example:

            Packit 90a5c9
                  LanguagePriority en fr de
            Packit 90a5c9
                

            Packit 90a5c9
            Packit 90a5c9
                

            foo.html がリクエストされ、foo.html.fr

            Packit 90a5c9
            foo.html.de が両方存在し、
            Packit 90a5c9
                ブラウザが言語の優先順位を提供してない場合は
            Packit 90a5c9
                foo.html.fr が返されます。

            Packit 90a5c9
            Packit 90a5c9
                

            このディレクティブは他の方法で「最善」

            Packit 90a5c9
                の言語が決定できないときか、ForceLanguagePriority ディレクティブが
            Packit 90a5c9
                None 以外のときにのみ効果があることに注意してください。
            Packit 90a5c9
                一般的には、サーバ側ではなくクライアント側で好みの言語を決定します。

            Packit 90a5c9
            Packit 90a5c9

            参照

            Packit 90a5c9
              Packit 90a5c9
            • AddLanguage
            • Packit 90a5c9
              Packit 90a5c9
              Packit 90a5c9
              Packit 90a5c9
              Packit 90a5c9

              翻訳済み言語:  en  |

              Packit 90a5c9
               fr  |
              Packit 90a5c9
               ja 

              Packit 90a5c9
              top

              コメント

              Notice:
              This is not a Q&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 mailing lists.
              Packit 90a5c9
              <script type="text/javascript">
              Packit 90a5c9
              var comments_shortname = 'httpd';
              Packit 90a5c9
              var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_negotiation.html';
              Packit 90a5c9
              (function(w, d) {
              Packit 90a5c9
                  if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
              Packit 90a5c9
                      d.write('
              <\/div>');
              Packit 90a5c9
                      var s = d.createElement('script');
              Packit 90a5c9
                      s.type = 'text/javascript';
              Packit 90a5c9
                      s.async = true;
              Packit 90a5c9
                      s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
              Packit 90a5c9
                      (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
              Packit 90a5c9
                  }
              Packit 90a5c9
                  else { 
              Packit 90a5c9
                      d.write('
              Comments are disabled for this page at the moment.<\/div>');
              Packit 90a5c9
                  }
              Packit 90a5c9
              })(window, document);
              Packit 90a5c9
              //--></script>
              Packit 90a5c9

              Copyright 2018 The Apache Software Foundation.
              この文書は Apache License, Version 2.0 のライセンスで提供されています。.

              Packit 90a5c9

              モジュール | ディレクティブ | FAQ | 用語 | サイトマップ

              <script type="text/javascript">
              Packit 90a5c9
              if (typeof(prettyPrint) !== 'undefined') {
              Packit 90a5c9
                  prettyPrint();
              Packit 90a5c9
              }
              Packit 90a5c9
              //--></script>
              Packit 90a5c9
              </body></html>