$args

Переменная $args содержит аргументы строки запроса без символа '?'. — NGINX Core (HTTP)

$args NGINX Core (HTTP)

Описание

В NGINX переменная $args используется для получения строки запроса из URL входящего запроса. Она включает любые параметры, передаваемые в URL после символа '?'. Например, в URL вида 'http://example.com/page?name=John&age=30' переменная $args вернёт 'name=John&age=30'. Переменная $args автоматически заполняется при обработке HTTP-запроса NGINX, поэтому она доступна в нескольких контекстах, включая блоки server или location, а также в директивах, принимающих переменные. Важно отметить, что если в строке запроса отсутствуют аргументы, значение $args будет пустой строкой. Кроме того, эту переменную следует использовать осторожно, чтобы случайно не раскрыть конфиденциальную информацию, которая может содержаться в строке запроса.

Пример конфига

location /search {
    if ($args) {
        set $search_query $args;
        # Log or handle the search query
        access_log /var/log/nginx/search.log;
    }
}

Подсистема

http

Кэшируется

Нет

Контексты

http, server, location, if

Помните, что $args включает все параметры запроса, поэтому будьте осторожны с конфиденциальными данными.

Если параметров запроса нет, $args вернёт пустую строку, а не 'null'.

Правильно декодируйте любые URL-encoded значения перед их использованием, так как $args будет включать их закодированными.