ThinkPHP项目上线如何隐藏入口文件_Nginx URL重写配置详解-ThinkPHP-PHP中文网

thinkphp 访问不到 index.php 导致 404 的根本原因是 nginx 未将伪静态请求重写至 index.php，需配置 try_files $uri $uri/ /index.php?$query_string; 并确保 root 指向 public/ 目录、静态资源 location 优先且放行、script_filename 与 root 对齐、文件权限正确。

thinkphp项目上线如何隐藏入口文件_nginx url重写配置详解

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 没对齐。

如果 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 处理了