ThinkPHP5和6版本差异在哪里_ThinkPHP5与6版本差异汇总【指南】

先说几个核心判断：ThinkPHP6 和 5 的差异，远比版本号暗示的更大。如果你是从 TP5 直接跳到 TP6，第一件事就是忘掉“下载压缩包”这个操作——TP6 必须用 Composer 才能初始化项目，框架代码被挪到了 vendor/topthink/thinkphp/ 下面，想直接改源码？路堵死了。所有定制都得走服务提供者、中间件或者配置覆盖这条路。

更直白点说，把 TP5 的 application/ 目录原样复制进 TP6 项目，结果就是路由不生效、控制器找不到、配置全失效——这不是吓唬人，是真实踩坑现场。

安装和项目结构怎么改才不踩坑

TP6 初始化只有一条命令：composer create-project topthink/think tp。框架代码从根目录的 thinkphp/ 移到了 vendor/topthink/thinkphp/，这意味着你不能像以前那样直接修改框架的源文件——所有定制都要通过服务提供者、中间件或配置覆盖来实现。

有几点必须注意：

• TP6 默认是单应用结构，app 目录就是应用根目录。如果需要多应用，必须额外安装扩展：composer require topthink/think-multi-app。
• config/ 下的文件已经拆成了独立的 app.php、database.php、route.php，别想着再找一个统一的 config.php。
• 环境配置统一走 .env 文件——注意，文件名不能加后缀，像 .env.development 这样是不认的。内容格式是 DB_HOST=127.0.0.1 这种，读取时会自动合并进配置。

依赖注入和控制器写法变了没？

变了，而且是根本性变化。TP6 原生支持构造函数注入，TP5 则靠门面（Facade）和静态调用撑场子。区别在哪？在 TP6 里，你可以在控制器构造函数里直接声明依赖，框架自动解析并传入；而 TP5 中多数服务还得用 think\Db::table() 这类静态调用，耦合重、难测试。

举个例子，写一个需要发邮件又查数据库的接口，TP6 的写法是这样：

class OrderController extends Controller
{
    public function __construct(think\mail\Mailer $mailer, think\Model $model)
    {
        $this->mailer = $mailer;
        $this->model  = $model;
    }
}

而在 TP5 中，你几乎只能在方法内部用 Db::table() 或 Mail::send()，无法在构造函数中注入。

其他变化也不小：

• TP6 的容器严格遵循 PSR-11，支持 bind、singleton、instance 等标准操作；TP5 的容器更像工厂，不支持类型提示自动解析。
• TP5 里常用的 $this->assign() 和 $this->fetch()，在 TP6 中默认不可用——因为 TP6 默认不加载模板引擎。需要用的话，得手动引入 topthink/think-view 并注册视图中间件。
• 控制器基类不再是 think\Controller，而是 think\controller\AbstractController。继承方式不变，但内部逻辑已经重构。

数据库和路由这些高频功能有啥实际差异

数据库层最明显的改变是 Query 和 Model 彻底分离。TP6 中 think\db\Query 只负责查询构建，think\Model 负责数据建模与持久化，不再混用。这个改动修复了 TP5 中链式调用 where()->order()->limit() 后再调用 sa ve() 报错的经典问题，也提升了类型安全。

路由方面，TP5 写在 route/route.php 里，TP6 推荐用注解路由（需安装 topthink/think-annotation），不过传统的 PHP 数组定义仍然能用。

• TP5 的 Db::name('user')->where('id', 1)->find() 在 TP6 还能跑，但底层走的已经是 Query 类了；如果用模型，必须先定义 UserModel extends Model，然后调用 UserModel::find(1)。
• TP6 路由支持缓存编译，开启后首次访问稍慢，后续极快。TP5 则是每次请求都解析路由，高并发下开销不小。
• TP6 中间件采用 PSR-15 标准，用 process($request, DelegateInterface $delegate) 管道式执行；TP5 中间件的返回值处理不统一，容易漏掉 $next($request)。

升级老项目时最容易被忽略的点

最坑的不是语法报错，而是“看起来正常，但行为不对”——比如 session 默认关闭、模板引擎默认不加载、多应用模式默认禁用。这些默认值的变更不会导致启动失败，但会让页面白屏、登录态丢失、变量渲染为空。

• TP6 默认不启用 session，需要在 middleware.php 中显式注册：\think\middleware\SessionInit::class。
• TP6 默认不加载官方模板引擎，所以 $this->fetch() 会直接抛出 BadMethodCallException。正确做法是运行 composer require topthink/think-view，然后在 app/middleware.php 加上 \think\middleware\ViewInit::class。
• TP5 中用 Config::get('database') 可以获取整个数组，TP6 必须写全路径：Config::get('database.hostname')，否则返回 null。
• .env 文件权限建议设为 644，并且一定要加入 .gitignore，否则上线后数据库密码就暴露了。

真正麻烦的从来不是“哪里报错了”，而是“为什么它不报错却不动了”。TP6 的设计哲学是“显式优于隐式”——很多 TP5 里默认开着的功能，在 TP6 里需要你亲手打开。这不是倒退，是把控制权还给了你。