ThinkPHP 5.1 迁移至 6.0.16 需重构扩展类：改用 Composer PSR-4 自动加载，替换废弃类（如 Loader）、更新服务提供者（继承 thinkService 并注册到 provider.php）、重写命令行指令与中间件接口、调整初始化逻辑至 boot() 或事件监听，并通过日志和容器检测验证加载。
ThinkPHP 5.1 迁移到 6.0.16 时，扩展类（如自定义助手函数、服务提供者、中间件、命令行指令等）往往无法直接运行，核心原因是框架底层重构：容器机制升级、类自动加载规则变化、依赖注入方式调整、以及部分接口废弃或重命名。迁移不是简单复制粘贴，需针对性适配。
检查并替换已废弃的类与方法
TP6.0 彻底移除了 Loader 类和 vendor/topthink/think-helper 中的部分函数（如 array_column 兼容层）。原 TP5.1 中通过 Loader::import() 或手动 require 加载的扩展类，必须改为 Composer 自动加载方式。
- 将扩展类统一放入
app/extend/或独立命名空间目录（如app/library/），确保符合 PSR-4 规范 - 在
composer.json的"autoload"段中注册对应命名空间，例如：
"autoload": { "psr-4": { "app\extend\": "app/extend/" } } - 执行
composer dump-autoload刷新映射 - 查找代码中调用的
thinkLoader、thinkCache::handler()、thinkLog::init()等已移除方法，改用容器注入或新 API（如app('cache')、think acadeLog）
重写服务提供者与启动逻辑
TP5.1 的 service_provider 配置或 AppService 类在 TP6.0 中被 服务容器绑定 和 事件监听 替代。自定义服务若依赖 thinkService 基类，需重构为标准服务提供者。
- 新建类继承
thinkService（TP6.0 保留该基类），覆盖register()方法完成绑定，例如：
$this->app->bind('MyService', MyServiceImpl::class); - 在
app/provider.php中添加该服务提供者类全名（如app\provider\MyServiceProvider::class） - 原在
app/init.php中的全局初始化逻辑，应迁移到服务提供者的boot()方法或event.php中监听AppInit事件
适配命令行指令与中间件
TP6.0 的命令行指令类不再继承 thinkconsoleCommand，而是实现 thinkcontractConsoleCommandInterface；中间件也从闭包/类方法变为统一的 handle() 接口。
立即学习“PHP免费学习笔记（深入）”；
- 指令类需重写为：
class MyCommand implements ConsoleCommandInterface { public function configure(Command $command): void { ... } public function handle(Command $command): int { ... } } - 中间件类必须实现
thinkcontractMiddlewareInterface，且handle()方法签名变为：
public function handle(Request $request, Closure $next) - 原 TP5.1 中在
middleware.php中以字符串数组配置中间件的方式，TP6.0 支持类名、闭包、带参数的数组形式（如[MyMiddleware::class, 'param']），但需确保类已正确加载
验证扩展行为与日志输出
迁移后容易忽略的是扩展类在生命周期中的实际触发时机。TP6.0 启动流程更严格：应用实例化 → 容器注册 → 配置加载 → 事件触发 → 路由调度。某些在 TP5.1 中“提前生效”的扩展，在 TP6.0 可能因加载顺序导致未就绪。
- 启用调试模式（
app_debug = true），观察runtime/log/下日志是否出现Class not found或Call to undefined method - 对关键扩展添加
Log::info('MyExtension loaded');，确认其在boot()或首次调用时正常执行 - 使用
app()->has('MyService')或app('MyService')主动测试服务是否可解析
