nginx配置thinkphp核心在于让nginx正确解析pathinfo格式的URL，并配合rewrite规则实现伪静态，配置不当最常见的表现就是404或500错误。
nginx配置thinkphp的路径模式解析问题
很多人第一次在nginx上跑thinkphp都会遇到这样的情况：首页能打开，一进二级页面就404，这不是程序写错了，而是nginx默认不认识pathinfo这种URL格式，thinkphp在5.0以上版本默认采用pathinfo模式，URL长这样：/index.php/Home/Index/index。
nginx下pathinfo模式配置的关键点
Apache默认支持pathinfo，nginx不一样，它需要显式配置才能把/index.php/后面的部分传给PHP处理,这里给出一个经过验证的server配置片段：
location ~ \.php($|/) {
fastcgi_pass 127.0.0.1:9000;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
fastcgi_split_path_info是其中最关键的指令，它用正则把请求拆成脚本名和pathinfo两部分，正则里的(.+\.php)是脚本路径，是路径信息，如果你发现配置完后css、js文件能访问，但页面链接还是404,检查一下这个正则有没有被注释掉。
nginx配置thinkphp伪静态怎么写
伪静态是另一个高频需求，目的是把URL里的index.php去掉，让链接变成/Home/Index/index这种形式，thinkphp官网提供的标准rewrite规则在nginx上同样适用,但不少人在复制过程中丢了条件判断。
标准rewrite规则逐行说明
location / {
if (!-e $request_filename) {
rewrite ^/(.)$ /index.php/\ last;
}
}
这段规则的含义是：如果请求的文件在磁盘上不存在，就重写给index.php处理。if (!-e $request_filename)很好理解，就是判断文件是否存在，存在就直接访问，比如css、js、图片这些静态资源,不存在就进入thinkphp的路由分发。
有人问nginx配置thinkphp伪静态和Apache有什么区别，可以明确地说，核心逻辑一致，但nginx的last标志对应Apache的L标志，且nginx不允许在if块里嵌套其他指令，所以写法上更简洁，另外在thinkphp 5.1及以上版本，还可以在配置文件中设置'url_route_on' => true配合路由定义,和nginx规则不冲突。
实际配置中匹配优先级的干扰
还有一类问题是服务器本身有多个location块，比如有人为了处理静态文件先写了一个location /static/，然后又写了一个location /，结果thinkphp的页面全变成了下载文件或者直接404，这是nginx的location匹配优先级在起作用，精确匹配location =优先于前缀匹配，前缀匹配优先于正则匹配，正则匹配优先于通用匹配，如果你在正则location里写了\.php$，而thinkphp的URL是pathinfo形式，那按照上面的规则，/index.php/Home/Index/index会被\.php$命中，因为nginx会从右往左看，/index.php/...以.php结尾的地方仍然符合正则的末尾匹配。
解决nginx配置thinkphp出现404的排查路径
404是nginx配thinkphp时最常见的报错,解决思路从简单到复杂可以有这样一个排查顺序。
检查URL模式是否匹配配置
先看thinkphp配置文件里url_convert和url_html_suffix的设置，如果开启了'url_html_suffix' => 'html'，那么访问/Home/Index/index.html时nginx的rewrite规则可能无法正确匹配，因为.html后缀会让nginx先尝试找物理文件，多数情况下，把url_html_suffix留空或者设成html|htm都可以,但需要和nginx规则配合。
确认php-fpm监听方式
nginx和php之间的通信有两种方式：unix socket和tcp端口，socket方式效率更高，但在配置里要写对路径，常见错误是nginx配了
fastcgi_pass unix:/tmp/php-cgi.sock;，而php-fpm实际监听的是0.0.1:9000，这样就会导致502，检查php-fpm.conf或pool.d/www.conf里的listen项,确保和nginx保持一致。
多应用模式的额外配置
thinkphp 6.0以上版本支持多应用模式，目录结构变成app/应用名/controller/方法，这种情况下nginx配置thinkphp和单应用模式有一点不同，URL会多一层应用名，如果只配置了单应用的rewrite规则，多应用模式下访问/admin/Index/index也会404,这时候需要把rewrite规则改成：
location / {
if (!-e $request_filename) {
rewrite ^/(.)$ /index.php?s=/\ last;
}
}
注意这个?s=参数，它是给thinkphp的入口文件传递路由参数的,多应用模式下必须有这个参数才能正确分发到对应的应用。
nginx和thinkphp搭配的环境配置建议
前面说的大部分是规则层面的内容，最后补充两块环境层面的建议,这部分直接影响稳定性和性能。
运行目录的设定
thinkphp 6.0官方要求把web根目录指向public目录，nginx的root指令也要跟着改，之前的写法是root /www/wwwroot/项目名;，现在应该是root /www/wwwroot/项目名/public;，有两个好处，一是防止用户直接访问application目录下的php文件，安全性更高；二是URL可以少写一层public,不需要额外rewrite。
并发连接数的粗调
nginx默认配置在低并发下完全够用，但如果站点有访问量，可以适当调整worker_processes为CPU核心数，worker_connections为4096或更大，thinkphp这类PHP框架每次请求都要经过路由解析和框架初始化，通过nginx开启fastcgi_cache可以缓解php-fpm的压力，在server块外添加：
fastcgi_cache_path /var/cache/nginx levels=1:2 keys_zone=thinkphp_cache:100m inactive=60m;
然后在server块内、location ~ \.php块内添加：
fastcgi_cache thinkphp_cache; fastcgi_cache_valid 200 302 1h; fastcgi_cache_valid 301 1d;
开启后刷新页面观察响应头，如果出现X-Cache: HIT就说明缓存生效了，行业共识认为，这种缓存策略在动态站点改造中能立竿见影地提升响应速度，但要注意设置了session或需要实时数据的页面不能盲目缓存。
常见nginx配置thinkphp的问题解答
nginx配置thinkphp后如何开启URL重写隐藏index.php？
在nginx的server块中添加location /的rewrite规则即可，内容为本文章节中提到的if (!-e $request_filename)判断块，同时确认thinkphp配置文件中url_route_on为开启状态，且没有在nginx.conf中禁用pathinfo相关的fastcgi参数。
本地环境nginx配置thinkphp和服务器上有什么区别？
本地环境通常用lnmp一键包或者docker搭建，核心规则一致，区别在于本地往往开着thinkphp的调试模式，入口文件直接放在根目录，docker环境下需要确认容器内的root路径和宿主机同步是否正确,挂载卷路径不一致是最常见的本地环境404原因。
nginx配置thinkphp时报500错误且日志提示open_basedir怎么处理？
这是php-fpm的安全限制在起作用，打开php.ini或对应站点的配置文件，把open_basedir设置为项目根目录加上/tmp目录，例如open_basedir=/www/wwwroot/项目名/:/tmp/，保存后重启php-fpm即可，这个报错在宝塔面板中尤为常见，因为面板默认会对每个站点生成独立的open_basedir配置。
配置本身并不复杂，理清pathinfo传递、rewrite规则和fastcgi参数三个环节,nginx配置thinkphp这件事就能踏踏实实落地。