Cette rubrique décrit la syntaxe, la description, les paramètres et les valeurs de retour des fonctions de logique de requête. Elle fournit également des exemples d'utilisation de ces fonctions.
server_addr
Cette fonction permet de récupérer les adresses IP des serveurs qui reçoivent la requête actuelle. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | server_addr() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie les adresses IP des serveurs sous forme de chaîne. |
server_port
Cette fonction permet de récupérer le port du serveur qui reçoit la requête actuelle. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | server_port() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie le port du serveur qui reçoit la requête actuelle. Type de données : numérique. |
client_addr
Cette fonction permet de récupérer l'adresse IP d'un client. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | client_addr() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie l'adresse IP du client spécifié sous forme de chaîne. |
client_port
Cette fonction permet de récupérer le port d'un client. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | client_port() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie le port du client. Type de données : numérique. |
client_region
Cette fonction permet de récupérer le code de division administrative d'un client. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | client_region() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie le code de division administrative du client spécifié sous forme de chaîne. Pour plus d'informations sur les codes de division administrative, consultez la section Codes de division administrative. |
client_city
Cette fonction permet de récupérer le code ville d'un client. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | client_city() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie le code ville du client spécifié sous forme de chaîne. Pour plus d'informations sur les codes ville, consultez la section Tableau des codes villes. |
client_isp
Cette fonction permet de récupérer le code du fournisseur d'accès Internet (FAI) d'un client. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | client_isp() |
| Paramètre | S.O. |
| Exemple | |
| Valeur de retour | Renvoie le code FAI du client spécifié sous forme de chaîne. Pour plus d'informations sur les codes FAI, consultez la section Codes FAI. |
ip_region
Cette fonction permet de récupérer le code de division administrative de la ville ou de la province à laquelle appartient une adresse IP spécifiée. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | ip_region(ipaddr) |
| Paramètre | ipaddr : spécifie une adresse IP en notation décimale pointée. |
| Exemple | |
| Valeur de retour | Renvoie le code de division administrative de la ville ou de la province à laquelle appartient l'adresse IP spécifiée, sous forme de chaîne. Pour plus d'informations sur les codes de division administrative, consultez la section Codes de division administrative. |
ip_city
Permet de récupérer le code pays d'une adresse IP spécifiée. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | ip_city(ipaddr) |
| Paramètre | ipaddr : spécifie une adresse IP en notation décimale pointée. |
| Exemple | |
| Valeur de retour | Renvoie le code de division administrative du client spécifié sous forme de chaîne. Pour plus d'informations sur les codes ville, consultez la section Tableau des codes villes. |
ip_isp
Cette fonction permet de récupérer le code FAI d'une adresse IP spécifiée. Le tableau suivant présente les détails relatifs à cette fonction.
| Élément | Description |
| Syntaxe | ip_isp(ipaddr) |
| Paramètre | ipaddr : spécifie une adresse IP en notation décimale pointée. |
| Exemple | |
| Valeur de retour | Renvoie le code FAI de l'adresse IP spécifiée sous forme de chaîne. Pour plus d'informations sur les codes FAI, consultez la section Codes FAI. |
req_uri
Remarques sur cette fonction :
Si le paramètre pattern n'est pas inclus dans la requête, l'URI de la requête est renvoyé, à l'exclusion des paramètres.
Si le paramètre pattern est inclus dans la requête, l'URI de la requête est comparé aux conditions de correspondance.
Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_uri([pattern]) |
| Paramètre | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Exemple | |
| Valeur de retour |
Exemples de valeurs de retour : |
req_uri_basename
Remarques sur cette fonction :
Renvoie le nom de fichier dans l'URI de la requête si le paramètre pattern n'est pas inclus dans la requête.
Compare le nom de fichier dans l'URI de la requête aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Exemples de noms de fichiers :
Exemple 1 : Pour /document_detail/30360.html, le nom de fichier est 30360.
Exemple 2 : Pour /M604/guopei_mp4/ZYJY2017BJGL0101/2-1_g.mp4, le nom de fichier est 2-1_g.
Exemple 3 : Pour /tarball/foo.tar.bz2, le nom de fichier est foo.
Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_uri_basename([pattern]) |
| Paramètre | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Exemple | |
| Valeur de retour |
Exemples de valeurs de retour : |
req_uri_ext
Remarques sur cette fonction :
Renvoie l'extension dans l'URI de la requête si le paramètre pattern n'est pas inclus dans la requête.
Compare l'extension dans l'URI de la requête aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Exemples d'extensions :
Exemple 1 : Pour /document_detail/30360.html, l'extension est .html.
Exemple 2 : Pour /M604/guopei_mp4/ZYJY2017BJGL0101/2-1_g.mp4, l'extension est .mp4.
Exemple 3 : Pour /tarball/foo.tar.bz2, l'extension est .tar.bz2.
Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_uri_ext([pattern]) |
| Paramètre | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Exemple | |
| Valeur de retour |
Exemples de valeurs de retour : |
req_uri_seg
Remarques sur cette fonction :
-
Dans les paramètres de réponse, les segments sont séparés par des barres obliques (/).
Renvoie tous les segments si le paramètre idx n'est pas inclus dans la requête.
Renvoie les segments (y compris l'index) qui suivent l'index spécifié si le paramètre idx est inclus dans la requête.
Index des paragraphes : l'index commence à 1 et augmente à partir de l'index le plus à gauche lorsque d'autres paragraphes sont ajoutés.
Limite de paragraphe : Un paragraphe peut contenir jusqu'à 128 caractères. Les caractères dépassant cette limite sont supprimés.
Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_uri_seg([idx]) |
| Paramètre | idx : spécifie l'index de départ. Ce paramètre est facultatif. |
| Exemple | |
| Valeur de retour | Type de données : dictionary. Les paragraphes pertinents sont inclus. Remarque Lorsque la fonction récupère le paragraphe à partir du dictionnaire renvoyé en fonction de l'index spécifié, elle vérifie si le paragraphe est vide. Exemples de valeurs de retour : |
req_uri_arg
Cette fonction interroge la valeur d'un paramètre spécifié. Si le paramètre pattern est inclus dans la requête, la valeur du paramètre spécifié est comparée aux conditions de correspondance. Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_uri_arg(name, [pattern]) |
| Paramètre |
|
| Exemple | |
| Valeur de retour |
Exemples de valeurs de retour : |
req_uri_query_string
Remarques sur cette fonction :
Si le paramètre pattern n'est pas inclus dans la requête, les paramètres de la requête sont renvoyés, à l'exclusion du point d'interrogation (?).
Si le paramètre pattern est inclus dans la requête, les paramètres des requêtes sont comparés aux conditions de correspondance.
Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_uri_query_string([pattern]) |
| Paramètre | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Exemple | |
| Valeur de retour |
Exemples de valeurs de retour : |
req_scheme
Remarques sur cette fonction :
Renvoie le schéma de la requête si le paramètre pattern n'est pas inclus dans la requête.
Compare le schéma de la requête aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Le tableau suivant décrit les détails de cette fonction.
| Élément | Description |
| Syntaxe | req_scheme([pattern]) |
| Paramètre | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Exemple | |
| Valeur de retour |
Dans cet exemple, les valeurs suivantes sont renvoyées : |
req_method
Remarques sur cette fonction :
Renvoie la méthode de requête si le paramètre pattern n'est pas inclus dans la requête.
Compare la méthode de requête aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_method([pattern]) |
| Parameter | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_host
Remarques sur cette fonction :
Renvoie la valeur de l'en-tête de requête Host si le paramètre pattern n'est pas inclus dans la requête.
Compare la valeur de l'en-tête de requête Host aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_host([pattern]) |
| Parameter | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_user_agent
Remarques sur cette fonction :
Renvoie la valeur de l'en-tête de requête User-Agent si le paramètre pattern n'est pas inclus dans la requête.
Compare la valeur de l'en-tête de requête User-Agent aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_user_agent([pattern]) |
| Parameter | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_referer
Remarques sur cette fonction :
Renvoie la valeur de l'en-tête de requête Referer si le paramètre pattern n'est pas inclus dans la requête.
Compare la valeur de l'en-tête de requête Referer aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_referer([pattern]) |
| Parameter | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_cookie
Cette fonction interroge la valeur d'un cookie spécifié. Si le paramètre pattern est inclus dans la requête, la valeur du cookie spécifié est comparée aux conditions de correspondance. Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_cookie(name, [pattern]) |
| Parameter |
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_first_x_forwarded
Remarques sur cette fonction :
Renvoie la première adresse de l'en-tête de requête X-Forwarded-For si le paramètre pattern n'est pas inclus dans la requête.
Compare la première adresse de l'en-tête de requête X-Forwarded-For aux conditions de correspondance si le paramètre pattern est inclus dans la requête.
Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_first_x_forwarded_addr([pattern]) |
| Parameter | pattern : comparé aux conditions de correspondance. Les types de correspondance suivants sont pris en charge :
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_header
Cette fonction interroge la valeur d'un en-tête de requête spécifié. Si le paramètre pattern est inclus dans la requête, la valeur de l'en-tête de requête spécifié est comparée aux conditions de correspondance. Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_header(name, [pattern]) |
| Parameter |
|
| Example | |
| Return value |
Exemples de valeurs de retour : |
req_id
Cette fonction interroge l'Eagle Eye ID d'une requête. Chaque Eagle Eye ID identifie de manière unique une requête. Le tableau suivant décrit les détails de cette fonction.
| Item | Description |
| Syntax | req_id() |
| Parameter | N/A |
| Example | |
| Return value | Renvoie l'ID de requête sous forme de chaîne. La valeur de retour dans cet exemple est req_id: 6451c43d15815890089411000e. |