workerman 5.2.3 默认日志不落盘,需分别配置:1. 设置 worker::$logfile 指定 worker::log() 输出路径;2. 修改 cli 模式 php.ini 启用 log_errors 并指定 error_log;3. 可用 shell 重定向 stdout/stderr。

Workerman 5.2.3 默认不写文件日志,所有 Worker::log()、echo、未捕获异常等输出都直接打到终端(stdout/stderr)。一旦用 php start.php start -d 守护进程模式运行,终端关闭后日志就丢失——不是没产生,是根本没落盘。要持久记录运行日志,关键在两件事:明确日志类型、分别配置落盘路径。
设置 Worker::log() 的输出文件
这是最常用、最直接的运行日志方式,只影响你主动调用 Worker::log('xxx') 的内容。
- 必须在
start.php最开头、Worker::runAll()之前设置,且使用绝对路径 - 示例代码:
use Workerman\Worker; Worker::$logFile = '/var/log/workerman/app.log';
- 确保目录存在且 PHP 进程有写权限:
sudo mkdir -p /var/log/workerman && sudo chown www-data:www-data /var/log/workerman(用户按实际运行身份调整) - 注意:该设置对
echo、var_dump或未捕获的 PHP 错误无效
捕获 PHP 运行时错误(Warning/Fatal/Exception)
这类错误默认走 PHP 自身的错误处理机制,和 Worker::$logFile 无关,需单独配置 PHP。
- 编辑 CLI 模式下的
php.ini(用php --ini确认路径),启用并指定错误日志文件: log_errors = Onerror_log = /var/log/php_workerman_errors.log- 重启或重新启动 Workerman 生效(守护进程下尤其要注意 CLI 的 php.ini 是否被正确加载)
- 可配合
Worker::onError回调做补充记录(非替代):
$worker->onError = function($connection, $code, $msg, $file, $line) {
Worker::log("PHP Error {$code}: {$msg} in {$file}:{$line}");
};
重定向标准输出/错误(适合调试或简单场景)
如果不想改代码或 PHP 配置,可用 Shell 重定向把所有终端输出存为文件:
- 启动时加
> /var/log/workerman/stdout.log 2>&1: nohup php start.php start -d > /var/log/workerman/stdout.log 2>&1 &- 优点:简单、覆盖全(含 echo、var_dump、系统级报错)
- 缺点:格式混乱、不易区分来源;长期运行易撑爆磁盘,需配合
logrotate或定时清理
日志文件管理建议
Workerman 原生不支持轮转、压缩或按大小/时间切割,单文件会持续追加:
- 生产环境务必配置
logrotate,例如创建/etc/logrotate.d/workerman:
/var/log/workerman/*.log {
daily
missingok
rotate 30
compress
delaycompress
notifempty
create 0644 www-data www-data
}
- 如需结构化日志(便于后续分析),建议在
Worker::log()中输出 JSON 格式字符串 - 避免在高频逻辑中频繁调用
Worker::log(),防止 I/O 阻塞;高并发场景可考虑异步写入或独立日志 Worker











