workerman 4.0.34 生产环境必须以守护进程模式(php start.php start -d)运行并配置落盘日志;需设置绝对路径的 pidfile 和 logfile,确保 php 进程有对应目录写权限,并验证进程、pid 文件及日志写入是否生效。

Workerman 4.0.34 在生产环境必须以守护进程模式运行,同时日志必须落盘可查,否则服务一关终端日志就消失,出问题时连发生了什么都看不到。
启动守护进程模式
执行 php start.php start -d 启动,【-d 参数不可省略】,它会触发 fork + setsid,让 Workerman 脱离终端控制并转入后台。不加 -d 就是前台模式,只适合开发调试。
启动前必须确保 $worker->pidFile 设置为绝对路径,例如:$worker->pidFile = '/var/run/workerman.pid';。相对路径在 daemon 模式下因工作目录变化极易写入失败,导致后续 stop/restart/status 命令全部失效。
检查 runtime 目录(如 /var/run/)是否对 PHP 进程用户(如 www-data)有写权限。权限不足时 -d 会静默退出,进程看似启动成功,实则几秒后自动终止。
配置日志文件输出
方法一:直接设置 Worker::$logFile
在 start.php 最开头、Worker 启动前添加:
Worker::$logFile = '/var/log/workerman/app.log';
这行代码必须用绝对路径,且 PHP 进程对该路径有写权限。Worker::log()、echo、var_dump 的输出都会追加写入该文件,不轮转、不压缩。
方法二:重定向标准输出
启动时用 shell 重定向:php start.php start -d >> /var/log/workerman/stdout.log 2>&1。这种方式能捕获所有未被 Worker::$logFile 覆盖的输出(如某些扩展错误),但需手动管理文件大小,避免撑爆磁盘。
注意:PHP 错误日志(如 parse error、fatal error)走的是 php.ini 的 error_log 配置,与 Worker::$logFile 无关,务必单独确认该配置指向可写文件。
验证守护进程与日志是否生效
第一步:检查进程是否存在
运行 ps aux | grep workerman,看到多个 php start.php 进程且无 pts/ 终端标识,说明已脱离终端。
第二步:确认 pid 文件写入成功
执行 ls -l /var/run/workerman.pid,文件存在且非空,内容为一串数字(主进程 PID)。若文件为空或不存在,说明 daemonize 失败。
第三步:触发一条日志并查看文件
在业务逻辑中调用 Worker::log('test log');,然后执行 tail -n 1 /var/log/workerman/app.log。能看到刚写入的内容,证明日志路径、权限、代码位置全部正确。











