このトピックでは、リクエストロジック関数の構文、機能、パラメーター、および戻り値について説明します。 このトピックでは、これらの関数の例も示します。
server_addr
この関数は、現在のリクエストを受信したサーバーのIPアドレスを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | server_addr() |
パラメーター | なし |
例 |
|
戻り値 | サーバーのIPアドレスを文字列で返します。 |
server_port
この関数は、現在の要求を受信するサーバーポートを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | server_port() |
パラメーター | なし |
例 |
|
戻り値 | 現在のリクエストを受信したサーバーポートを返します。 データ型: numeric。 |
client_addr
重要 注意: クライアントアドレスがインターネットサービスプロバイダ (ISP) のNATルールによって変更されているか、IPアドレスがAlibaba Cloud CDNのアドレスプールにないため、戻り値が正確でない場合があります。 作業は慎重に行ってください。
この関数は、クライアントのIPアドレスを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | client_addr() |
パラメーター | なし |
例 |
|
戻り値 | 指定されたクライアントのIPアドレスを文字列で返します。 |
client_port
この関数は、クライアントのポートを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | client_port() |
パラメーター | なし |
例 |
|
戻り値 | 指定されたクライアントのポートを返します。 データ型: numeric。 |
client_region
重要 注意: クライアントアドレスがインターネットサービスプロバイダ (ISP) のNATルールによって変更されているか、IPアドレスがAlibaba Cloud CDNのアドレスプールにないため、戻り値が正確でない場合があります。 作業は慎重に行ってください。
この関数は、クライアントの管理部門コードを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | client_region() |
パラメーター | なし |
例 |
|
戻り値 | 指定されたクライアントの管理部門コードを文字列で返します。 行政部門コードの詳細については、「行政部門コード」をご参照ください。 |
client_isp
重要 注意: クライアントアドレスがインターネットサービスプロバイダ (ISP) のNATルールによって変更されているか、IPアドレスがAlibaba Cloud CDNのアドレスプールにないため、戻り値が正確でない場合があります。 作業は慎重に行ってください。
この関数は、クライアントのISPコードを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | client_isp() |
パラメーター | なし |
例 |
|
戻り値 | 指定されたクライアントのISPコードを文字列で返します。 ISPコードの詳細については、「ISPコード」をご参照ください。 |
ip_region
重要 注意: クライアントアドレスがインターネットサービスプロバイダ (ISP) のNATルールによって変更されているか、IPアドレスがAlibaba Cloud CDNのアドレスプールにないため、戻り値が正確でない場合があります。 作業は慎重に行ってください。
指定されたIPアドレスが属する市または州の行政区画コードを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | ip_region(ipaddr) |
パラメーター | ipaddr: IPアドレスを10進表記で指定します。 |
例 |
|
戻り値 | 指定されたIPアドレスが属する市または県の行政区画コードを文字列で返します。 行政部門コードの詳細については、「行政部門コード」をご参照ください。. |
ip_isp
重要 注意: クライアントアドレスがインターネットサービスプロバイダ (ISP) のNATルールによって変更されているか、IPアドレスがAlibaba Cloud CDNのアドレスプールにないため、戻り値が正確でない場合があります。 作業は慎重に行ってください。
この関数は、指定されたIPアドレスのISPコードを照会します。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | ip_isp(ipaddr) |
パラメーター | ipaddr: IPアドレスを10進表記で指定します。 |
例 |
|
戻り値 | 指定されたIPアドレスのISPコードを文字列で返します。 ISPコードの詳細については、「ISPコード」をごください。 |
req_uri
この機能の使用法のノート:
- patternパラメーターがリクエストに含まれていない場合、リクエストのURI (パラメーターを除く) が返されます。
- リクエストにpatternパラメーターが含まれている場合、リクエストのURIと一致条件が比較されます。
項目 | 説明 |
構文 | req_uri([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_uri_basename
この機能の使用法のノート:
- patternパラメーターがリクエストに含まれていない場合は、リクエストURIのファイル名を返します。
- リクエストにpatternパラメーターが含まれている場合、リクエストURIのファイル名と一致条件を比較します。
- 例1: /document_detail/30360.htmlの場合、ファイル名は30360です。
- 例2: /M604/guopei_mp4/ZYJY2017BJGL0101/2-1_g.mp4の場合、ファイル名は2-1_gです。
- 例3: /tarball/foo.tar.bz2の場合、ファイル名はfooです。
項目 | 説明 |
構文 | req_uri_basename([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_uri_ext
この機能の使用法のノート:
- patternパラメーターがリクエストに含まれていない場合は、リクエストURIの拡張子を返します。
- patternパラメーターがリクエストに含まれている場合、リクエストURIの拡張子を一致条件と比較します。
- 例1: /document_detail/30360.htmlの場合、拡張子は. htmlです。
- 例2: /M604/guopei_mp4/ZYJY2017BJGL0101/2-1_g.mp4の場合、拡張子は mp4。
- 例3: /tarball/foo.tar.bz2の場合、拡張子は tar.bz2です。
項目 | 説明 |
構文 | req_uri_ext([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_uri_seg
この機能に関する注意事項:
- 応答パラメータでは、セグメントはスラッシュ (/) で区切られます。
- idxパラメーターがリクエストに含まれていない場合は、すべてのセグメントを返します。
- idxパラメーターがリクエストに含まれている場合、指定されたインデックスに続くセグメント (インデックスを含む) を返します。
- 段落のインデックス: インデックスは1から始まり、段落が追加されると左端のインデックスから増加します。
- Paragraph limit: 段落には最大128文字を含めることができます。 この制限を超える文字は削除されます。
項目 | 説明 |
構文 | req_uri_seg([idx]) |
パラメーター | idx: 開始インデックスを指定します。 このパラメーターはオプションです。 |
例 |
|
戻り値 | データ型: dictionary。 関連する段落が含まれています。 説明 関数が指定されたインデックスに基づいて返された辞書から段落を取得すると、その段落が空であるかどうかがチェックされます。 この例では、次の値が返されます
|
req_uri_arg
この関数は、指定されたパラメーターの値を照会します。 リクエストにpatternパラメーターが含まれている場合、指定されたパラメーターの値と一致条件が比較されます。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | req_uri_arg(name, [パターン]) |
パラメーター |
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_uri_query_string
この機能の使用法のノート:
- リクエストにpatternパラメーターが含まれていない場合は、クエスチョンマーク (?) を除くリクエスト内のパラメーターが返されます。
- パターンパラメータがリクエストに含まれている場合、リクエスト内のパラメータが一致条件と比較されます。
項目 | 説明 |
構文 | req_uri_query_string([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_scheme
この機能の使用法のノート:
- パターンパラメーターがリクエストに含まれていない場合は、リクエストスキームを返します。
- リクエストにpatternパラメーターが含まれている場合、リクエストスキームと一致条件を比較します。
項目 | 説明 |
構文 | req_scheme([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_method
この機能に関する注意事項:
- patternパラメーターがリクエストに含まれていない場合は、リクエストメソッドを返します。
- patternパラメーターがリクエストに含まれている場合、リクエストメソッドと一致条件を比較します。
項目 | 説明 |
構文 | req_method([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます。
|
req_host
この機能に関する注意事項:
- patternパラメーターがリクエストに含まれていない場合は、Hostリクエストヘッダーの値を返します。
- リクエストにpatternパラメーターが含まれている場合、Hostリクエストヘッダーの値を一致条件と比較します。
項目 | 説明 |
構文 | req_host([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_user_agent
この機能の使用法のノート:
- リクエストにpatternパラメーターが含まれていない場合は、User-Agentリクエストヘッダーの値を返します。
- リクエストにpatternパラメーターが含まれている場合、User-Agentリクエストヘッダーの値と一致条件を比較します。
項目 | 説明 |
構文 | req_user_agent([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_referer
この機能に関する注意事項:
- リクエストにpatternパラメーターが含まれていない場合は、Refererリクエストヘッダーの値を返します。
- リクエストにpatternパラメーターが含まれている場合、Refererリクエストヘッダーの値を一致条件と比較します。
項目 | 説明 |
構文 | req_referer([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_cookie
この関数は、指定されたcookieの値を照会します。 リクエストにpatternパラメーターが含まれている場合、指定されたcookieの値が一致条件と比較されます。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | req_cookie(name, [パターン]) |
パラメーター |
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_first_x_forwarded
この機能に関する注意事項:
- パターンパラメーターがリクエストに含まれていない場合、X-Forwarded-Forリクエストヘッダーの最初のアドレスを返します。
- パターンパラメーターがリクエストに含まれている場合、X-Forwarded-Forリクエストヘッダーの最初のアドレスを一致条件と比較します。
項目 | 説明 |
構文 | req_first_x_forwarded_addr([パターン]) |
パラメーター | パターン: マッチ条件との比較。 次の一致タイプがサポートされています。
|
例 |
|
戻り値 |
この例では、次の値が返されます。
|
req_header
この関数は、指定されたリクエストヘッダーの値を照会します。 リクエストにpatternパラメーターが含まれている場合、指定されたリクエストヘッダーの値が一致条件と比較されます。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | req_header(name, [パターン]) |
パラメーター |
|
例 |
|
戻り値 |
この例では、次の値が返されます
|
req_id
この関数は、要求のEagle Eye IDを照会します。 各Eagle Eye IDは、要求を一意に識別する。 この関数の詳細を次の表に示します。
項目 | 説明 |
構文 | req_id() |
パラメーター | なし |
例 |
|
戻り値 | リクエストIDを文字列で返します。 この例では、リクエストのIDはreq_id: 6451c43d1581581589008941100 0e です。 |