PHP Webman编写自定义Process进程_Webman独立子进程运行逻辑【底层】-php教程-PHP中文网

webman自定义process需继承support\process并实现public onworkerstart方法，且必须在config/process.php中注册；主进程挂起失败、工作目录异常、windows未用windows.php启动等均会导致进程启动即退。

php webman编写自定义process进程_webman独立子进程运行逻辑【底层】

Webman 的自定义 Process 不是“后台脚本”，而是由主进程统一 fork、信号托管、生命周期受控的独立子进程；若它启动即退或收不到信号，大概率不是逻辑写错了，而是没过生命周期注册关。

Webman 不会自动识别任意类为进程，只认继承自 support\Process 且实现了 onWorkerStart 方法的类：

类定义必须是 class YourProcess extends support\Process，不能漏掉 support\ 命名空间
onWorkerStart 必须是 public 方法，且接收单个 $worker 参数（类型为 Workerman\Worker）
方法体内不能出现 exit、die 或未捕获的致命错误，否则子进程立即终止
该类需在 config/process.php 中显式注册，例如：['app\process\YourProcess', 'enable' => true]

Webman 主进程靠 pcntl_wait 挂起并监听 SIGCHLD 等信号；一旦挂起失败，主进程退出，所有子进程被系统回收：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

运行 php start.php start -d 后终端无日志停留，立刻返回 shell —— 这是挂起失败最典型表现
执行 php -m | grep pcntl，若无输出，说明 PHP 缺失 pcntl 扩展（Windows 下不可用，必须走 windows.php 启动）
检查是否误调用了 pcntl_signal_dispatch() 或 pcntl_async_signals(true)，它们会干扰 Webman 默认的同步信号处理链
Linux 下可临时加日志验证：在 start.php 末尾 Worker::runAll() 前插入 file_put_contents('/tmp/master_ready', 'ok'); ，确认主进程确实跑到了挂起前

fork 出的子进程继承父进程当前工作目录，但不保证该路径存在或可写；常见于日志、临时文件、配置加载环节：

在 onWorkerStart 开头加一句：file_put_contents('/tmp/process_debug.log', "PID: ".getmypid()."\n", FILE_APPEND);，确认子进程是否真启动了
避免直接 chdir('/xxx')，应先 if (!is_dir('/xxx')) { throw new RuntimeException('Dir not exist'); }
打开日志文件时别裸写 fopen('log.txt', 'a')，要判断返回值：$fp = fopen('log.txt', 'a'); if (!$fp) { error_log("Can't open log: ".error_get_last()['message']); }
Windows 下必须使用 php windows.php start -d 启动，否则 pcntl_fork 不可用，自定义进程根本不会创建

Webman 的 Process 不提供内置事件循环，它只保证调用一次 onWorkerStart；后续逻辑你得自己扛：

不要写 while(true) { sleep(1); } 这种低效轮询，应改用 pcntl_signal + pcntl_signal_dispatch 配合 usleep 实现信号感知的轻量等待
若需长期运行带 I/O 的服务（如监听 UDP、定时拉取数据），推荐用 Workerman\Timer::add 注册回调，它能复用 Webman 主事件循环资源
禁止在 onWorkerStart 中调用 Worker::runAll() 或启动另一个 Workerman 实例，会造成进程嵌套和信号混乱
协程不自动生效：即使项目启用了 webman-coroutine 插件，自定义 Process 子进程默认仍运行在普通同步上下文中，需手动 go() 包裹协程逻辑