Webman单机QPS极致优化需五步：启用event扩展切换epoll、按物理核数调优worker并绑定CPU、禁用debug与精简中间件、配置数据库连接池并异步查询、静态资源交由Nginx托管且启用HTTP/2直连。
如果您对Webman框架的单机QPS性能表现存疑，或在压测中未达到预期数值，则可能是由于默认配置、运行环境或压测方法未充分释放其异步非阻塞架构潜力。以下是提升Webman单机QPS的极致优化实战步骤：
一、启用Event扩展并切换至epoll模型
Webman底层依赖Workerman的IO多路复用能力，未安装Event扩展时默认使用select/poll，高并发下性能受限；启用Event扩展后可强制使用epoll，显著降低事件监听开销，提升连接处理吞吐量。
1、确认PHP已安装event扩展：php -m | grep event
2、若未安装，执行：pecl install event
立即学习“PHP免费学习笔记（深入）”；
3、在php.ini中添加：extension=event.so
4、重启Webman服务：php start.php restart
5、验证是否生效：查看启动日志中是否出现"Using epoll as event loop"
二、调优Worker进程数与CPU绑定策略
Worker数量过多会导致上下文切换频繁，过少则无法充分利用多核；合理设置worker_num并绑定CPU核心可减少缓存失效与调度抖动，提升L3缓存命中率。
1、编辑config/server.php，将'worker_num'设为物理CPU核心数（非超线程数）
2、在'processes'数组中为每个Worker指定CPU亲和性，例如：['cpu_affinity' => [0]]用于第一个Worker绑定CPU 0
3、确保Linux系统启用CPU隔离：在grub中添加isolcpus=1,2,3（预留核心供Webman独占）
4、启动时强制指定调度策略：php start.php start --daemon --nice=10
5、验证绑定效果：执行taskset -p $(pgrep -f "webman.*start")，确认返回值包含已设CPU编号
三、禁用调试模式并精简中间件栈
debug模式会触发大量日志写入、异常堆栈收集及配置热重载检查；冗余中间件（如未使用的CSRF、Session、跨域）会增加每请求的执行路径长度，直接拖慢响应延迟。
1、修改config/app.php中'debug'值为false
2、清空runtime/log目录下所有日志文件
3、检查config/middleware.php，仅保留App\Middleware\AllowCrossDomain::class（若需CORS）与App\Middleware\JwtAuth::class（若启用鉴权）
4、删除App\Middleware\Session::class与App\Middleware\CsrfToken::class（无状态API场景下必须移除）
5、执行composer dump-autoload --optimize生成优化后的自动加载映射
四、数据库连接池与异步查询压测适配
默认PDO连接每次请求新建连接，导致TCP握手与认证开销剧增；启用连接池并配合异步客户端，可使数据库操作不阻塞事件循环，维持高QPS下的低P99延迟。
1、安装swoole扩展（Webman兼容Swoole协程客户端）：pecl install swoole
2、在config/database.php中启用连接池：'pool' => ['min_connections' => 20, 'max_connections' => 100]
3、改用Swoole\Coroutine\Mysql替代PDO，在控制器中使用go(function () { ... })包裹查询逻辑
4、压测前预热连接池：启动服务后立即发起100次空查询，确保连接池填充至min_connections
5、验证连接复用：观察MySQL的Threads_connected指标稳定在20–100区间，而非随并发数线性增长
五、静态资源分离与HTTP/2直连优化
Webman内置HTTP服务器不适合托管大量静态文件；混合动静态请求会挤占Worker处理能力；启用HTTP/2可复用TCP连接、头部压缩，降低首字节时间（TTFB）。
1、将public目录下所有CSS/JS/IMG移至Nginx独立站点，配置location /static/指向该路径
2、在Nginx配置中启用HTTP/2：listen 443 ssl http2;并配置有效SSL证书
3、修改Webman路由，移除所有Route::get('/favicon.ico', ...)等静态资源路由
4、在Nginx中反向代理Webman后端：proxy_pass http://127.0.0.1:8787;，并添加proxy_http_version 2;
5、压测时使用HTTPS URL（如https://test.example.com/api/json），确保HTTP/2协商成功，Chrome开发者工具Network面板显示h2协议标识
