Workerman日志通过Worker::$logFile配置，建议明确指定路径并确保写入权限，避免默认/tmp目录；应用日志应使用error_log或Monolog等专业库分离记录；需通过logrotate实现日志轮转，防止文件过大，生产环境推荐结合Monolog与集中式日志系统提升管理效率。
Workerman记录日志，主要是通过
Worker::$logFile这个配置项来指定日志文件的路径。如果没有明确配置，它通常会尝试将Workerman自身的运行日志写入到
/tmp/workerman.log，或者在某些系统环境下，可能会是启动脚本所在的目录。至于应用层面的日志，我们则需要自己通过PHP的
error_log函数或者更专业的日志库来管理。
解决方案
在我看来，Workerman的日志机制其实挺直接的，但又留给了开发者很大的灵活性。最核心的就是
Worker::$logFile这个静态属性。当你启动Workerman应用时，如果设置了这个属性，Workerman内部的一些错误、警告信息，以及你通过
var_dump等方式输出到标准输出的内容（如果未重定向
stdout），都会被导向到这个文件。
举个例子，如果我想让Workerman的运行日志都统一存放在项目的
logs目录下，我可以这样配置：
use Workerman\Worker;
// ... 其他Worker配置
// 指定Workerman的日志文件路径
Worker::$logFile = __DIR__ . '/logs/workerman.log';
// 确保日志目录存在且可写
if (!is_dir(__DIR__ . '/logs')) {
mkdir(__DIR__ . '/logs', 0777, true);
}
// ... 你的业务逻辑Worker
// 启动所有Worker
Worker::runAll();这里需要特别注意一点，就是
Worker::$logFile这个文件路径必须是Workerman进程有写入权限的。如果权限不足，你可能会发现日志文件没生成，或者Workerman在启动时就报错了。我个人建议，在生产环境，最好给
logs目录设置一个合适的权限，比如让运行Workerman的用户拥有读写权限，而不是简单粗暴地
0777。
除了Workerman自身的运行日志，我们应用代码里的业务日志也同样重要。这时候，PHP原生的
error_log()函数就能派上用场，它可以把消息写入到Web服务器的错误日志、或者一个指定的日志文件。但对于更复杂的应用，我更倾向于使用专门的日志库，比如Monolog，它提供了更丰富的日志级别、处理器和格式化选项。
Workerman的日志配置有哪些常见误区？
在实际开发中，关于Workerman的日志配置，我见过不少开发者会遇到一些小坑。最常见的就是日志文件权限问题。很多时候，大家可能在开发环境一切正常，但部署到生产服务器上，由于Workerman进程运行的用户权限较低，导致无法写入指定的日志文件，结果就是日志缺失，排查问题时一脸懵。解决办法很简单，确保
Worker::$logFile指向的目录对运行Workerman的用户是可写的。
另一个常见的误区是不设置Worker::$logFile
，或者设置了一个不明确的路径。Workerman在默认情况下会尝试写入
/tmp/workerman.log。
/tmp目录虽然通常可写，但它是个公共且可能被系统清理的目录，对于长期运行的服务来说，把重要日志放在这里显然不合适。而且，如果多个Workerman应用都默认写入
/tmp/workerman.log，日志内容就会混淆在一起，非常不利于排查。所以，我强烈建议总是明确指定
Worker::$logFile。
还有，很多人会混淆Workerman的内部日志和业务日志。
Worker::$logFile主要记录的是Workerman框架层面的事件，比如Worker启动、停止、异常退出等。而你应用内部的业务逻辑，比如用户请求、数据处理错误等，需要你自己通过
error_log或者日志库来记录。把所有日志都混在一起，会使得日志文件变得庞大且难以阅读。
最后，日志轮转也是一个经常被忽视的问题。如果不做日志轮转，长时间运行的服务会产生巨大的日志文件，不仅占用磁盘空间，还会影响日志查看工具的性能，甚至可能导致磁盘空间耗尽，服务崩溃。
如何在Workerman应用中实现更精细化的日志管理？
要实现更精细化的日志管理，我个人经验是，引入一个专业的PHP日志库是必由之路。Monolog无疑是其中最流行、功能最强大的一个。它能让你根据不同的日志级别（DEBUG, INFO, WARNING, ERROR等）将日志发送到不同的目的地，比如文件、数据库、甚至远程日志服务。
漂亮的企业网站。NET2.0出来了， 本次升级修改如下： 1、优化了3层结构。 2、优化了后台管理代码，增强了安全性能。 3、增加了系统名称及关键字管理。 4、增加了系统错误日志记录，自动生成Systemlog.log日志文件。 备注：本系统采用ASP.NET 2.O+ACCESS开发，请调试的朋友安装.NET2.0运行环境！ 网站内容 网站栏目包括 首页|企业简介|新闻中心|产品展示|公司展示|
集成Monolog到Workerman应用中并不复杂。你可以为每个Worker实例创建一个Monolog Logger对象，或者在全局范围内共享一个。
use Workerman\Worker;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Formatter\LineFormatter;
// 假设我们有一个全局的Logger实例
$logger = new Logger('my_app');
// 创建一个文件处理器，将日志写入到应用的logs目录
$fileHandler = new StreamHandler(__DIR__ . '/logs/app.log', Logger::DEBUG);
// 定义日志格式
$formatter = new LineFormatter(
"[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n",
"Y-m-d H:i:s",
true,
true
);
$fileHandler->setFormatter($formatter);
$logger->pushHandler($fileHandler);
// 也可以添加一个处理器，将错误日志发送到单独的文件
$errorHandler = new StreamHandler(__DIR__ . '/logs/error.log', Logger::ERROR);
$errorHandler->setFormatter($formatter);
$logger->pushHandler($errorHandler);
$worker = new Worker('tcp://0.0.0.0:8000');
$worker->onMessage = function($connection, $data) use ($logger) {
// 假设这里有一些业务逻辑
$logger->info('Received data: ' . $data, ['client_ip' => $connection->getRemoteIp()]);
if (rand(0, 10) < 2) { // 模拟一个错误
$logger->error('Something went wrong!', ['data' => $data]);
$connection->send('Error processing your request.');
return;
}
$connection->send('Hello ' . $data);
};
// Workerman自身的日志配置依然可以保留
Worker::$logFile = __DIR__ . '/logs/workerman.log';
Worker::runAll();通过Monolog，你可以轻松地记录不同级别的日志，并且可以根据需要添加各种处理器，比如
SyslogHandler将日志发送到系统日志，或者
SocketHandler发送到远程日志服务器（如ELK Stack）。这样，你的日志管理就变得非常灵活和强大了。
Workerman日志文件过大怎么办？日志轮转策略探讨
日志文件过大，是任何长期运行服务都无法避免的问题。对于Workerman生成的日志文件，无论是
Worker::$logFile还是你应用通过Monolog等库生成的日志，都需要进行合理的轮转。否则，轻则占用大量磁盘空间，重则可能导致磁盘满载，服务异常。
在Linux系统上，最常用且高效的解决方案是使用
logrotate工具。
logrotate是一个系统级的日志管理工具，它可以自动压缩、删除和邮件发送旧的日志文件。
你可以为Workerman的日志文件创建一个
logrotate配置文件，通常放在
/etc/logrotate.d/目录下，例如
workerman_app：
/path/to/your/project/logs/*.log {
daily # 每天轮转一次
rotate 7 # 保留7个旧的日志文件
compress # 压缩旧的日志文件
delaycompress # 延迟压缩，直到下一个轮转周期
missingok # 如果日志文件不存在，不报错
notifempty # 如果日志文件为空，不轮转
create 0644 workerman_user workerman_group # 轮转后创建新文件，并指定所有者和组
postrotate # 轮转后执行的命令
# Workerman进程可能需要重新打开日志文件句柄才能写入新的文件
# 这通常通过向Workerman主进程发送USR1信号来实现，但Workerman本身没有直接支持这种信号处理来重新打开日志文件。
# 最稳妥的方式是重启Workerman服务，但这会中断服务。
# 如果你的日志是通过Monolog写入的，并且其StreamHandler没有特殊处理，可能需要重启应用。
# 对于Worker::$logFile，Workerman在每次写入时会尝试打开文件，所以一般不需要特别处理。
# 但如果遇到问题，可以考虑在postrotate中重启Workerman服务，或者让Workerman定期关闭并重新打开日志文件。
# 这里为了避免服务中断，我们假设Workerman能够自行处理。
# 如果你使用supervisor管理Workerman，可以尝试：
# supervisorctl restart your_workerman_app
endscript
}这里需要注意的是
postrotate部分。对于
Worker::$logFile，Workerman每次写入时通常会重新打开文件句柄，所以即使文件被
logrotate重命名了，它也能继续写入新的文件。但如果你在应用中使用了Monolog的
StreamHandler，并且它长时间持有文件句柄，那么在
logrotate将旧文件移走后，Monolog可能仍然尝试写入已被移走的旧文件。在这种情况下，你需要一种机制让Monolog重新打开新的日志文件。这通常意味着你可能需要重启Workerman服务，或者在Monolog配置中寻找是否有
close_on_rotation之类的选项（Monolog的
RotatingFileHandler就是为此设计的）。
除了
logrotate，你也可以编写一个简单的shell脚本，结合
cron定时任务来手动实现日志轮转。但这通常不如
logrotate强大和灵活。
另外，如果你的应用日志量非常大，并且对日志的实时性、可搜索性有高要求，那么将日志发送到集中式日志系统（如ELK Stack、Loki、Splunk等）会是更好的选择。这样日志就不会存储在本地磁盘，从而彻底解决了本地日志文件过大的问题。Monolog的各种Handler可以很好地支持这种集成。
