nginx开启pathinfo

更新日期：2026-11-11 22:27:02

标题

nginx开启pathinfo

内容

在使用Nginx作为Web服务器时，某些框架（如PHP的ThinkPHP、Laravel等）需要支持`PATH_INFO`来实现更灵活的URL路由。默认情况下，Nginx可能不支持`PATH_INFO`，因此需要进行配置调整。以下是对如何在Nginx中开启`PATH_INFO`的总结与配置说明。

一、什么是PATH_INFO？

`PATH_INFO`是CGI协议中的一种变量，用于存储URL路径中超出脚本名的部分。例如：

```

http://example.com/index.php/path/to/page

```

其中，`index.php`是脚本名，`/path/to/page`就是`PATH_INFO`的内容。

二、为什么需要开启PATH_INFO？

一些基于PHP的框架依赖于`PATH_INFO`来解析URL，比如：

- ThinkPHP

- Laravel（部分版本）

- CodeIgniter

如果不开启`PATH_INFO`，这些框架可能会出现404错误或无法正确解析请求路径。

三、Nginx中开启PATH_INFO的方法

要让Nginx支持`PATH_INFO`，通常需要修改Nginx的配置文件，添加特定的`location`块或调整`fastcgi_param`参数。

方法一：使用`location`匹配

```nginx

location ~ \.php$ {

include fastcgi_params;

fastcgi_passunix:/var/run/php/php-fpm.sock;

fastcgi_index index.php;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

启用PATH_INFO

if ($fastcgi_script_name ~ ^(.+\.php)(/.+)$) {

set $script $1;

set $path_info $2;

}

fastcgi_param SCRIPT_FILENAME $script;

fastcgi_param PATH_INFO $path_info;

}

```

方法二：使用`fastcgi_split_path_info`

```nginx

location ~ \.php$ {

include fastcgi_params;

fastcgi_passunix:/var/run/php/php-fpm.sock;

fastcgi_split_path_info ^(.+\.php)(/.)$;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

fastcgi_param PATH_INFO $fastcgi_path_info;

}

```

四、配置对比表

配置方式	是否推荐	说明
使用`if`判断	一般	简单易懂，但可能影响性能
使用`fastcgi_split_path_info`	推荐	更标准，兼容性更好
默认配置	不推荐	不支持PATH_INFO，可能导致框架出错

五、验证是否生效

配置完成后，建议通过以下方式验证：

1. 重启Nginx：

```bash

sudo nginx -s reload

```

2. 测试页面：

创建一个`test.php`文件，

```php

echo "PATH_INFO: " . $_SERVER['PATH_INFO'];

```

3. 访问地址：

```

http://your-domain.com/test.php/path/to/page

```

如果输出 `PATH_INFO: /path/to/page`，则表示配置成功。

六、注意事项

- 确保PHP-FPM已正确配置并运行。

- 如果使用的是PHP-FPM的`fcgiwrap`或其他方式，请根据实际情况调整`fastcgi_pass`。

- 避免在`location`中使用过于宽泛的正则表达式，防止安全风险。

通过以上配置和说明，可以有效在Nginx中开启`PATH_INFO`，从而支持更多PHP框架的URL路由需求。

随便看