PHP怎么处理Workerman进程管理_PHP高性能网络框架【指南】

星夢妙者

星夢妙者

2026-04-05

723人浏览

原创

workerman进程关闭终端即退出是因为默认以前台模式运行,需加-d参数或用systemd管理才能守护运行;-d依赖pidfile路径可写且为绝对路径,否则静默失败。

php怎么处理workerman进程管理_php高性能网络框架【指南】

Workerman进程启动后为什么一关闭终端就退出?

因为默认以调试模式运行,php start.php start 启动的是前台进程,终端断开即父进程被 kill。这不是 bug,是设计如此——Workerman 本身不内置 daemonize 逻辑,得靠参数或系统服务接管。

正确做法是加 -d 参数: php start.php start -d。它会触发 Workerman 内部的 fork + setsid 流程,脱离终端控制。注意:必须确保当前用户有权限写 runtime 目录(如 storage/logs 或自定义的 pid_file 路径),否则 -d 会静默失败,进程看似启动实则几秒后退出。

  • start.php 中需明确设置 $worker->pidFile = '/var/run/workerman.pid';,否则默认用 workerman.pid(相对路径),daemon 模式下容易因工作目录变化导致写入失败
  • 不要依赖 nohup php start.php start &,Workerman 自身未处理 SIGHUP,子进程仍可能被中断
  • 检查 ulimit -n,生产环境建议设为 65535;Workerman 启动时若提示 "Too many open files",就是这里卡住

如何安全重启 Worker 进程而不丢连接?

Workerman 的 reload 不是简单 kill + fork,而是平滑 reload:新进程启动并 ready 后,旧进程才开始拒绝新连接、等待已有连接 close。但前提是你的代码没阻塞事件循环。

执行 php start.php reload 前务必确认:

PHP 8.5.5
PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。

下载
  • 所有耗时操作(如数据库查询、curl)必须异步或超时控制,否则 onWorkerStartonMessage 里 sleep(5) 会导致 reload 卡住,旧进程无法退出
  • 使用 Worker::reloadGracefully() 是更可控的方式,可在代码中主动触发,适合配合配置热更新
  • 若用 register_shutdown_function 做清理,要留意 reload 时该函数是否被重复注册(多次 include 同一文件易触发)

systemd 管理 Workerman 时常见权限和路径问题

用 systemd 替代 -d 更可靠,但 Unit 文件里几个字段极易出错:

  • User=www-data 必须与 PHP 进程实际运行用户一致,否则 pidFile 写入失败,status 查不到进程
  • WorkingDirectory 必须设为项目根目录(不是 start.php 所在目录),否则自动加载器找不到类,报 Class not found
  • Restart=always 要搭配 RestartSec=3,避免频繁崩溃触发 systemd 限流;同时在 start.php 中捕获致命错误,防止未 catch 的 Fatal error 导致 worker 异常退出却不打日志
  • 日志别只依赖 StandardOutput=journal,Workerman 内部的 Worker::$logFile 仍要指向可写的绝对路径,否则 onError 回调的日志全丢

为什么 php start.php status 总显示 no worker?

核心原因只有两个:pid 文件读取失败,或 worker 进程已僵死但 pid 文件残留。先手动检查 cat /var/run/workerman.pid 是否存在且内容是数字,再 kill -0 $(cat /var/run/workerman.pid) 看是否返回 0。

常见干扰项:

  • 多个 start.php 实例用了同一 pidFile,后启的覆盖前者的 pid,status 只查最后一个
  • PHP 版本不兼容:Workerman 4.x 要求 PHP >= 7.1,用 PHP 5.6 运行虽能启动,但 pcntl_fork 行为异常,status 无法获取子进程状态
  • SELinux 启用时,pidFile 路径若不在 /var/run/tmp 标准上下文内,会被拦截写入,setenforce 0 临时验证即可定位

真正难排查的是多端口监听时部分 worker 启动失败——比如 TextProtocolWebSocket 共用一个 Worker 实例但端口冲突,只会静默跳过,status 仍显示“running”,实际少了一组进程。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

数码产品性能查询
数码产品性能查询

该软件包括了市面上所有手机CPU,手机跑分情况,电脑CPU,电脑产品信息等等,方便需要大家查阅数码产品最新情况,了解产品特性,能够进行对比选择最具性价比的商品。

下载

相关标签:

php workerman

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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

5408

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

3587

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

1785

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

2250

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

2761

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

1998

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

3028

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

2289

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

10925

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习