1. nginx 变量简介
所有的 nginx变量在 nginx 配置文件中引用时都须带上 $
前缀
在 nginx 配置中,变量只能存放一种类型的值,而且也只存在一种类型,那就是字符串类型
所有的变量值都可以通过这种方式引用 $变量名
2. nginx 变量的定义和使用
nginx中的变量分为两种,自定义变量与内置预定义变量
2.1. 自定义变量
1、声明变量可以在sever,http,location等标签中使用set命令声明变量,语法如下:
set $变量名 变量值
注意:
- nginx 中的变量必须都以
$
开头 - nginx 的配置文件中所有使用的变量都必须是声明过的,否则 nginx 会无法启动并打印相关异常日志
nginx安装echo模块
//查看已经安装的nginx的版本 [root@localhost ~]# nginx -v nginx version: nginx/1.24.0 //上传或者下载一个相同版本的nginx包 [root@localhost ~]# wget http://nginx.org/download/nginx-1.24.0.tar.gz //下载echo模块的安装包 [root@localhost ~]# wget https://github.com/openresty/echo-nginx-module/archive/refs/tags/v0.63.tar.gz [root@localhost ~]# ls anaconda-ks.cfg nginx-1.24.0.tar.gz v0.63.tar.gz //解压到相同路径下: [root@localhost ~]# tar xzvf nginx-1.24.0.tar.gz -c /usr/local/ [root@localhost ~]# tar xzvf v0.63.tar.gz -c /usr/local/ //安装编译工具 [root@localhost ~]# cd /usr/local/ [root@localhost local]# yum -y install pcre pcre-devel openssl openssl-devel gcc gcc-c++ zlib zlib-devel gd-devel //添加模块: [root@localhost local]# cd nginx-1.24.0/ //添加上原来已经有的参数和新添加的模块: [root@localhost nginx-1.24.0]# ./configure --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-cc-opt='-o2 -g -pipe -wall -wp,-d_fortify_source=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -fpic' --with-ld-opt='-wl,-z,relro -wl,-z,now -pie' --add-module=/usr/local/echo-nginx-module-0.63 //编译,千万不要make install 否则会覆盖原来的文件 [root@localhost nginx-1.24.0]# make //将原来的nignx二进制文件备份 [root@localhost nginx-1.24.0]# mv /usr/sbin/nginx /usr/sbin/nginx_bak //拷贝替换新的nignx二进制文件 [root@localhost nginx-1.24.0]# cp objs/nginx /usr/sbin/ [root@localhost nginx-1.24.0]# systemctl restart nginx //重启nginx //查看模块是否添加成功 [root@localhost nginx-1.24.0]# nginx -v nginx version: nginx/1.24.0 built by gcc 4.8.5 20150623 (red hat 4.8.5-44) (gcc) built with openssl 1.0.2k-fips 26 jan 2017 tls sni support enabled configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-cc-opt='-o2 -g -pipe -wall -wp,-d_fortify_source=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -fpic' --with-ld-opt='-wl,-z,relro -wl,-z,now -pie' --add-module=/usr/local/echo-nginx-module-0.63
2、配置 $foo=hello
[root@localhost ~]# cd /etc/nginx/conf.d/ [root@localhost conf.d]# vim echo.conf server { listen 80; server_name localhost; location /test { set $foo hello; echo "foo: $foo"; } } [root@localhost conf.d]# nginx -t nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful [root@localhost conf.d]# systemctl restart nginx //访问测试 [root@localhost conf.d]# curl http://localhost/test foo: hello
nginx 变量的创建只能发生在 nginx 配置加载的时候,或者说 nginx 启动的时候。
而赋值操作则只会发生在请求实际处理的时候。这意味着不创建变量,直接使用变量会导致启动失败。
2.2. 内置预定义变量
内置预定义变量即无需声明就可以使用的变量,通常包括一个 http 请求或响应中一部分内容的值,以下为一些常用的内置预定义变量
变量名 | 定义 |
---|---|
$arg_parameterget | 请求中变量名parameter参数的值。 |
$args | 这个变量等于get请求中的参数。例如,foo=123&bar=blahblah;这个变量只可以被修改。 |
$binary_remote_addr | 二进制码形式的客户端地址。 |
$body_bytes_sent | 传送页面的字节数。 |
$content_length | 请求头中的content-length字段。 |
$content_type | 请求头中的content-type字段。 |
$cookie_cookie | cookie cookie的值。 |
$document_root | 当前请求在root指令中指定的值。 |
$document_uri | 与$uri相同。 |
$host | 请求中的主机头(host)字段,如果请求中的主机头不可用或者空,则为处理请求的server名称(处理请求的server的server_name指令的值)。值为小写,不包含端口。 |
$hostname | 机器名使用 gethostname系统调用的值 |
$http_headerhttp | 请求头中的内容,header为http请求中的内容转为小写,-变为_(破折号变为下划线),例如:$http_user_agent(uaer-agent的值)。 |
$sent_http_header | http响应头中的内容,header为http响应中的内容转为小写,-变为_(破折号变为下划线),例如: $sent_http_cache_control, $sent_http_content_type…; |
$is_args | 如果$args设置,值为"?“,否则为”"。 |
$limit_rate | 这个变量可以限制连接速率。 |
$nginx_version | 当前运行的nginx版本号。 |
$query_string | 与$args相同。 |
$remote_addr | 客户端的ip地址。 |
$remote_port | 客户端的端口。 |
$remote_user | 已经经过auth basic module验证的用户名。 |
$request_filename | 当前连接请求的文件路径,由root或alias指令与uri请求生成。 |
$request_body | 这个变量(0.7.58+)包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有意义。 |
$request_body_file | 客户端请求主体信息的临时文件名。 |
$request_completion | 如果请求成功,设为"ok";如果请求未完成或者不是一系列请求中最后一部分则设为空。 |
$request_method | 这个变量是客户端请求的动作,通常为get或post。包括0.8.20及之前的版本中,这个变量总为main request中的动作,如果当前请求是一个子请求,并不使用这个当前请求的动作。 |
$request_uri | 这个变量等于包含一些客户端请求参数的原始uri,它无法修改,请查看$uri更改或重写uri。 |
$scheme | 所用的协议,比如http或者是https,比如rewrite ^(.+)$ $scheme://example.com$1 redirect。 |
$server_addr | 服务器地址,在完成一次系统调用后可以确定这个值,如果要绕开系统调用,则必须在listen中指定地址并且使用bind参数。 |
$server_name | 服务器名称。 |
$server_port | 请求到达服务器的端口号。 |
$server_protocol | 请求使用的协议,通常是http/1.0或http/1.1。 |
$uri | 请求中的当前uri(不带请求参数,参数位于args),不同于浏览器传递的args),不同于浏览器传递的args),不同于浏览器传递的request_uri的值,它可以通过内部重定向,或者使用index指令进行修改。不包括协议和主机名,例如/foo/bar.html |
3. nginx alias 虚拟目录(拓展)
root
:为 location 指定网站的根目录。location 里定义的子路径是跟这个根目录相对的。alias
:为 location 指定服务的具体文件路径。location 里定义的子路径会被忽略
使用alias标签的目录块中不能使用 rewrite 的 break 。
server { listen 80; server_name localhost; location /test { root /var/www/html; index index.html; } location /qfedu { alias /var/www/nginx; #访问http://x.x.x.x/qfedu时实际上访问是/var/www/nginx/index.html index index.html; } } //创建location匹配的目录和文件 [root@localhost ~]# mkdir /var/www/html/test [root@localhost ~]# echo "location /test" >> /var/www/html/test/index.html //创建alias匹配的目录和文件 [root@localhost ~]# mkdir /var/www/nginx [root@localhost ~]# echo "alias /qfedu" >> /var/www/nginx/index.html [root@localhost ~]# nginx -t nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful [root@localhost ~]# systemctl restart nginx
root 和 alias 的主要区别是:
- 使用root,实际的路径就是:
root值 + location值
。root会将完整的url映射进文件路径,root可以看成是一个相对路径,访问url网址时,http://www.baidu.com/test,这个test必须要在/usr/share/nginx/html下有这个目录,目录中必须要这个文件才行。 - 使用alias,实际的路径就是:
alias值
。alias只会将localhost后的url映射到文件路径。而使用alias时,访问http://www.baidu.com/test,在/usr/share/nginx/html不需要有这个test目录即可。 - alias只能位于location块中,root可以放在http,server,location块中
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持代码网。
发表评论