如何在Hyperf 3.0中自定义进程数量_修改server.settings.worker_num

老敏君_7947

老敏君_7947

2026-05-24

856人浏览

原创

hyperf 3.0 中 worker_num 已被移除,实际并发由 task_worker_num 和协程调度决定;应设 task_worker_num 为 cpu 核数×2~4、开启 task_enable_coroutine=true,并通过 max_conn 和 max_request 控制连接与请求生命周期。

如何在hyperf 3.0中自定义进程数量_修改server.settings.worker_num

Hyperf 3.0 中 worker_num 不再控制进程数

直接改 server.settings.worker_num 在 Hyperf 3.0 里无效——它已被移除。Hyperf 3.0 完全基于 Swoole 5+ 的协程 Server 模型,worker_num 是 Swoole 4 时代 Worker 进程的概念,而新版默认使用 SWOOLE_PROCESS 模式下的 task_worker_num + 协程调度,实际并发由协程数和 CPU 核心数共同决定,不是靠增减“Worker 进程”来提升吞吐。

真正该调的是 server.settings.task_worker_num 和 server.settings.task_enable_coroutine

如果你需要处理大量异步任务(如发短信、写日志、调第三方 API),核心是调整 Task Worker 的数量和行为:

  • task_worker_num:设为 cpu_count * 2 到 cpu_count * 4 较稳妥,过高反而因上下文切换拖慢性能
  • 务必开启 task_enable_coroutine: true,否则 Task Worker 内无法使用协程客户端(如 Co\Http\Client),容易阻塞
  • 若任务本身轻量且纯 CPU 计算,可考虑降为 cpu_count;若含较多 I/O 等待,建议用 cpu_count * 3

配置示例(config/autoload/server.php):

Hyperframes Creative
Hyperframes Creative

HyperFrames视频非动画创意指导,包括设计规范(frame.md/design.md)处理、配色、字体设计、旁白及节奏规划等。

下载
'settings' => [
    'task_worker_num' => 12,
    'task_enable_coroutine' => true,
],

想限制并发连接数?看 server.settings.max_conn 和 max_request

很多人误以为改“进程数”能防爆,其实更关键的是连接与请求生命周期控制:

  • max_conn 控制同时接受的 TCP 连接上限(默认 10000),超限会直接拒绝新连接,适合应对突发流量
  • max_request 控制每个 Worker 协程(注意:不是进程)处理多少请求后自动重启,默认 0(不重启),设为 1000–5000 可缓解内存缓慢泄漏
  • 这两个值比“进程数”对稳定性影响更直接,尤其在长连接或高并发场景下

验证是否生效?别只看 ps aux | grep http

Hyperf 3.0 启动后,ps 看到的进程数 ≈ 1(Master)+ 1(Manager)+ N(Task Worker),但没有传统意义上的 “Worker 进程”。正确验证方式:

  • 启动时加 -vvv 参数:php bin/hyperf.php start -vvv,日志首行会打印实际加载的 task_worker_num
  • 运行中执行 curl http://127.0.0.1:9501/status(需开启 server.status),查看 task_worker_num 和 tasking_num
  • 用 swoole_get_local_ip() 或 Swoole\Server::stats() 在代码里动态读取,避免被配置覆盖逻辑误导

最常被忽略的是:Swoole 5 默认启用 enable_reuse_port,多个 Master 实例可能共用端口,此时 ps 显示的进程数 ≠ 配置值 —— 要确认是否真启用了多实例模式。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

hyperf

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Hyperf协程并发编程实操指南
Hyperf协程并发编程实操指南

本专题深度解析 Hyperf 协程底层机制,解决协程环境下全局变量污染、Context 上下文丢失等核心痛点,提供规范化的 PHP 高并发编程实战代码建议。

2026.05.19

180

15

深入理解Hyperf AOP切面与注解使用
深入理解Hyperf AOP切面与注解使用

详尽介绍 Hyperf 依赖注入容器与 AOP 面向切面编程的使用技巧,包含自定义注解开发流程及注解不生效的排查方案,助力开发者掌握框架核心架构。

2026.05.19

444

16

Hyperf 数据库操作与连接池优化方案
Hyperf 数据库操作与连接池优化方案

针对 Hyperf Eloquent 模型在大数据量下的表现进行深度优化,讲解连接池断线重连、超时设置及事务处理等生产环境常见技术疑难。

2026.05.19

204

15

基于 Hyperf 的微服务架构集成实战
基于 Hyperf 的微服务架构集成实战

本专题涵盖 Hyperf 微服务全栈解决方案,包括服务注册与发现、配置中心集成、JsonRPC 调用以及分布式限流熔断的落地实践。

2026.05.19

236

18

Hyperf 高并发缓存与分布式系统应用
Hyperf 高并发缓存与分布式系统应用

讲解在协程模式下如何高效操作 Redis,实现高性能分布式锁、处理缓存击穿/雪崩问题,并提供基于 Hyperf 的分布式事务处理思路。

2026.05.19

408

15

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

385

15

Hyperf PHP 微服务框架高性能开发实战
Hyperf PHP 微服务框架高性能开发实战

本专题围绕 Hyperf 框架展开,讲解微服务架构设计、协程异步处理、服务注册与发现、RPC 通信及性能优化策略。通过完整项目示例,帮助开发者构建高效、稳定、可扩展的 PHP 分布式服务系统。

2026.06.08

176

23

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

0

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Hyperf官方中文手册(3.1)
Hyperf官方中文手册(3.1)

共0课时 | 0人学习

Swoole系列-从0到1-新手进阶
Swoole系列-从0到1-新手进阶

共29课时 | 2.2万人学习