Laravel项目怎么集成Workerman？共享模型与数据库配置-php教程-PHP中文网

laravel模型在workerman中无法直接使用，因为workerman是纯cli常驻进程，不触发laravel http生命周期，导致服务容器未引导、门面未绑定、数据库连接未初始化；必须在onworkerstart中手动加载app.php并bootstrap应用，才能安全调用模型和db。

laravel项目怎么集成workerman？共享模型与数据库配置

能共享 Laravel 的模型和数据库配置，但必须手动触发 Laravel 应用启动流程，不能直接在 Worker 实例中调用 DB::table() 或 User::find() —— 否则会报 Target class [db] does not exist 或连接未初始化。

为什么 Laravel 模型在 Workerman 里直接用不了

Workerman 是纯 CLI 进程，不走 Laravel 的 HTTP 生命周期（比如 Kernel::handle()），app 容器没被完整引导，服务提供者没注册，DB、Eloquent、Config 等门面都不可用。即使 use Illuminate\Support\Facades\DB; 成功，调用时也会因底层连接未初始化而失败。

常见错误现象：

Class 'DB' not found（没引入门面或自动加载失效）
Target class [db] does not exist（门面存在，但服务容器里没绑定 db）
PDOException: SQLSTATE[HY000] [2002] Connection refused（配置读取失败，连到了默认 localhost:3306，而非 .env 里的真实配置）

如何安全复用 Laravel 的数据库与模型

核心思路：在 onWorkerStart 回调中，手动加载 Laravel 引导文件，生成并绑定完整的 $app 实例到全局或闭包作用域。

实操建议：

在命令类的 handle() 中，不要直接 new Worker 后立刻 runAll；先确保 bootstrap/app.php 被 require，并用它创建一个可用的 $app
把 $app 存进 Worker::$app 静态属性，或通过 use ($app) 传入回调，避免每次 onMessage 都重复加载
务必在 onWorkerStart 里做初始化，而不是 onConnect 或 onMessage —— 后者每请求一次就执行一次，开销大且易出错
数据库连接默认是短生命周期的，Workerman 长驻进程下需手动重连或启用持久连接；推荐在 onWorkerStart 初始化连接，在 onWorkerStop 关闭

简短示例（关键片段）：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

$worker = new Worker('websocket://0.0.0.0:2346');
$worker->onWorkerStart = function ($worker) {
    // 手动启动 Laravel 应用
    $app = require __DIR__.'/../../bootstrap/app.php';
    $app->make(Illuminate\Contracts\Console\Kernel::class)->bootstrap();

    // 将 app 绑定到 worker 实例，供后续回调使用
    $worker->app = $app;
};

$worker->onMessage = function ($connection, $data) use ($worker) {
    // 此时可安全使用模型
    $user = $worker->app->make('App\Models\User')::find(1);
    $connection->send($user ? $user->name : 'not found');
};

配置项与环境变量怎么生效

Laravel 的 .env 在 Workerman 进程中不会自动加载，因为 Dotenv 只在 bootstrap/app.php 开头被调用一次，而该文件通常只在 HTTP 请求入口（public/index.php）中加载。

所以你必须确保：

在 onWorkerStart 之前，Dotenv::createImmutable(base_path()) 已执行，或直接 require bootstrap/app.php（它内部已处理）
不要依赖 $_ENV 或 getenv() 直接读取，应统一走 config('database.default') 或 Config::get()
如果用了 php artisan config:cache，记得部署后重新生成缓存，否则 Workerman 读不到最新配置