Laravel Workerman

使用 Workerman 加速 Laravel/Lumen 应用，常驻内存模式提升 5-20 倍性能。

版本要求

| 依赖 | 版本 | |------|----------------| | PHP | ^8.1 | | Laravel | ^10.0 | ^11.0 | | Lumen | ^10.0 | ^11.0 | | Workerman | ^5.0 |

特性

• 🚀 高性能: 常驻内存，避免重复加载框架
• 🔄 自动重启: 达到最大请求数自动重启 Worker，防止内存泄漏
• 📁 静态文件: 内置静态文件服务，无需 Nginx
• 🛠 易于集成: 一键安装，开箱即用
• 📊 性能统计: 自动统计请求数、响应时间、内存使用
• 🔀 双框架支持: 同时兼容 Laravel 和 Lumen 框架

安装

composer require "qiuapeng921/laravel-workerman:2.x-dev"

配置

Laravel

发布配置文件和启动脚本：

php artisan vendor:publish --tag=workerman

这将发布：

• config/workerman.php - 配置文件
• workerman.php - 启动脚本

Lumen

由于 Lumen 不支持 vendor:publish，需要手动复制文件：

# 复制配置文件
cp vendor/qiuapeng921/laravel-workerman/config/workerman.php config/workerman.php

# 复制启动脚本
cp vendor/qiuapeng921/laravel-workerman/workerman.php workerman.php

然后在 bootstrap/app.php 中注册服务提供者：

$app->register(Qiuapeng\LaravelWorkerman\WorkermanServiceProvider::class);

使用

启动服务

# 前台启动
php workerman.php start

# 后台启动（守护进程，仅 Linux/Mac）
php workerman.php start -d

# 自定义参数
php workerman.php --port=9000 --workers=8 --max=5000 --debug start

命令行参数

| 参数 | 短选项 | 说明 | 默认值 | |------|--------|------|--------| | --port | -p | 监听端口 | 8080 | | --workers | -w | Worker 进程数 | 4 | | --max | -m | 单个 Worker 最大请求数 | 10000 | | --debug | - | 启用调试模式 | false |

停止服务

# Linux/Mac
php workerman.php stop

# Windows
Ctrl+C

其他命令（仅 Linux/Mac）

php workerman.php restart   # 重启
php workerman.php reload    # 平滑重载
php workerman.php status    # 查看状态

配置选项

编辑 config/workerman.php：

return [
    // 监听地址
    'host'         => env('WORKERMAN_HOST', '0.0.0.0'),

    // 监听端口
    'port'         => env('WORKERMAN_PORT', 8080),

    // Worker 进程数（Windows 只能为 1）
    'workers'      => env('WORKERMAN_WORKERS', 4),

    // 最大请求数（达到后 Worker 自动重启，防止内存泄漏）
    'max_requests' => env('WORKERMAN_MAX_REQUESTS', 10000),

    // 调试模式
    'debug'        => env('WORKERMAN_DEBUG', false),

    // 进程名称
    'name'         => env('WORKERMAN_NAME', 'laravel-workerman'),

    // 静态文件配置
    'static'       => [
        'enable' => true,
        'path'   => base_path('public'),
    ],

    // 日志配置
    'log'          => [
        'file' => storage_path('logs/workerman.log'),
    ],
];

环境变量

WORKERMAN_HOST=0.0.0.0
WORKERMAN_PORT=8080
WORKERMAN_WORKERS=4
WORKERMAN_MAX_REQUESTS=10000
WORKERMAN_DEBUG=false
WORKERMAN_NAME=laravel-workerman

项目结构

src/
├── Bootstrap.php              # 引导类 - 环境检查、参数解析
├── Config/
│   └── WorkermanConfig.php    # 配置管理器 - 多级配置覆盖
├── Contracts/
│   └── FrameworkAdapter.php   # 框架适配器接口
├── Adapters/
│   ├── AdapterFactory.php     # 适配器工厂 - 自动检测框架类型
│   ├── LaravelAdapter.php     # Laravel 适配器
│   └── LumenAdapter.php       # Lumen 适配器
├── WorkermanServer.php        # 服务器类 - Worker 生命周期管理
├── AppManager.php             # 应用管理器 - 统一处理 Laravel/Lumen
├── StaticFileHandler.php      # 静态文件处理器
├── Logger.php                 # 日志工具
└── WorkermanServiceProvider.php

架构说明

适配器模式

项目使用适配器模式来兼容 Laravel 和 Lumen 两个框架：

┌─────────────────┐
│   AppManager    │
└────────┬────────┘
         │
    ┌────▼────┐
    │ Factory │ ──── 自动检测框架类型
    └────┬────┘
         │
    ┌────┴────┐
    │         │
┌───▼───┐ ┌───▼───┐
│Laravel│ │ Lumen │
│Adapter│ │Adapter│
└───────┘ └───────┘

核心差异处理：

| 特性 | Laravel | Lumen | |------|---------|-------| | HTTP Kernel | ✅ 有 | ❌ 无 | | Facade | 默认启用 | 需手动启用 | | config_path() | ✅ 有 | ❌ 无 | | vendor:publish | ✅ 有 | ❌ 无 |

注意事项

1. Session 和 Cache

• 建议使用 Redis 驱动，避免文件锁竞争

2. 代码更新

• 修改代码后需要执行 php workerman.php reload 或重启服务

3. 静态变量

• 避免在静态变量中存储请求相关数据，可能导致数据污染

4. 单例模式

• 注意 Laravel/Lumen 容器中的单例在多次请求间共享

5. Windows 限制

• Windows 下只能使用单进程模式
• 不支持 stop、restart、reload、status 命令

6. Lumen 特殊配置

在 Lumen 中使用时，确保在 bootstrap/app.php 中启用 Facade（如果需要）：

$app->withFacades();

本地开发调试

在 Laravel/Lumen 项目中使用本地开发版本：

{
    "repositories": [
        {
            "type": "path",
            "url": "/path/to/laravel-workerman",
            "options": { "symlink": true }
        }
    ],
    "require": {
        "qiuapeng/workerman-laravel": "@dev"
    }
}

性能对比

| 模式 | QPS | 响应时间 | |------|-----|----------| | PHP-FPM | 500 | 20ms | | Workerman (Laravel) | 5000+ | 2ms | | Workerman (Lumen) | 8000+ | 1.5ms |

测试环境：4 核 CPU，8GB 内存，简单 API 请求

Changelog

v1.1.0

• ✨ 新增 Lumen 框架支持
• ✨ 使用适配器模式重构代码
• 📦 新增 AppManager 统一管理 Laravel/Lumen 应用
• 📝 更新文档

v1.0.x

• 🚀 初始版本
• ✅ Laravel 支持

License

MIT