ThinkPHP6必须用composer create-project初始化，框架移至vendor目录，禁直接改源码；默认单应用、配置拆分、.env统一管理；支持构造函数依赖注入、Query与Model分离、PSR-15中间件；session和模板引擎需手动启用。
安装和项目结构怎么改才不踩坑
ThinkPHP6 不再提供下载压缩包，必须用 composer create-project topthink/think tp 初始化。框架代码从项目根目录的 thinkphp/ 移到了 vendor/topthink/thinkphp/，这意味着你不能再直接修改框架源码——所有定制都得通过服务提供者、中间件或配置覆盖来实现。
常见错误现象：把 TP5 的 application/ 目录原样复制进 TP6 项目，结果路由不生效、控制器找不到、配置全失效。
- 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 可以这样写：
立即学习“PHP免费学习笔记（深入）”；
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() 后再调用 save() 报错的问题，也提升了类型安全。
路由方面，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，且不能被 Git 提交（应加进.gitignore），否则上线后数据库密码就暴露了
真正麻烦的从来不是“哪里报错了”，而是“为什么它不报错却不动了”。TP6 的设计哲学是“显式优于隐式”，所以很多 TP5 里默认开着的功能，在 TP6 里得你亲手打开——这不是倒退，是把控制权还给你。
