用过 ThinkPHP 的人都会注意到 public/index.php 这个文件，很多新手的问题是：为什么整个网站就靠一个 index.php 入口？它到底做了什么？本文按“入口文件职责 → 源码逐行解释 → URL rewrite 配套 → 常见入口报错”四段讲透，适用于 TP5/TP6/TP8 的主流结构。

一、单入口设计的三个目的

1. 统一收口：所有请求都经过同一个文件，框架在这里统一完成路由分发、中间件、安全检查，业务目录（application/、vendor/）不直接暴露。
2. 目录隔离：只有 public 目录作为 Web 根，配置文件、.env、运行日志都在根目录上层，即使 Nginx 配错也不会源码泄露。
3. URL 简化：配合 rewrite，把 index.php?s=/user/read/id/3 变成 /user/read/3 这类可读地址。

二、入口文件源码逐行看

ThinkPHP 6/8 的 public/index.php 核心只有几行：

<?php
// 应用目录定位（默认在 public 上一级的 app 目录）
namespace think;

// 引入自动加载（composer 的 autoload 与框架加载链）
require __DIR__ . '/../vendor/autoload.php';

// 执行HTTP应用并响应
$http = (new App())->http;

$response = $http->run();

$response->send();

$http->end($response);

逐条职责：autoload.php 把框架、扩展、应用的类全部挂上自动加载；App()->http->run() 内部依次做——读取请求（GET/POST/头部）→ 匹配路由 → 过中间件与过滤器 → 调用控制器方法 → 生成 Response 对象；send() 才是真正吐给浏览器的输出。入口文件本身不含任何业务逻辑，这也是它能常年不改的原因。

TP5 老项目常见写法是 define('APP_PATH', __DIR__ . '/../application/'); 再 require thinkPHP.php，原理相同，只是加载方式更原始。

三、URL 访问模式与 .htaccess 配套

ThinkPHP 的 PATH_INFO 模式（/index.php/模块/操作）依赖 Apache/Nginx 正确传递路径信息。Apache 下 public/.htaccess 标准内容：

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
</IfModule>

Nginx 对应配法：

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}

没配 rewrite 时站点依然能跑，只是 URL 必须带着 index.php?s=；有些主机不支持 rewrite 时，把 config/app.php 里 url_html_suffix 与 s 变量参数策略打开即可兼容。

四、围绕入口的四个高频报错

• 500 白屏/页面空白：入口能执行但应用抛异常。先开 APP_DEBUG=true 看真实错误；生产环境记得关闭并看 runtime 日志。
• 404 但首页正常：多半是 rewrite 的 E=PATH_INFO/兼容模式没生效，或 Nginx 的 fastcgi_split_path_info 缺失。给 PHP-FPM 补 cgi.fix_pathinfo=1 再测。
• 把源码直接显示出来：Web 根目录没交给 PHP 处理（宝塔/虚拟主机没切对站点目录），把站点根指向 public 即可解决。
• .env 泄出风险：站点根没限制在 public 时，https://域名/.env 能直接下载——这是入口目录配置错误造成的经典安全事故，自查一遍。

五、常见问题 FAQ

问：能不能改名，比如入口叫 app.php？
答：可以，改 .htaccess/rewrite 目标并同步 public/index.php 文件名即可，但多语言与插件默认地址都按 index 约定，改名只带来麻烦。

问：index.html 和 index.php 谁优先？
答：由服务器的 DirectoryIndex 顺序决定，Apache 默认 index.html 在前；存在 index.html 时会先命中静态页，这是“改了代码不生效”的经典原因，删掉多余的 index.html 即可。

小结：index.php 的职责就三件事——定位应用、启动框架处理请求、把响应发出去；单入口 + public 目录隔离 + rewrite 是 ThinkPHP 安全与美观 URL 的地基，遇到 500/404/源码外泄，先检查这三样配置是否成体系。

• ThinkPHP
• index.php
• PHP框架