[原]Nginx重定向Rewrite分析

本文深入探讨了Nginx的重定向,特别是针对PHP应用如Typecho和CodeIgniter的情况。介绍了ngx_http_rewrite_module的主要指令,如break、if、return和rewrite,并提供了实际配置示例。通过实验验证,作者指出常见的Typecho重定向配置中的3个if语句并非必要,只需正确配置location匹配规则即可。此外,文章还讨论了fastcgi_split_path_info的作用以及fastcgi配置文件的区别。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

http://homeway.me


nginx-reverse-proxy-conf


0x01.About

之前写过Nginx重定向了,http://homeway.me/2014/10/28/nginx-reverse-proxy-conf/,但当时比较模糊。

这里主要说两种常用的重定向,都是php中的重定向。

一种是typecho的带 index.php 例如 http://homeway.me/index.php/arg1/arg2,另一种是隐藏 index.phphttp://homeway.me/arg1/arg2

以下配置代码均亲测可用。



0x02.ngx_http_rewrite_module

首先还是按常理,先脑补下nginx地rewrite规则,http://nginx.org/en/docs/http/ngx_http_rewrite_module.html

关于nginx重写的指令主要由这么一些:
1. break指令 2. if指令 3. return指令 4. rewrite指令 5. rewrite_log指令 6. set指令

  • break指令
    停止执行当前虚拟主机的后续rewrite指令集

  • if指令
    对给定的条件condition进行判断。如果为真,大括号内的rewrite指令将被执行。
    有几个要记住的操作符:
    使用=,!= 比较的一个变量和字符串
    是用~,~*与正则表达式匹配的变量,如果这个正则表达式中包含},;则整个表达式需要用” 或’ 包围
    使用-f,!-f 检查一个文件是否存在
    使用-d,!-d 检查一个目录是否存在
    使用-e,!-e 检查一个文件、目录、符号链接是否存在
    使用-x,!-x 检查一个文件是否可执行

详细中文看这里好了: http://www.nginx.cn/216.html



0x03.nginx.conf

首先要明白我们现在要做的事情是两类, /index.php/arg1/arg2/arg1/arg2

1.类typecho的 /index.php/arg1/arg2

/index.php/arg1/arg2 跑的location是index.php文件,也就是说,我们要做一个location匹配.php的正则,并且要让它分辨出uri中的 /arg1/arg2

这个正则有很多种写法,我用的是lnmp传统的写法~ [^/]\.php(/|$)

完整匹配如下:

location ~ [^/]\.php(/|$)
{
    #try_files $uri =404; 住址扫描目录用的,这里我们都是虚假目录,删除。
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_pass  unix:/tmp/php-cgi.sock;
    fastcgi_index index.php;
    include     fastcgi.conf;
    #fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
    #include    fastcgi_params;
}

我测了下,这样其实就搞定了,typecho重定向就好了,不要向网上说的3个if语句。

只要访问/index.php/arg1/arg2就能访问到内容了。

这里有几个问题:

  • fastcgi_split_path_info干嘛用的?

去查找官网文档吧, http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_split_path_info

Defines a regular expression that captures a value for the fastcgipathinfovariable.Theregularexpressionshouldhavetwocaptures:thefirstbecomesavalueofthe fastcgi_script_name variable, the second becomes a value of the $fastcgi_path_info variable.

也就是说,fastcgi_split_path_info 的作用就是把参数分割成 $fastcgi_script_name$fastcgi_path_info,分割方式是后面的正则表达式。

我用echo模块输出了这里的参数,得到下面的结果,上面的是不加fastcgi_split_path_info,下面是加了fastcgi_split_path_info的结果:

fastcgi_split_path_info分割uri

  • 问题二,fastcgi.conf 和 fastcgi_params 是什么?

这里用到的这两个配置文件是fastcgi的配置文件,我查看了下,发现fastcgi.conffastcgi_params的差别就在fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;这句话,也就是说,随意选一个。

fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
fastcgi_param  QUERY_STRING       $query_string;
fastcgi_param  REQUEST_METHOD     $request_method;
fastcgi_param  CONTENT_TYPE       $content_type;
fastcgi_param  CONTENT_LENGTH     $content_length;

fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
fastcgi_param  REQUEST_URI        $request_uri;
fastcgi_param  DOCUMENT_URI       $document_uri;
fastcgi_param  DOCUMENT_ROOT      $document_root;
fastcgi_param  SERVER_PROTOCOL    $server_protocol;
fastcgi_param  HTTPS              $https if_not_empty;

fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
fastcgi_param  SERVER_SOFTWARE    nginx/$nginx_version;

fastcgi_param  REMOTE_ADDR        $remote_addr;
fastcgi_param  REMOTE_PORT        $remote_port;
fastcgi_param  SERVER_ADDR        $server_addr;
fastcgi_param  SERVER_PORT        $server_port;
fastcgi_param  SERVER_NAME        $server_name;

fastcgi_param  REDIRECT_STATUS    200;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;也就用到了之前的那个函数fastcgi_split_path_info,如果不做分割,就会回调: No input file specified,没有指定文件,就是因为$fastcgi_script_name的值找不到对应的文件。



2.类CodeIgniter的 /arg1/arg2

其实,我在conf里面添加了echo输出,发现/index.php/arg1/arg2就只会访问.php那个location。

然后,/arg1/arg2就用到了网上广为流传的那个typecho配置了:

location / {
    index index.html index.php;
    if (-f $request_filename/index.html){
        rewrite (.*) $1/index.html break;
    }
    if (-f $request_filename/index.php){
        rewrite (.*) $1/index.php;
    }
    if (!-f $request_filename){
        rewrite (.*) /index.php;
    }
}

看看就明白,目录/arg1/arg2,不会有有index.php可以匹配.php后缀,所以只能匹配到 / 里面。

同样地,这里我用echo模块把参数输出了下:

测试配置文件如下:

location / {
        index index.html index.php;
        if (-f $request_filename/index.html){
            rewrite (.*) $1/index.html break;
        }
        if (-f $request_filename/index.php){
            echo "request_filename -f index.php = $request_filename";
            echo "request_filename -f index.php= $request_filename";
            echo "fastcgi_path_info -f index.php = $fastcgi_path_info";
            #rewrite (.*) $1/index.php;
        }
        if (!-f $request_filename){
            echo "request_filename !-f index.php = $request_filename";
            echo "fastcgi_script_name !-f index.php = $fastcgi_script_name";
            echo "fastcgi_path_info !-f index.php = $fastcgi_path_info";
            #rewrite (.*) /index.php;
        }
    }

测试的结果如下:

location 重写

也就是访问了第3个if语句,发现没有/ajax这个文件,就重定向到/index.php去了。

这里重定向到/index.php后,解析.php的fastcgi的规则用的又是上面用到的,原理也一样,把uri分割,然后匹配。

配置代码如下:

location ~ [^/]\.php(/|$)
{
    #try_files $uri =404; 住址扫描目录用的,这里我们都是虚假目录,删除。
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_pass  unix:/tmp/php-cgi.sock;
    fastcgi_index index.php;
    include     fastcgi.conf;
    #fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
    #include    fastcgi_params;
}



0x04.About nginx

嗯…今天就算是,重新证明了下,网上流传的那种,3个if语句的typecho语句,其实并没有什么卵用。

最后进去的/index.php/2015/05/22/并不会去查询 / 的location匹配,而是.php的正则匹配。

nginx的模块测试都比较麻烦,都要重新编译安装,关于echo模块调试起来比较方便。

http://wiki.nginx.org/HttpEchoModule

下面是一些if判断用得到的nginx参数,可以通过echo输出测试查看:

