ThinkPHP作为一款流行的PHP框架，默认生成的URL中往往带有index.php入口文件，例如http://ippipp.com/index.php/Home/Index/index。这样的URL既不够简洁，也不利于搜索引擎优化，更重要的是暴露了应用的入口文件路径，存在一定安全隐患。在Nginx环境下，通过合理的URL重写配置，可以彻底隐藏index.php，让URL呈现出类似http://ippipp.com/Home/Index/index的干净形式。这个过程的本质是让Nginx将不存在的请求路径转移给ThinkPHP的入口文件，同时把原始请求信息传递给PHP解释器，从而让框架内部的URL路由机制正常接管请求。
理解这套配置需要先搞清楚Nginx与PHP-FPM的交互方式。Nginx并不直接执行PHP脚本，而是通过FastCGI协议将请求转发给PHP-FPM进程处理。当用户访问一个不存在的静态路径时，如果Nginx不做特殊处理，会直接返回404错误。URL重写的作用就是捕获这类请求，将其内部重定向到入口文件index.php，然后由ThinkPHP根据请求的URI解析出对应的模块、控制器和方法。这个过程中涉及两个核心点：一是如何高效地将请求重写到index.php，二是如何把原始路径信息传递给PHP，以便ThinkPHP能正确解析。
基础配置：使用try_files隐藏index.php
现代Nginx配置中，推荐使用try_files指令来实现URL重写，这也是ThinkPHP官方文档针对5.x和6.x版本给出的方案。try_files会按顺序检查文件或目录是否存在，如果都不存在，则将请求交给最后一个参数指定的URI。在ThinkPHP场景下，这个最后的URI就是/index.php。完整配置如下：
server {
listen 80;
server_name ippipp.com;
root /var/www/thinkphp/public;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi.conf;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
上述配置中，root指向了ThinkPHP应用的public目录，这是框架对外公开的根目录，核心框架文件位于上一级目录中，从而增强了安全性。location / 块中的try_files指令意味着：当请求的URI对应一个实际存在的文件时，直接返回该文件；如果对应一个目录，则尝试在该目录下寻找默认索引文件；只有当两者都不存在时，才会将请求重写到/index.php，同时把原有的查询字符串（$query_string）附加过去。这样，像http://ippipp.com/Home/Index/index这样的URL，最终会被Nginx内部转换为/index.php?/Home/Index/index（实际上是/index.php加原始请求URI），ThinkPHP就能从中解析出路径信息。
需要注意的是，include fastcgi.conf这一行非常关键。在许多Nginx默认配置中可能使用的是include fastcgi_params，但fastcgi.conf中包含了更完整的FastCGI参数定义，特别是DOCUMENT_ROOT、SCRIPT_NAME等变量。如果使用fastcgi_params，则需要手动补充一些参数，否则PHP可能无法正确获取脚本路径。推荐直接使用fastcgi.conf以简化配置。另外fastcgi_pass需要与实际的PHP-FPM监听地址保持一致，可以是Unix socket或TCP端口。
有些开发者可能见过旧版ThinkPHP 3.x使用的rewrite写法，例如：
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
}
这种写法也能实现隐藏index.php的效果，但存在明显缺陷。首先，nginx官方文档明确建议避免在location中使用if指令，因为if会导致配置上下文混乱，可能引发不可预料的行为。其次，rewrite后面使用?s=$1将路径拼接到查询字符串中，需要框架兼容s参数，而这种方式在ThinkPHP 5和6中已经不再推荐。相比之下，try_files更加简洁高效，性能更好，也更符合Nginx官方的推荐实践。
深入配置：支持PATH_INFO模式与兼容处理
ThinkPHP默认使用PATH_INFO模式来解析URL，例如/index.php/Home/Index/index中的/Home/Index/index就是PATH_INFO。当隐藏index.php后，请求路径变为/Home/Index/index，try_files将其重写为/index.php/Home/Index/index（注意没有查询字符串）。但Nginx在默认情况下不会将.php后面的路径识别为PATH_INFO，因此PHP脚本可能无法获取到正确的路径信息。为了让ThinkPHP能正常解析PATH_INFO，需要额外配置fastcgi_split_path_info指令。
fastcgi_split_path_info的作用是告诉Nginx如何将请求的URI分割成脚本文件名和PATH_INFO两部分。其正则表达式通常写作：
location ~ \.php {
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
include fastcgi.conf;
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;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
}
这个正则表达式的含义是：将URI拆分成两部分，第一部分以.php结尾（非贪婪匹配），第二部分是剩余的所有路径。例如请求/index.php/Home/Index/index会被拆分为脚本名/index.php和路径信息/Home/Index/index。通过fastcgi_param PATH_INFO $fastcgi_path_info将这路径信息传递给PHP，ThinkPHP就能从$_SERVER['PATH_INFO']中读取并解析出控制器和方法。同时设置PATH_TRANSLATED可以保证某些环境下PHP能够将路径信息映射到实际文件系统路径。
需要注意的是，location匹配条件从\.php$改成了\.php，去掉了$结尾锚点，这是因为当URL包含PATH_INFO时，URI以.php/xxx结尾，而不是以.php结尾。如果仍然使用\.php$，则只匹配以.php结尾的请求，无法捕获带有PATH_INFO的请求。另外，fastcgi_split_path_info指令必须放在location块内，并且不能与try_files同时使用（而是替换整个location ~ \.php块）。在实际部署时，如果使用ThinkPHP 5.1以上版本且没有特殊PATH_INFO需求，完全可以只用try_files配置，因为ThinkPHP能够通过REQUEST_URI自行解析路径，不一定依赖PATH_INFO。但如果遇到URL解析异常，启用PATH_INFO支持通常能解决问题。
还要提醒一点，Windows服务器上如果使用IIS或Apache，路径分隔符是反斜杠，但Nginx部署多在Linux环境，路径统一使用斜杠，这一点需要确认。如果配置文件是从Windows环境复制过来的，务必检查路径中是否混入了反斜杠，例如C:\www\thinkphp这样的路径在Linux下无法识别，需要转换为/var/www/thinkphp。
常见报错与排查思路
配置完成之后，启动Nginx并访问ThinkPHP应用，可能会遇到一些典型错误。最常出现的是404 Not Found。这通常意味着try_files没有正确匹配到入口文件，需要检查root路径是否指向了public目录，以及location /块中try_files最后一个参数是否写成了/index.php$uri或者漏掉了$query_string。如果框架版本较旧，可能需要使用rewrite写法，但建议升级框架并统一使用try_files。
另一个棘手的问题是“No input file specified”。这个错误表明Nginx成功将请求转发给了PHP-FPM，但PHP-FPM没有找到要执行的脚本文件。排查方向主要有两个：一是SCRIPT_FILENAME参数配置错误，例如使用了$document_root$fastcgi_script_name但document_root变量未正确定义，导致路径拼接错误；二是fastcgi_split_path_info将脚本名分割错误，使得SCRIPT_FILENAME指向了不存在的文件。可以通过在php配置中开启display_errors并查看错误日志来定位具体路径。通常确保root正确、SCRIPT_FILENAME完整即可解决。
如果访问时出现“Access denied”或者空白页面，可能涉及文件权限问题。PHP-FPM运行用户需要对public目录下的文件具有读权限，同时需要写权限的目录（如runtime）要正确设置。此外，部分Linux发行版默认启用了SELinux，可能阻止Nginx读取项目文件，需要执行setenforce 0临时关闭或配置相应的安全上下文。对于ThinkPHP 6，还需要确保public目录下存在.htaccess文件（Apache用）和index.php入口文件，虽然Nginx不读.htaccess，但入口文件必不可少。
最佳实践总结与安全建议
综合来看，为Nginx配置ThinkPHP的URL重写最推荐的方式是：使用try_files隐藏index.php，如果PATH_INFO解析正常就无需额外配置；如果遇到PATH_INFO问题，则在location ~ \.php块中加入fastcgi_split_path_info并正确传递PATH_INFO变量。整个server块配置应保持简洁，避免使用if判断，利用Nginx的顺序匹配特性来区分静态文件和PHP请求。同时，root目录必须指向public目录，这是框架安全架构的重要一环。
安全方面，除了隐藏index.php，还可以在Nginx中限制对敏感目录和文件的访问，例如阻止访问runtime目录、.env文件等。ThinkPHP的.env文件包含数据库密码等敏感信息，一旦泄露后果严重，可以在location中增加规则将其拦截。另外，生产环境务必关闭调试模式，设置正确的错误日志级别，并定期更新框架版本以修补安全漏洞。URL重写只是安全加固的一小部分，配合HTTPS、防火墙等措施才能构建完整的防护体系。
经过上述配置，你的ThinkPHP应用将拥有干净美观的URL，用户体验和SEO效果都会得到明显提升。如果仍然遇到问题，建议逐项检查Nginx错误日志和PHP-FPM日志，通常能够在日志中找到明确的错误线索。