Webman使用Eloquent ORM_PHP Webman完美集成Laravel数据库类库【技巧】-php教程-PHP中文网

不能。webman中仅composer require illuminate/database无法直接使用eloquent：必须在onworkerstart初始化capsule并禁用持久连接，每个模型显式声明$connection，严格按表结构配置$timestamps等字段，且安装需加-w参数确保依赖完整。

webman使用eloquent orm_php webman完美集成laravel数据库类库【技巧】

Webman 里直接 composer require illuminate/database 装上 Eloquent 就能用？不能。不改初始化时机、不设连接名、不配时间戳，模型一查就报错，连接数几分钟涨到爆。

onWorkerStart 是唯一安全的初始化位置

Eloquent 的 Capsule 必须在 Worker 进程启动时初始化一次，不能放在控制器、中间件或请求回调里。Worker 长期驻留，PDO 连接复用是刚需；每次请求都 new Capsule 或调 bootEloquent()，MySQL 很快返回 Too many connections。

在 support/Bootstrap.php 或 start.php 中注册 Worker::onWorkerStart 回调
回调内只执行一次 Capsule::setAsGlobal()，且必须前置配置 'options' => [PDO::ATTR_PERSISTENT => false]
检查是否多个 Bootstrap 类同时触发了 bootEloquent()，重复调用会导致连接句柄泄漏
若已引入 webman/database 包，别再手动 new Capsule——它自带连接池，应统一走 Db::connection()

每个模型必须显式声明 `$connection`

Webman 没有 Laravel 的全局连接上下文绑定机制，config/database.php 里的 default 只影响 Db::table() 这类无模型查询。Eloquent 模型默认找不到连接，会报 Connection not found 或静默查错库。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

在模型类顶部写 protected $connection = 'mysql_log';，值必须和 config/database.php 中 connections 下的键完全一致（大小写敏感）
动态切换可用 User::on('mysql_backup')->find(1)，但注意：这会绕过模型自身的 $connection 声明，且每次新建连接实例，高并发慎用
若用 webman/database，它的 Db facade 不兼容 Eloquent 的 on() 方法，此时只能靠模型属性控制连接

时间戳、主键、软删除字段必须按表结构硬对齐

Webman 没有 artisan 命令自动推导表结构，Eloquent 不扫描数据库，所有字段行为全靠模型显式声明。错配不是“不生效”，而是直接 SQL 报错或查不到数据。

表里没有 created_at/updated_at？必须加 public $timestamps = false;
主键叫 user_id 而非 id？必须写 protected $primaryKey = 'user_id';
时间字段是 int 型时间戳？得配 protected $dateFormat = 'U';
软删除字段是 is_deleted？得同步改 protected $softDelete = 'is_deleted'; 并配 protected $casts = ['is_deleted' => 'boolean'];

composer install 必须带 `-W` 参数

直接 composer require illuminate/database 大概率装出残缺依赖：illuminate/support 版本错位、symfony/polyfill 缺失、甚至 Illuminate\Database\Connect 类根本不存在——表面成功，运行时报 Class not found。

正确命令是：composer require -W illuminate/database illuminate/pagination symfony/var-dumper
-W 强制 Composer 解析并安装所有子依赖的兼容版本，避免“装了但跑不起来”
装完必须执行 php start.php restart，reload 不会重新加载新注册的服务提供者
若项目已存在 laravel/framework，注意主版本号匹配（如 v10.x 系列不能混用 v9.x 的 illuminate/support）

最易被忽略的点是：Eloquent 在 Webman 里不是“即插即用”的组件，它本质是 Laravel 生态产物，而 Webman 是协程+多进程模型。连接生命周期、事件注册、模型静态上下文这些底层逻辑一旦没对齐，问题往往表现为偶发性连接失败、事务不生效、或某次部署后模型突然查不到数据——不是代码写错了，是运行模型没对上。