ThinkPHP 8.1是面向现代PHP生态的重构版本，深度适配PHP 8.1–8.4，强调性能、安全与开发体验统一，具备更灵活路由、语义化验证、原生Swoole集成及轻量高效ORM。
ThinkPHP 8.1 是当前稳定主力版本，深度适配 PHP 8.1–8.4，强调性能、安全与开发体验的统一。它不是 TP5 或 TP6 的简单升级，而是一次面向现代 PHP 生态的重构——路由更灵活、验证更语义化、Swoole 集成更原生、模板与 ORM 更轻量高效。掌握它，关键不在记命令，而在理清“请求怎么进来、数据怎么流动、错误怎么拦截、服务怎么扩展”这四条主线。
核心配置与项目启动
安装后第一件事是确认环境就绪：PHP ≥ 8.1（需开启 PDO、mbstring、json、openssl）、Composer 2.5+、Web 服务器（推荐用内置服务快速验证）。执行以下命令即可启动默认欢迎页：
-
创建项目：
composer create-project topthink/think:8.1.* myapp -
启动服务：
cd myapp && php think run（默认监听http://localhost:8000） -
检查配置：入口文件
public/index.php不建议修改；所有业务配置集中在app/config/下，数据库配置在app/config/database.php，路由主文件为route/app.php
路由与控制器响应闭环
URL 路径不会自动映射到控制器方法，必须显式建立路由规则。常见 404 多因三处断点：
-
路由未启用：检查
config/app.php中'url_route_on' => true是否存在且为true（TP6 某些模板默认关闭） -
路由注册错误：在
route/app.php中写Route::get('user/profile', 'app\controller\User@profile')，注意命名空间完整、@符号不可替换 -
控制器不合规：控制器类必须位于
app/controller/User.php，继承think\controller\AbstractController（TP8 不再支持think\Controller），方法返回字符串、数组或Response对象
数据库与模型操作
TP8.1 的 ORM 默认使用 PDO，支持链式查询、事务、软删除、JSON 字段原生处理。建模无需手写 SQL：
立即学习“PHP免费学习笔记（深入）”；
-
定义模型：在
app/model/User.php中声明class User extends Model { protected $table = 'users'; } -
基础查询：
User::where('status', 1)->order('id desc')->limit(10)->select()返回 Collection 对象 -
关联预载：支持
hasMany、belongsTo等，用with('posts')避免 N+1 查询 -
迁移管理：通过
php think migrate:make create_users_table生成迁移文件，再php think migrate:run执行
进阶能力与生态集成
TP8.1 的真正优势体现在与现代工具链的无缝衔接：
-
QueryList 抓取：装
jaeger/querylist后，在app/provider.php注册QL\QueryList::class，命令行中可直接QueryList::get($url)->find('h3')->texts() -
Swoole 长连接：装
topthink/think-swoole后，运行php think swoole启动协程服务，WebSocket 路由和事件处理器均按约定目录自动加载 -
Docker 微服务化：推荐用
docker-compose.yml分离 PHP-FPM、Nginx、MySQL 三容器，挂载代码目录、配置独立网络、共享runtime卷，新人一条命令即得全栈环境 -
多端 API 支持：用路由分组 + 中间件实现接口版本控制，如
Route::group('api/v1', [...])->middleware([Cors::class, ApiAuth::class])