args content_length
contenttype document_root
documenturi host
httpuseragent http_cookie
limitrate request_body_file
requestmethod remote_addr
remoteport remote_user
requestfilename request_uri
querystring scheme
serverprotocol server_addr
servername server_port
$uri

代码我保存了一份,可以点击链接下载:http://homeway.me/code/nginx-rewrite-conf.zip




本文出自 夏日小草,转载请注明出处:http://homeway.me/2015/05/22/nginx-rewrite-conf/


-by小草

2015-05-22 18:27:10

<think>好的,我现在需要帮助用户了解如何配置Nginx实现URL重定向。首先,用户的问题主要集中在方法和示例上,所以我应该先整理Nginx中常用的重定向方法,并提供具体的配置例子。 首先想到的是使用rewrite指令。用户可能需要将某个旧URL永久重定向到新URL,比如301重定向。这时候在server块里配置rewrite规则,用正则匹配旧的路径,然后重定向到新的地址。记得要加上permanent标志,表示永久重定向。例如,将/old-page重定向到http://example.com/new-page,用户提供的引用[1]里也有类似例子,可以引用这个。 接下来,用户可能还需要处理特定域名的重定向,比如将带www的域名重定向到不带www的,或者反过来。这时候可以再写一个server块,监听80端口,server_name写需要重定向的域名,然后返回301状态码,并在Location头里指定新的域名。这里要注意使用$request_uri变量来保留始请求的路径,这样用户访问www.example.com/path会被重定向到example.com/path。引用[2]里提到了使用$request_uri的例子,可以引用这个。 另外,用户可能需要临时重定向,比如302。这时候和301类似,但用redirect代替permanent。比如临时将/old-path重定向到/new-path,这种情况适用于测试或临时维护页面。 还有,用户可能需要根据条件进行重定向,比如参数匹配。例如,当URL中有特定参数时进行重定向。这时候可以用if语句结合$args变量来检查参数,然后返回重定向。但要注意,Nginx官方不推荐大量使用if,可能会影响性能,所以得提醒用户谨慎使用。引用[3]提到$args变量不会被编译,可以参考。 最后,要提醒用户配置完成后检查语法并重新加载配置。比如用nginx -t测试,然后nginx -s reload。这样用户就不会忘记应用配置。 现在需要把这些步骤整理成结构清晰的回答,每个方法配一个示例,并引用相关的参考资料。同时,按照用户的要求,生成相关问题,比如重定向类型区别、参数处理、性能影响等,帮助用户进一步学习。</think>### Nginx配置实现URL重定向的方法及示例 #### 1. **基础重定向配置** 使用`rewrite`指令实现路径重定向。例如将`/old-page`永久重定向到`http://example.com/new-page`: ```nginx server { listen 80; server_name example.com; location = /old-page { rewrite ^ http://example.com/new-page permanent; # 301永久重定向 } } ``` 此配置通过正则匹配路径`/old-page`,并使用`permanent`标志返回301状态码[^1]。 #### 2. **域名级重定向** 将`www.example.com`重定向到主域名`example.com`,并保留始请求路径: ```nginx server { listen 80; server_name www.example.com; return 301 http://example.com$request_uri; # $request_uri保留始请求路径 } ``` 此处通过`$request_uri`变量传递始URI,避免路径丢失[^2]。 #### 3. **临时重定向(302)** 使用`redirect`标志实现临时重定向: ```nginx location /old-path { rewrite ^ /new-path redirect; # 302临时重定向 } ``` 适用于测试环境或临时页面跳转。 #### 4. **基于条件的重定向** 根据请求参数进行重定向。例如将包含`id=123`的请求重定向到新页面: ```nginx if ($args ~* "id=123") { return 301 http://example.com/new-page; } ``` 注意`$args`变量直接匹配始请求参数,需谨慎使用`if`指令以避免性能问题[^3]。 #### 5. **配置验证与重载** 修改配置后需执行: ```bash nginx -t # 检查语法 nginx -s reload # 重新加载配置 ``` ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值