Think项目上线如何隐藏口文件 Nginx URL重写配置案例|Duuu笔记
解决实际问题的PHP最佳实践
ThinkPHP 访问不到 index.php 导致 404 的根本原因是 Nginx 未将伪静态请求重写至 index.php，需配置 try_files $uri $uri/ /index.php?$query_string; 并确保 root 指向 public/ 目录、静态资源 location 优先且放行、SCRIPT_FILENAME 与 root 对齐、文件权限正确。
ThinkPHP 为什么访问不到
index.php
就 404？
不是代码问题，是 Nginx 根本没把请求转给 PHP 处理。默认配置下，Nginx 只认真实存在的文件，而 ThinkPHP 的 URL 是伪静态（比如
/user/list
），背后实际要走
index.php
入口，但 Nginx 不知道该转发——它直接去磁盘找
/user/list
这个路径，当然 404。
关键点在于：必须让 Nginx 把所有非静态资源请求，全部重写到
index.php
，再由框架自己解析路由。
静态资源（
.js
、
.css
、
.png
等）要放行，不走重写，否则性能崩、缓存失效
try_files
是最稳妥的写法，比
rewrite
更少出错；
try_files $uri $uri/ /index.php?$query_string;
是核心
务必确认
root
指向的是
public/
目录，不是项目根目录；否则
index.php
路径会错
如果用了子目录部署（比如
https://example.com/app/
），
location
块要带前缀，且
try_files
中的
/index.php
要对应成
/app/index.php
Nginx 配置里
fastcgi_param SCRIPT_FILENAME
为什么总报 No input file specified？
这是最常见的 502 或 500 错误根源。Nginx 找到了
index.php
，但传给 PHP-FPM 的文件路径错了——PHP 收到的是一个不存在或权限不对的路径。
根本原因：Nginx 的
root
和
fastcgi_param SCRIPT_FILENAME
没对齐。
“
PHP免费学习笔记（深入）
”；
如果
root /var/www/myapp/public;
，那
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
才正确
千万别写死成
/var/www/myapp/public/index.php
，否则换环境就挂
检查 PHP-FPM 的
security.limit_extensions
是否包含
.php
（默认是，但有些精简镜像会删掉）
用
ls -l /var/www/myapp/public/index.php
确认文件存在且 Nginx 用户（如
www-data
）有读取权限
ThinkPHP 的
URL_MODEL
和 Nginx 重写怎么配合？
ThinkPHP 的
URL_MODEL
（现在叫
url_commonly
或
url_route_must
）只影响框架内部生成 URL 的方式，**不影响 Nginx 怎么转发请求**。Nginx 重写规则本身和这个配置无关——它只管“所有非静态请求都推给
index.php
”。
但上线时容易混淆：你开了
url_route_must = true
，结果 Nginx 没配好，页面全是 404，就以为是框架配置问题。
只要 Nginx 正确重写，
url_route_must
和
url_commonly
都能工作
如果你用的是 ThinkPHP 6+，确保
config/app.php
中
'url_domain_deploy' => false
（除非真需要二级域名路由）
调试时临时加一行
echo $_SERVER['REQUEST_URI']; die();
到
public/index.php
开头，看 Nginx 是否真的把原始 URL 传进来了
上线后 CSS/JS 404 或者页面空白，但 HTML 能加载？
说明 Nginx 重写生效了，但静态资源被错误地也重写进了
index.php
，导致 PHP 尝试解析 JS 文件——当然失败，返回空或乱码。
典型表现：浏览器 Network 面板里，
style.css
返回状态码 200，但响应体是 HTML 内容。
必须在
location ~ \.(js|css|png|jpg|gif|svg|ico|woff2?)$
块里显式加
try_files $uri =404;
，禁止 fallback 到
index.php
注意正则顺序：静态资源
location
必须写在主重写
location /
之前，Nginx 匹配是按配置顺序的
如果用了 CDN 或反向代理，检查是否缓存了错误响应（比如 200 空内容），清缓存再试
用
curl -I https://yoursite.com/static/css/app.css
看返回的
Content-Type
是不是
text/css
，不是就说明被 PHP 处理了
最常被忽略的其实是
root
路径和
public/
目录权限的组合问题——配置看着全对，但 Nginx 用户根本读不了那个目录，连日志都不报错，只默默返回 403 或 404。
