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
