Opened 3 years ago

#2301 new enhancement

Add examples for core variables

Reported by: cweiske Owned by:
Priority: minor Milestone:
Component: documentation Version: 1.19.x
Keywords: Cc: cweiske
uname -a: Linux sybo 5.4.0-91-generic #102-Ubuntu SMP Fri Nov 5 16:31:28 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
nginx -V: nginx version: nginx/1.14.0 (Ubuntu)
built with OpenSSL 1.1.1 11 Sep 2018
TLS SNI support enabled
configure arguments: --with-cc-opt='-g -O2 -fdebug-prefix-map=/build/nginx-H4cN7P/nginx-1.14.0=. -fstack-protector-strong -Wformat -Werror=format-security -fPIC -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-Bsymbolic-functions -Wl,-z,relro -Wl,-z,now -fPIC' --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --modules-path=/usr/lib/nginx/modules --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path=/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-http_ssl_module --with-http_stub_status_module --with-http_realip_module --with-http_auth_request_module --with-http_v2_module --with-http_dav_module --with-http_slice_module --with-threads --with-http_addition_module --with-http_geoip_module=dynamic --with-http_gunzip_module --with-http_gzip_static_module --with-http_image_filter_module=dynamic --with-http_sub_module --with-http_xslt_module=dynamic --with-stream=dynamic --with-stream_ssl_module --with-mail=dynamic --with-mail_ssl_module

Description

I was searching the variable list (http://nginx.org/en/docs/varindex.html) and then core variables (http://nginx.org/en/docs/http/ngx_http_core_module.html#variables) and got confused because the textual descriptions do not always help.

My goal was to find the variable containing the file path requested by the browser ("/path/to/file" when the browser accesses "http://example.org/path/to/file?foo=bar").

It would have helped me if the variables would have had examples. Please add them to the docs.

$request_filename: /var/www/webapp/public/icons/external.svg

$request_uri: /icons/external.svg?foo=bar

Change History (0)

Note: See TracTickets for help on using tickets.