讲师中心 微信公众号
AI工具推荐 视频效率加速

ThinkPHP在Nginx下如何开启Pathinfo_Nginx支持ThinkPHP路径信息【实战】

轻萱同学_7684

轻萱同学_7684

发布时间:2026-04-27 10:46:27

|

709人浏览过

|

来源于php中文网

原创

Nginx下ThinkPHP的Pathinfo URL无法解析时,需配置PATH_INFO传递:一、启用fastcgi_split_path_info并注入参数;二、用set+if手动分离;三、开启PHP的cgi.fix_pathinfo=1;四、try_files+rewrite隐藏入口;五、引入pathinfo.conf复用配置。

thinkphp在nginx下如何开启pathinfo_nginx支持thinkphp路径信息【实战】

如果您在Nginx环境下运行ThinkPHP应用,但发现类似 /index.php/admin/user/list 的Pathinfo格式URL无法正确解析路由或返回404错误,则很可能是Nginx未正确识别并传递PATH_INFO环境变量。以下是多种经实测有效的配置方法:

一、启用fastcgi_split_path_info并注入PATH_INFO参数

该方法适用于Nginx 0.7.31及以上版本,通过正则拆分请求URI,显式提取并设置PATH_INFO,是官方推荐的兼容性较强的方式。

1、编辑站点对应的Nginx配置文件(如 /usr/local/nginx/conf/vhost/your_domain.conf)。

2、定位到 location ~ \.php$ { } 或更宽泛的PHP匹配块(建议改用 location ~ [^/]\.php(/|$) { })。

立即学习“PHP免费学习笔记(深入)”;

3、在该块内添加以下三行关键指令:

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

fastcgi_param PATH_INFO $fastcgi_path_info;

fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;

4、确保已包含 fastcgi_params 或等效参数文件,并保留 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;。

5、保存后执行 nginx -t && nginx -s reload 重载配置。

二、使用set + if方式手动分离script与path_info

该方法不依赖fastcgi_split_path_info指令,在部分老旧Nginx版本或特殊路径结构下更稳定,通过变量重写实现PATH_INFO提取。

1、在PHP处理块中(如 location ~ \.php$ { }),删除原有fastcgi_pass前的所有if逻辑(如有)。

2、添加以下变量定义与条件判断:

set $real_script_name $fastcgi_script_name;

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

set $real_script_name $1;

set $path_info $2;

}

3、覆盖默认SCRIPT_NAME和新增PATH_INFO参数:

fastcgi_param SCRIPT_FILENAME $document_root$real_script_name;

fastcgi_param SCRIPT_NAME $real_script_name;

fastcgi_param PATH_INFO $path_info;

4、确认fastcgi_pass、fastcgi_index及include fastcgi.conf均存在且有效。

5、重启Nginx服务使配置生效。

三、修改PHP配置启用cgi.fix_pathinfo

此步骤为必要前置条件,若PHP未开启路径信息解析支持,Nginx传递的PATH_INFO将被忽略。必须与上述任一Nginx配置配合使用。

1、打开PHP主配置文件 /usr/local/php/etc/php.ini(路径依实际安装而定)。

amphp
amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码,依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态(http‑server、http‑client 等)。

下载

2、搜索 cgi.fix_pathinfo 配置项。

3、将其值由 0 改为 1,即: cgi.fix_pathinfo = 1。

4、保存文件后,重启PHP-FPM服务:systemctl restart php-fpm 或 service php-fpm restart。

四、配置try_files + rewrite隐藏入口并兼容Pathinfo

该方案同时解决入口文件暴露问题与Pathinfo路由识别,适用于ThinkPHP设置 'url_model' => 2(PATHINFO模式)或 3(兼容模式)的场景。

1、在server块内添加如下location块:

location / {

try_files $uri $uri/ /index.php?s=$uri&$args;

}

2、另起一个更精确的PHP处理块,匹配带路径后缀的PHP请求:

location ~ ^(.+\.php)(/.+)$ {

fastcgi_pass 127.0.0.1:9000;

fastcgi_index index.php;

include fastcgi.conf;

fastcgi_param SCRIPT_NAME $1;

fastcgi_param PATH_INFO $2;

}

3、确保index.php所在目录具有可执行权限,且ThinkPHP的public目录为root指定路径。

4、重载Nginx配置并验证URL如 /admin/user/edit/id/1 是否可正常响应。

五、引入独立pathinfo.conf复用配置

适用于LNMP一键包(如lnmp.org)或需多站点统一管理PATH_INFO行为的场景,通过外部引入方式降低重复配置风险。

1、在Nginx配置目录下创建文件:/usr/local/nginx/conf/pathinfo.conf。

2、向该文件写入标准PATH_INFO支持参数:

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

fastcgi_param PATH_INFO $fastcgi_path_info;

fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;

3、在各站点配置的PHP location块中,插入 include pathinfo.conf;。

4、检查所有涉及PHP处理的location是否已移除冲突的try_files或rewrite规则。

5、执行 nginx -t 验证语法,无误后重载服务。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

9384

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

5661

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2055

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3528

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4214

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3291

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4677

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3662

2023.11.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn