ThinkPHP 8.0模型升级为强类型需四步：替换Model基类与命名空间、修正field()参数为数组或启用强类型属性声明、重写关联方法并规范预载入语法、配置$type自动转换及使用Attribute语法监听事件。
将ThinkPHP 8.0模型升级为强类型并适配think-orm 3.0，需同步处理类声明、字段传参、类型约束与关联加载方式，否则运行时会静默返回全字段或抛出类型错误。
替换模型基类与命名空间
第一步：打开 app/model/User.php（或其他自定义模型文件），删除原 use think\Model; 声明——该路径在TP8中已失效，继续保留会导致模型无法识别Attribute和强类型注解。
第二步：根据模型用途选择继承方式：
若为普通数据模型，改为 use think\Model; 并继承 think\Model；
若为多对多中间表模型（如 user_role），则必须使用 use think\model\Pivot; 并继承 think\model\Pivot。【Pivot类不支持自动时间戳和软删除，误用将导致created_at字段写入失败】
第三步：确认 vendor/topthink/think-orm/src/Model.php 文件真实存在——这是TP8实际加载的Model类，不是TP6遗留的 vendor/topthink/framework/src/Model.php。
立即学习“PHP免费学习笔记（深入）”；
修正field()等方法的参数类型
方法一：将字符串字段列表全部转为数组
把 $this->field('id,name,status')->select() 改为 $this->field(['id','name','status'])->select()。think-orm 3.0的 field() 方法已移除字符串解析逻辑，传入字符串会直接跳过字段限制，【导致敏感字段（如password_hash）被完整返回，构成安全风险】。
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
方法二：启用强类型属性声明（推荐）
在模型类顶部添加 #[\think\attribute\Model]，并在属性前标注类型，例如：public int $id;public string $username;public ?string $email = null;。
这一步让IDE能识别字段类型，也使 toArray() 自动过滤未声明属性。
重写关联查询以兼容预载入机制
① 定义关联方法时，必须显式返回类型提示：
将 public function profile() 改为 public function profile(): \think\model\relation\HasOne；
将 public function posts() 改为 public function posts(): \think\model\relation\HasMany。
② 预载入调用必须使用链式语法，禁止混用数组键名：
正确写法：User::with(['profile', 'posts'])->select()；
错误写法：User::with(['profile' => function ($q) { ... }])->select() —— 闭包预载入在think-orm 3.0中已被废弃，会触发未定义方法错误。
③ 延迟关联需配合游标分页使用：
先执行 $users = User::select();，再遍历中调用 $user->getRelation('profile')，而非 $user->profile 直接访问——后者在无预载入时会触发N+1查询且不走缓存。
启用模型事件与类型自动转换
在模型类中添加以下方法即可激活强类型转换：protected array $type = ['id' => 'integer', 'status' => 'boolean', 'create_time' => 'datetime'];
数据库读取时，status字段将自动转为true/false，create_time转为DateTime对象，无需手动new。
监听模型事件改用Attribute语法：
添加 #[\think\attribute\BeforeInsert] 到方法上，例如：
#[\think\attribute\BeforeInsert]<br>public function setSalt(): void { $this->salt = bin2hex(random_bytes(16)); }旧版
protected static function init() 中绑定事件的方式不再生效。 
