新手入门：ThinkPHP隐藏index.php的完整配置指南【教程】-ThinkPHP-PHP中文网

隐藏index.php必须同时满足web服务器正确转发请求、thinkphp路由机制接管请求、入口文件路径和权限正确三者，缺一不可，否则必404。

新手入门：thinkphp隐藏index.php的完整配置指南【教程】

隐藏 index.php 不是改个配置就能生效的事——它必须同时满足三件事：Web 服务器把请求正确转发到 index.php、ThinkPHP 路由机制实际接管了这个请求、入口文件路径和权限完全正确。缺一不可，否则必 404。

很多人把 ThinkPHP 自带的 .htaccess 放进 public/ 目录就以为完事了，结果访问仍带 index.php 或直接 403/500。

确认 Apache 已加载 rewrite_module：httpd -M | grep rewrite，没输出就得在 httpd.conf 里取消 #LoadModule rewrite_module modules/mod_rewrite.so 的注释
AllowOverride 必须是 All，不是 FileInfo 或 None；如果用了虚拟主机，<directory></directory> 块里也得显式写上
.htaccess 必须放在 public/ 目录（即 index.php 同级），且 Apache 运行用户（如 www-data）有读取权限；Windows 下 phpStudy 等集成环境默认用 FastCGI，此时 RewriteRule ^(.*)$ index.php/$1 会失效，得换成 RewriteRule ^(.*)$ index.php?s=/$1

只配 location / 是常见错误。Nginx 会先匹配 location /，但真正执行 PHP 的是 location ~ \.php$ 块——如果这块没配 try_files 或 SCRIPT_FILENAME 指向错误，请求根本进不了 index.php。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

root 指令必须指向 public/ 目录，例如 root /var/www/myapp/public;；写成项目根目录会导致 $document_root/index.php 找不到
location / 推荐用：try_files $uri $uri/ /index.php?s=$uri&$args; ——$args 不能省，否则 GET 参数丢失
location ~ \.php$ 必须包含：try_files $uri =404;（防止 Nginx 尝试找不存在的 .php 文件） + fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;（路径必须准确）
删掉所有 fastcgi_split_path_info 相关行；TP6 默认走 s= 参数解析路由，PATH_INFO 会干扰匹配

框架层不接管请求，Web 服务器转发过去也只是返回原始 PHP 文件内容，不会触发路由逻辑。

TP5 必须在 config/app.php 中显式设置：'url_route_on' => true，且 'url_commonly' => false（禁用兼容模式，否则 fallback 到 GET 参数解析）
TP6 默认开启路由，但若项目启用了多应用模式，需确认 default_app 是否指向正确入口，否则子应用路由可能未加载
pathinfo_depr 必须设为 '/'，且与你实际 URL 分隔符一致；设为空或 '.' 会导致 /user/list 这类路径无法匹配

很多“配置成功”其实是假象，刷新页面或点击链接就露馅。

浏览器可能缓存了 301 重定向，比如之前访问过 /index.php/user，现在删掉 index.php 却仍跳转回去；清空浏览器缓存或用隐身窗口测试
访问路径要和部署位置一致：项目放在子目录（如 http://localhost/myapp/），try_files 中的 fallback 就得写成 /myapp/index.php?s=...，不是 /index.php
静态资源（.js、.css）必须能直接访问；如果它们也 404，说明 root 指向错误或 location ~ \.(js|css|png)$ 块缺失，导致这些请求被错误地交给 index.php 处理