翻訳：
| 構文： | location [ = | ~ | ~* | ^~ ] uri { ... }``location @name { ... } |
|---|---|
| デフォルト： | - |
| 環境： | server、 location |
リクエストURIに基づいて構成されました。
相対パスの形でテキスト「％xxを」デコードするために。「」形式および「...」、および2つ以上の隣接スラッシュ圧縮後のURIのマッチングが行われる1つのスラッシュを調節します。
位置は、以下のように定義することができるプレフィックス・ストリングまたは正規表現。接頭辞によって正規表現「*」（無視する場合）または「」これらの位置に変更（大文字と小文字を区別）は、最も長い接頭文字列マッチ位置は、選択されたと記憶されます。そして、それは順番になります正規表現は、設定ファイルに表示された正規表現にマッチします。最初の正規表現マッチで終了し、対応する構成が使用されます。それが正規表現に一致しない場合は、前の接頭辞文字列マッチングの設定の場所が使用されます覚えておいてください。
ブロックの位置は、後述いくつかの例外を除き、入れ子にすることができます。
大文字と小文字を区別しないと、このようなMacOSのCygwinのようなオペレーティングシステムでは、接頭文字列一致の場合は無視されます。しかし、バイトの比較が限られた環境であることを。
キャプチャを含むことができる正規表現は、キャプチャされたコンテンツは、以下の他の命令で使用することができます。
「^〜」修正の一致するロケーション最長プレフィックス文字列ならば、正規表現は後にチェックされることはありません。
「=」は、厳密なマッチングURIと位置を定義するために修正される使用。試合のstrictモードならば、検索が終了します。要求は「/」頻繁に発生する場合たとえば、の定義は「場所は= /」すぐにこれらの要求を処理します。厳密な位置に最初に一致した後に検索を終了します。この場所は、明らかに、ネストされた場所を含めることはできません。
注：いない「=」または「^〜」変更した場合は、ロケーション要求は、接頭文字列に一致する場合は0.8.41にバージョン0.7.1では、検索が停止し、正規表現はチェックされません。
私たちは、例を説明することがしてみましょう：
location = / {
[ configuration A ]
}
location / {
[ configuration B ]
}
location /documents/ {
[ configuration C ]
}
location ^~ /images/ {
[ configuration D ]
}
location ~* \.(gif|jpg|jpeg)$ {
[ configuration E ]
}
「/」、「/ドキュメント/ document.html」リクエスト構成Cに一致する、要求が構成Bに一致します「のindex.html /」、要求の構成Aと一致します「/画像/ 1.gif」要求が一致します構成のDは、「/文書/ 1.JPG」要求が設定E.一致します
接頭辞定義された場所として、接頭辞「@」。そのようなロケーション要求は、従来のプロセスのためではなく、リダイレクト要求。彼らは、ネストすることができず、ネストされた位置を含めることはできません。
接頭文字によって位置が端にスラッシュ、及び要求に定義されている場合proxy_pass、fastcgi_pass、uwsgi_pass、scgi_pass、memcached_pass grpc_pass又は一つの処理をし、次いで特殊な処理を行います。要求ストリングURIないスラッシュ、等しかしに応答して、永久的なリダイレクションリクエストURIとベルトスラッシュが返される301 COD。これは厳密なマッチングURIと場所でない場合のように定義することができます。
location /user/ {
proxy_pass http://user.example.com;
}
location = /user {
proxy_pass http://login.example.com;
}
注意点
- 場所は、ライン上の一致の一部でありません、あなたは試合のパスからやり直す必要がありURIのパスは常にURIのパスの理由の接頭辞文字列を強調している理由試合の開始の前から文字列によって定義されますが、定期的にされます私たちは、この制限はありません。
- 試合中に戻っている^〜一致しない程度の後方にならないでください。ここでは、検索文字列が^〜場所に最長プレフィックス一致でその場所を覚えしようとする場合の要件は^〜マッチングが行われることに注意しなければなりません。
参照
