nginx中怎么配置pathinfo模式

发布时间：2022-04-29 17:27:45 作者：zzz
来源：亿速云阅读：585

# nginx中怎么配置pathinfo模式

## 什么是pathinfo模式

Pathinfo模式是一种URL路由方式，它允许通过URL路径传递参数，而不是传统的查询字符串方式。典型的pathinfo URL格式如下：

http://example.com/index.php/article/123


在这个URL中：
- `index.php` 是入口文件
- `/article/123` 是pathinfo部分，会被解析为路由参数

与传统查询字符串URL（`http://example.com/index.php?c=article&id=123`）相比，pathinfo模式具有以下优势：

1. URL更加简洁美观
2. 对搜索引擎更友好
3. 隐藏了实际脚本路径和参数名
4. 符合RESTful风格的设计原则

## nginx默认不支持pathinfo的原因

与Apache不同，nginx默认没有内置pathinfo处理功能，这是因为：

1. **设计哲学差异**：nginx更倾向于显式配置而非隐式规则
2. **性能考虑**：避免不必要的路径解析开销
3. **安全性**：减少潜在的文件路径泄露风险

当直接访问pathinfo风格的URL时，nginx会尝试查找名为`index.php/article/123`的文件，这显然不存在，导致404错误。

## 配置前的准备工作

在开始配置前，请确保：

1. 已安装nginx和PHP-FPM
2. 了解nginx配置文件的基本结构
3. 有服务器配置文件的编辑权限

检查当前nginx是否支持PHP：

```bash
nginx -V | grep -i http_stub_status

确认PHP-FPM监听方式：

netstat -tulnp | grep php-fpm

基础pathinfo配置方法

方法一：使用try_files指令

这是推荐的标准配置方式：

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        
        # 关键pathinfo配置
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
    }
}

关键配置说明：

fastcgi_split_path_info：正则表达式分割路径
fastcgi_param PATH_INFO：设置PATH_INFO参数
fastcgi_param PATH_TRANSLATED：映射路径到文件系统

方法二：使用if判断（不推荐）

虽然可以实现，但nginx官方不推荐过多使用if：

location ~ \.php {
    # ...其他fastcgi配置
    
    if (!-f $document_root$fastcgi_script_name) {
        return 404;
    }
    
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    # ...其他pathinfo配置
}

高级配置技巧

处理带斜杠的pathinfo

某些框架需要处理尾部斜杠：

location ~ \.php(/|$) {
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    # ...其他配置
    
    fastcgi_split_path_info ^(.+\.php)(/.*)$;
    set $path_info $fastcgi_path_info;
    try_files $fastcgi_script_name =404;
    
    fastcgi_param PATH_INFO $path_info;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

隐藏入口文件

实现类似http://example.com/article/123的URL：

location / {
    try_files $uri $uri/ /index.php$is_args$args;
}

location ~ \.php {
    # ...pathinfo配置
}

多入口文件支持

适用于多应用场景：

set $entry_file index.php;
if ($request_uri ~* "^/admin(/|$)") {
    set $entry_file admin.php;
}

location / {
    try_files $uri $uri/ /$entry_file$is_args$args;
}

常见框架的特定配置

Laravel配置示例

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_param PATH_INFO $fastcgi_path_info;
}

ThinkPHP配置

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}

location ~ \.php$ {
    # ...标准pathinfo配置
}

安全注意事项

禁用脚本上传：确保用户不能上传PHP文件
```
location ~* /uploads/.*\.php$ {
   deny all;
}
```

限制PHP执行目录：

location ~* ^/(runtime|uploads)/.*\.php$ {
   deny all;
}

隐藏PHP版本信息：
```
fastcgi_hide_header X-Powered-By;
```

PATH_INFO验证：

if ($fastcgi_path_info ~* "^/(.*)\.php(/.+)$") {
   set $valid_path $1;
}

性能优化建议

启用OPcache：

[opcache]
opcache.enable=1
opcache.memory_consumption=128

调整fastcgi缓冲：

fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;

启用文件缓存：
```
open_file_cache max=1000 inactive=20s;
```

故障排查指南

常见问题及解决方案

404错误：
- 检查try_files配置
- 确认SCRIPT_FILENAME设置正确
No input file specified：
- 检查文件路径权限
- 确认$document_root设置正确
PATH_INFO为空：
- 检查fastcgi_split_path_info正则
- 确保没有其他rewrite规则干扰

调试方法

检查变量值：

add_header X-Debug-Path "$request_filename:$fastcgi_path_info";

查看PHP全局变量：
```
<?php var_dump($_SERVER); ?>
```
nginx错误日志：
```
tail -f /var/log/nginx/error.log
```

替代方案比较

方案	优点	缺点
pathinfo	URL简洁，SEO友好	需要特殊配置
查询字符串	兼容性好	URL不美观
rewrite	灵活性高	配置复杂
静态路由	性能最好	维护成本高

结论

在nginx中配置pathinfo模式需要理解其工作原理，并通过正确的fastcgi参数传递路径信息。本文介绍的标准配置方法适用于大多数PHP框架，同时提供了安全加固和性能优化的建议。实际部署时，应根据具体应用需求选择合适的配置方案，并通过日志监控确保配置生效。

附录：完整配置示例

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.php;

    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
        
        include fastcgi_params;
        fastcgi_hide_header X-Powered-By;
    }

    location ~* \.(jpg|jpeg|gif|png|css|js|ico|webp)$ {
        expires 30d;
        access_log off;
    }

    location ~ /\.ht {
        deny all;
    }
}

通过以上配置，您的nginx服务器将能够正确处理pathinfo模式的URL，同时保持良好的安全性和性能表现。 “`