如果您在webman项目中需要进行结构清晰、可维护性强的数据库操作，则可能面临原生pdo或sql语句编写繁琐、模型管理缺失等问题。以下是集成thinkorm组件并实现高级数据库操作的具体路径：
一、通过webman/think-orm插件自动集成
该方式适用于Webman ≥ 1.2.1版本，由官方维护，自动完成依赖安装、配置生成与连接保活，大幅降低手动配置出错概率。
1、执行Composer命令安装插件：composer require -W webman/think-orm
2、安装完成后，检查项目根目录下是否自动生成config/thinkorm.php配置文件
3、打开config/thinkorm.php，根据实际数据库环境修改connections.mysql下的hostname、database、username、password等字段
4、确认default键值为'mysql'，确保默认连接指向已配置项
5、启动Webman服务后，ThinkORM即被自动初始化，可在控制器或模型中直接调用think\facade\Db或继承think\Model
二、手动安装topthink/think-orm并配置启动器
当项目使用Webman
1、运行命令安装核心ORM库：composer require topthink/think-orm
2、在config/目录下新建thinkorm.php，内容结构须包含default与connections两级键，其中connections.mysql.type必须明确设为'mysql'
3、在support/bootstrap/目录下创建ThinkOrm.php启动器文件，类需实现Webman\Bootstrap接口
4、在start()静态方法中调用Db::setConfig(config('thinkorm'))完成全局配置注入
5、为防止MySQL空闲连接被服务端强制断开，需在start()中添加定时心跳：使用Workerman\Timer::add(55, function () { Db::connect()->query('select 1'); })
三、创建ThinkORM模型并配置表映射
模型是ORM操作的核心载体，用于封装表结构、关联关系与业务逻辑。正确配置模型属性可避免运行时字段解析错误及主键识别失败。
1、在app/model/目录下新建PHP文件，例如User.php
2、类需继承think\Model，并声明命名空间app\model
3、设置protected $table = 'user'，明确指定对应数据表名
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
4、若主键非id，则必须定义protected $pk = 'uid'
5、如无需自动维护created_at与updated_at字段，需显式设置public $timestamps = false
6、保存后即可在控制器中使用User::where('status', 1)->get()等链式查询
四、使用命令行工具快速生成模型
为提升开发效率，避免手写重复模型结构，可通过webman/console提供的命令自动生成标准ThinkORM模型文件，减少语法错误与配置遗漏风险。
1、先安装控制台支持：composer require webman/console ^1.2.13
2、执行模型生成命令：php webman make:model User
3、若项目同时存在illuminate/database，命令可能默认生成Laravel风格模型；此时需强制指定ThinkORM模板：php webman make:model User tp
4、生成的模型将自动置于app/model/User.php，并预置$table、$pk等基础属性
5、生成后仍需人工核对config/thinkorm.php中数据库连接是否可用，确保模型能正常实例化
五、动态切换数据库连接（多租户/分库场景）
在SaaS架构或多商户系统中，常需根据请求上下文实时切换数据库连接。ThinkORM支持运行时重置配置并重建连接，但需注意连接复用与释放机制，避免连接池膨胀。
1、在中间件process()方法中，依据请求头（如X-Merchant-ID）获取商户标识
2、从配置中心或缓存中加载该商户专属数据库配置数组，确保含type、hostname、database等完整字段
3、调用Db::setConfig($merchantConfig)更新全局配置
4、执行Db::connect('merchant_'.$merchant_id)建立新连接，连接标识须唯一且可追溯
5、关键操作：每次动态连接后，应在请求结束前显式调用Db::close('merchant_'.$merchant_id)释放连接资源，防止MySQL出现大量SLEEP状态连接
