Eloquent初始化必须在onWorkerStart中执行一次并禁用持久连接,模型需显式声明$connection,时间戳与主键须严格匹配表结构,composer安装需加-W参数且重启服务。

Webman中Eloquent初始化必须在onWorkerStart里执行
Worker进程长期驻留,PDO连接不能每次请求都重建,否则MySQL连接数会指数级上涨,很快触发Too many connections错误。Eloquent的Capsule必须只在Worker::onWorkerStart中初始化一次,且需禁用持久连接。
- 在
support/Bootstrap.php或start.php中注册启动回调,不要放在控制器或中间件里 - 调用
Capsule::setAsGlobal()前,务必配置'options' => [PDO::ATTR_PERSISTENT => false] - 避免重复执行
Capsule::bootEloquent(),检查是否被多个Bootstrap类同时触发 - 若用
webman/database包,它自带连接池,此时不应再手动new Capsule,而应走其Db::connection()接口
模型必须显式声明$connection,不能依赖default
Webman多库场景下,config/database.php里的default只影响Db::table()这类无模型查询;Eloquent模型默认仍走Laravel的全局连接逻辑,但Webman没自动绑定这个链路,不设$connection就会报Connection not found或查错库。
- 每个模型类内部必须写
protected $connection = 'mysql_log';,值要和config/database.php中connections下的键完全一致 - 动态切换可用
User::on('mysql_backup')->find(1),但注意这会绕过模型自身的$connection声明 - 若用
webman/database,它的Dbfacade不兼容Eloquent的on()方法,此时只能靠模型属性控制
时间戳和主键字段必须按表结构严格匹配
Webman无Laravel的artisan命令自动推导表结构,Eloquent不会扫描数据库,所有字段行为全靠模型显式声明。一旦$timestamps或$pk与实际表不一致,立刻SQL报错或查不到数据。
- 表里没有
created_at/updated_at?必须加public $timestamps = false; - 主键叫
user_id而不是id?必须写protected $primaryKey = 'user_id'; -
$dateFormat默认是Y-m-d H:i:s,若数据库用int型时间戳,得配protected $dateFormat = 'U'; - 软删除字段名不是
deleted_at?得同步改protected $softDelete = 'is_deleted';并配protected $casts = ['is_deleted' => 'boolean'];
composer require必须带-W参数,否则类找不到
直接composer require illuminate/database大概率装出残缺依赖——illuminate/support版本错位、symfony/polyfill缺失、甚至Illuminate\Database\ConnectionInterface根本不存在。这不是Webman的问题,是Illuminate组件间严格的版本锁机制导致的。
立即学习“PHP免费学习笔记(深入)”;
- 正确命令是:
composer require -W illuminate/database illuminate/events illuminate/pagination - 装完必须
php start.php restart,reload不重载新服务提供者 - 若项目已存在
laravel/framework,确认主版本号一致(如v10项目不能混用v9的illuminate/support) - 报
Class 'Illuminate\Support\ServiceProvider' not found?八成是没加-W,删掉vendor重装
amphp/mysql重写ConnectionInterface,否则高并发下必须接受“每个协程独占连接”这一事实,并在连接池层面做收敛。



















