webman需按需引入illuminate组件，安装必须加-w参数并restart生效；配置须适配连接池（如redis需显式定义pool），事件监听器需手动注册，否则不触发。
Webman 本身不绑定任何 ORM 或缓存组件，它只提供路由、中间件、Session 等核心能力。所以你完全可以按需引入 illuminate/database、illuminate/redis、illuminate/events 这类 Laravel 组件，而且用法几乎和 Laravel 完全一致——前提是配置对、启动方式对、协程环境判断清楚。
安装 illuminate/redis 或 illuminate/database 时必须加 -W 参数
Webman v2 的依赖策略是“最小内核 + 最大复用”，但部分 Illuminate 包之间存在版本冲突（比如 illuminate/support 在不同主版本间不兼容）。不加 -W（即 --with-all-dependencies）会导致 Composer 自动降级或跳过某些必需依赖，最终出现运行时报错：Class Illuminate\Support\ServiceProvider not found 或 Call to undefined method Illuminate\Redis\RedisManager::connection()。
正确命令是：
composer require -W illuminate/redis illuminate/events
composer require -W illuminate/database illuminate/pagination symfony/var-dumper
-
-W强制 Composer 解析并安装所有子依赖的兼容版本，避免“表面装成功、实际缺类” - 装完必须执行
php start.php restart，reload不会重新加载新注册的服务提供者 - 如果项目已存在
laravel/framework，要特别注意主版本号是否与你要装的illuminate/*匹配（如 v10.x 系列不能混用 v9.x 的illuminate/support）
config/redis.php 和 config/database.php 的配置结构不能照抄 Laravel
Webman 的 webman/redis 和 webman/database 是在 Illuminate 基础上加了连接池支持，因此配置项多了 pool 子数组，且默认行为也不同。直接复制 Laravel 的 config/database.php 会导致 Redis 连接池不生效、数据库查不出数据、甚至 DB::connection() 返回 null。
关键差异点：
- Redis 配置中必须显式定义
pool，哪怕只设'max_connections' => 1；否则走的是原始illuminate/redis同步逻辑，无法利用协程并发 - Database 配置里
'driver'支持mysql、pgsql、sqlite，但不支持sqlsrv（缺少 Windows 下的 PDO_SQLSRV 协程适配） -
'prefix'和'charset'必须是字符串，不能为null，否则连接初始化失败 - 如果你用的是
webman/database（推荐），它的连接池配置在config/database.php的'connections.mysql.pool'下，不是顶层pool
协程环境下 DB::select() 和 Redis::get() 可能卡住或超时
这不是代码写错了，而是连接池参数没调好。Webman 默认每个 Worker 进程维护独立连接池，当开启协程（worker->count > 1 且启用 swoole 协程）后，多个协程并发调用 DB::select() 时，若 max_connections 设置过小，就会排队等连接；超过 wait_timeout 就抛出 ConnectionPoolTimeoutException。
典型表现：
- 接口响应时间忽高忽低（比如 20ms → 3200ms），日志里出现
Wait connection timeout after 3 seconds - 压测时 QPS 上不去，CPU 利用率低，但 Redis/MySQL 服务端负载不高
-
Redis::pipeline()执行缓慢，甚至阻塞整个协程调度
建议值（以 Redis 为例）：
'pool' => [ 'max_connections' => 20, 'min_connections' => 2, 'wait_timeout' => 3, 'idle_timeout' => 60, 'heartbeat_interval' => 30 ]
注意：max_connections 不是越大越好——超过 Redis 服务端 maxclients 限制会直接拒绝连接；也要考虑 PHP 进程内存占用（每个连接约占用 2–5MB）。
事件监听器（EventServiceProvider）在 Webman 中需要手动注册
Laravel 的 EventServiceProvider 依赖 app()->booted() 生命周期自动注册监听器，但 Webman 没有这个机制。如果你装了 illuminate/events 并写了监听器，不手动触发，event(new UserRegistered) 就完全静默，没有任何报错，也不执行回调。
解决方法是在 start.php 或自定义服务提供者中显式注册：
// app/Providers/EventServiceProvider.php
public function boot()
{
$this->app['events']->listen(UserRegistered::class, SendWelcomeEmail::class);
$this->app['events']->listen(OrderPaid::class, [InventoryService::class, 'decrease']);
}
然后在 start.php 开头处调用：
app()->register(App\Providers\EventServiceProvider::class);
漏掉这一步，事件系统就形同虚设——这是最常被忽略的一环，尤其在从 Laravel 迁移代码时。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
