Workerman 4.0.34 守护进程与日志配置

夏杰大大_5300

夏杰大大_5300

2026-08-08

975人浏览

原创

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

workerman 4.0.34 守护进程与日志配置

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 的输出都会追加写入该文件,不轮转、不压缩。

方法二:重定向标准输出

AutoGLM沉思
AutoGLM沉思

一款AI办公效率工具,主要用于智谱AI推出的具备深度研究和自主执行能力的AI智能体,适合需要提升相关任务效率的用户。

下载

启动时用 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。能看到刚写入的内容,证明日志路径、权限、代码位置全部正确。

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

2026.05.20

166

15

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

2026.05.20

202

12

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

2026.05.20

187

13

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

120

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

100

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

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

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

2026.09.30

60

26

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

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

2026.09.29

80

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

280

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习