必须引入think-orm才能使用ThinkPHP 6.3+完整模型功能;需下载GitHub对应版本dist包,解压后按vendor/topthink/think-orm/src/结构放置源码,配置PSR-4自动加载并执行composer dump-autoload -o,最后用 hinkModel()验证。

在没有网络连接的服务器或内网开发环境中,无法执行composer require命令安装ThinkPHP模型相关类库,必须通过离线方式将完整模型功能包下载并手动集成到项目中。
确认目标类库与版本匹配
ThinkPHP 6 的核心模型能力由 topthink/think-orm 提供,它已从框架主包中剥离。TP6.3+ 默认不再内置模型类,必须显式引入该包。先确认你当前使用的 ThinkPHP 版本:打开 composer.json 查看 "topthink/framework" 的版本号;若为 6.0.0~6.2.x,模型类仍部分保留在框架内,但功能不全;若为 6.3.0+,【必须引入 think-orm 才能使用完整模型】。
去 GitHub 官方仓库 https://github.com/top-think/think-orm/releases 下载对应版本的 ZIP 包(例如 v3.1.17),注意选择带 dist 后缀的发行版,它已预编译、不含测试和开发文件,体积更小、部署更稳。
解压并放入 vendor 目录结构
将下载的 ZIP 解压,得到 think-orm-3.1.17/ 文件夹。不要直接把整个文件夹丢进 vendor/,必须还原 Composer 的标准目录结构:【进入解压后的文件夹,将 src/ 目录整体复制,粘贴到项目 vendor/topthink/think-orm/src/】。如果 vendor/topthink/think-orm/ 不存在,就手动创建该路径。最终路径应为 vendor/topthink/think-orm/src/Model.php、vendor/topthink/think-orm/src/Db.php 等——这一步错位会导致自动加载失败,且无报错提示,只会在调用时抛出 Class not found。
立即学习“PHP免费学习笔记(深入)”;
同时,在 vendor/topthink/think-orm/ 下新建一个空的 composer.json 文件,内容仅需包含:
{"name": "topthink/think-orm", "autoload": {"psr-4": {"think\": "src/"}}}
注册 PSR-4 自动加载映射
打开项目根目录下的 composer.json,找到 "autoload" 字段,在其 "psr-4" 子项中添加一行:
"think\": "vendor/topthink/think-orm/src/"
保存后,在项目根目录运行 composer dump-autoload -o。这步不可跳过——【不执行则 PHP 根本找不到 Model 类,哪怕文件物理存在】。如果你的环境真无 PHP CLI,就只能手动修改 vendor/autoload_psr4.php,追加 'think\' => array($vendorDir . '/topthink/think-orm/src'),但极易因引号或路径斜杠出错,强烈建议优先设法运行该命令。
验证模型能否正常实例化
在任意控制器方法中写入以下代码:
$model = new hinkModel();
注意开头的反斜杠——【必须加 ,否则 TP6 会尝试在当前命名空间(如 appcontroller)下找类,必然失败】。如果页面空白无报错,说明加载成功;若报错 “Class 'thinkModel' not found”,请立即检查上一步是否漏掉 dump-autoload 或 autoload 映射路径拼写错误(Windows 路径分隔符要统一为正斜杠 /)。
接着测试数据库连接:
$data = hinkModel::where('id', 1)->find();
若返回数据,说明模型层已通;若报错 PDO 驱动未加载,则是数据库扩展问题,与模型引入无关,无需回溯本流程。



















