Zend Framework 2/3 的日志文件默认存于 data/logs/ 或 var/log/,具体由 logger.global.php 中 base_path 决定;需显式配置 RotatingFileWriter 并设 max_files、max_size 等参数实现轮转,ZF2 用 Zend\Log\Writer\RotatingFileWriter,ZF3/Laminas 改用 Laminas\Log\Writer\RotatingFileWriter。

Zend Framework 2/3 的日志文件默认存哪
Zend Framework(Zf2/Zf3)本身不内置日志轮转或自动清理机制,logs/ 目录位置取决于你配置的 Writer。常见路径是:data/logs/ 或 var/log/(取决于项目结构和 config/autoload/logger.global.php 中的 base_path 设置)。它不会写到系统 /var/log/,也不会进 zend_server 日志目录——那是 Zend Server 产品自己的日志,和 ZF 框架无关。
用 RotatingFileWriter 替代普通 Stream 写入器
手动删日志不是长久之计,应该让框架自己控制文件数量和大小。ZF2/3 的 Zend\Log\Writer\RotatingFileWriter 支持按大小或天数滚动,但需显式启用:
- 确保已安装
zendframework/zend-log(Zf3)或zendframework/zend-logv2.x(Zf2) - 在日志配置中把
writer从Stream换成RotatingFileWriter - 关键参数必须设全:
max_files(保留最多几个文件)、max_size(单文件上限,如10485760表示 10MB)、rotation(可选'size'或'date')
示例配置片段(logger.global.php):
'writers' => [
[
'name' => 'RotatingFileWriter',
'options' => [
'stream' => 'data/logs/app.log',
'max_files' => 5,
'max_size' => 10485760,
'rotation' => 'size',
],
],
],手动清理脚本要避开正在写入的文件
如果必须定时清理旧日志(比如遗留项目还没改配置),别直接 rm -rf data/logs/*。PHP 进程可能正打开某个 .log 文件句柄,删了会导致日志写入失败、报错 failed to write to stream 或静默丢日志。
立即学习“PHP免费学习笔记(深入)”;
- 用
find配合-mmin或-mtime更安全,例如只删 7 天前的归档文件:find data/logs/ -name "*.log.*" -mtime +7 -delete - 跳过当前活跃日志:
find data/logs/ -name "app.log" -prune -o -name "*.log.*" -mtime +7 -delete - 避免在高流量时段执行;建议加到
cron并重定向输出:0 2 * * * /path/to/clean-logs.sh >/dev/null 2>&1
注意 ZF2 和 ZF3 的类名与依赖差异
ZF2 的 RotatingFileWriter 在 Zend\Log\Writer\RotatingFileWriter,而 ZF3 移到了 Laminas\Log\Writer\RotatingFileWriter(因品牌切换)。如果你升级了但没更新 use 语句或配置中的类名,会报 Class not found。
- ZF2 项目:确认
composer.json含"zendframework/zend-log": "^2.12" - ZF3/Laminas 项目:应使用
"laminas/laminas-log": "^2.15",且配置里写Laminas\Log\Writer\RotatingFileWriter - 两者都不支持
gzip归档压缩,老日志得靠外部脚本处理
真正麻烦的是混合环境:既有 ZF2 的旧模块,又引入了 Laminas 组件。这时候 autoloader 可能冲突,RotatingFileWriter 加载失败却只报空警告——得盯紧 error_log 和 php -m | grep log 输出。











