nginxカスタム変数と組み込み定義済み変数の使用

概要

Nginx では変数を使用して設定を簡素化し、設定の柔軟性を向上させることができます。すべての変数値は次のように参照できます。

$変数名

nginxには、カスタム変数と組み込み定義済み変数の2種類の変数があります。

組み込み変数

声明

setコマンド（非一意）を使用して、server、http、locationなどのタグ内の変数を宣言できます。構文は次のとおりです。

$variable 名 変数値 を設定する

nginx 内のすべての変数は $ で始まる必要があることに注意してください。

可視性

nginx 設定ファイルで使用されるすべての変数を宣言する必要があります。そうしないと、nginx は起動に失敗し、関連する例外ログが出力されます。

nginx 変数の興味深い特徴は、どれもグローバルには表示されないが、グローバル変数ではないことです。例えば次の例

場所 a/
 200ドルを返す
}

場所 b/ {
 $a hello nginx を設定します
 200ドルを返す
}

変数はグローバルに表示されるため、nginx は起動時にエラーを報告しません。ただし、最初の場所では $a の具体的な値は不明であるため、返される応答結果は空の文字列になります。

さまざまなレベルのタグで宣言された変数の可視性ルールは次のとおりです。

ロケーションタグで宣言された変数は、このロケーションブロックに表示されます。
サーバータグで宣言された変数は、サーバーブロックとサーバーブロック内のすべてのサブブロックに表示されます。
http タグで宣言された変数は、http ブロックと http ブロック内のすべてのサブブロックに表示されます。

組み込み定義済み変数

組み込み定義済み変数は宣言なしで使用できる変数で、通常はHTTPリクエストまたはレスポンスのコンテンツの一部の値を含みます。以下は、よく使用される組み込み定義済み変数の一部です。

変数名	意味
$arg_PARAMETER	GET リクエスト内の PARAMETER という名前のパラメータの値。
$引数	この変数は、GET リクエストのパラメータと同じです。例えば、foo=123&bar=blahblah; この変数は変更可能です
$バイナリリモートアドレス	バイナリ形式のクライアントアドレス。
送信された本文バイト数	転送されたページのバイト数
$コンテンツの長さ	リクエストヘッダーの Content-length フィールド。
$コンテンツタイプ	リクエストヘッダーの Content-Type フィールド。
$クッキー_クッキー	クッキー COOKIE の値。
$ドキュメントルート	現在のリクエストのルートディレクティブで指定された値。
$ドキュメントURI	$uriと同じです。
$ホスト	リクエスト内の Host ヘッダーフィールド。リクエスト内の Host ヘッダーが利用できないか空の場合、リクエストを処理するサーバーの名前 (リクエストを処理するサーバーの server_name ディレクティブの値)。値は小文字で、ポートは含まれません。
$ホスト名	マシン名は gethostname システムコールの値です。
$http_HEADER	HTTP リクエストヘッダー (HEADER) の内容は、HTTP リクエスト内の内容を小文字に変換したもので、- は _ (ダッシュはアンダースコア) になります。例: $http_user_agent (Uaer-Agent の値)。
$送信されたhttp_HEADER	HTTP 応答ヘッダーの内容。HEADER は、HTTP 応答の内容を小文字に変換したもので、- は _ (ダッシュはアンダースコア) になります。例: $sent_http_cache_control、$sent_http_content_type…;
$is_args	$args が設定されている場合、値は "?" になり、設定されていない場合は "" になります。
$制限レート	この変数は接続速度を制限できます。
$nginx_バージョン	現在実行中の nginx のバージョン番号。
$クエリ文字列	$argsと同じです。
$リモートアドレス	クライアントの IP アドレス。
$リモートポート	クライアントのポート。
$リモートユーザー	Auth Basic モジュールによって認証されたユーザー名。
$リクエストファイル名	ルートまたはエイリアスディレクティブと URI 要求によって生成された、現在の接続要求のファイルパス。
$リクエスト本体	この変数 (0.7.58 以降) には、リクエストの主な情報が含まれます。これは、proxy_pass または fastcgi_pass ディレクティブを使用する場所で意味があります。
$リクエスト本体ファイル	クライアント要求本文情報の一時ファイル名。
$リクエスト完了	リクエストが成功した場合は「OK」に設定され、リクエストが完了しなかったか、一連のリクエストの最後ではなかった場合、空に設定されます。
$リクエストメソッド	この変数は、クライアントによって要求されたアクション (通常は GET または POST) です。バージョン 0.8.20 以前では、この変数は常にメインリクエスト内のアクションです。現在のリクエストがサブリクエストの場合、現在のリクエストのアクションは使用されません。
$リクエストURI	この変数は、いくつかのクライアント要求パラメータを含む元の URI と同じです。変更できません。URI を変更または書き換えるには、$uri を参照してください。
$スキーム	使用されるプロトコル (http または https など)、たとえば rewrite ^(.+)$ $scheme://example.com$1 redirect;
$サーバーアドレス	サーバーアドレス。この値は、システムコールの完了後に決定できます。システムコールをバイパスする場合は、listen でアドレスを指定し、bind パラメータを使用する必要があります。
$サーバー名	サーバー名。
$サーバーポート	リクエストがサーバーに到着したポート番号。
$サーバープロトコル	リクエストで使用されるプロトコル。通常は HTTP/1.0 または HTTP/1.1 です。
$uri	リクエスト内の現在のURI（リクエストパラメータがない場合、パラメータは、内部リダイレクトまたは index ディレクティブを使用して変更できます。プロトコルとホスト名を含めないでください。例: /foo/bar.html

nginx カスタム変数と組み込み定義済み変数の使用に関するこの記事はこれで終わりです。より関連性の高い nginx カスタム変数と組み込み定義済み変数については、123WORDPRESS.COM の以前の記事を検索するか、以下の関連記事を引き続き参照してください。今後とも 123WORDPRESS.COM をよろしくお願いいたします。

以下もご興味があるかもしれません: