php应用日志切割应交由logrotate管理,避免php内轮转导致丢日志、并发冲突和权限问题;需配置copytruncate、create权限,并禁用php-fpm access.log以防句柄残留;高并发或集中收集场景可改用syslog+rsyslog,框架日志也应统一交由logrotate处理。

logrotate 配合 PHP 应用日志切割最稳
PHP 本身不提供日志自动切割能力,硬要在代码里用 fopen + date 判断时间来轮转,容易丢日志、并发写乱、权限错。生产环境统一交给系统级工具 logrotate,它原子、可靠、可配置归档压缩和保留策略。
常见错误现象:自己写 PHP 脚本每天零点重命名日志,结果 Apache 或 Nginx 还在往旧文件句柄写,新日志空着;或者多进程 PHP-FPM 同时检测到该切了,两个进程都 rename,一个失败或覆盖。
- 把 PHP 应用日志路径(如
/var/log/myapp/app.log)写进/etc/logrotate.d/myapp - 必须加
copytruncate:避免重启 Web 服务,logrotate先复制再清空原文件,进程无感知 - 别漏
create 644 www-data www-data:确保切完新文件权限正确,PHP 进程能继续写 - 测试用
logrotate -f /etc/logrotate.d/myapp,观察是否生成app.log.1且原文件变空
PHP-FPM 自带 access.log 切割要关掉
PHP-FPM 的 access.log 默认不支持按大小或时间切,只支持“开/关”和指定路径。如果启用了 access.log 又同时用 logrotate 切它,会因句柄未释放导致日志丢失。
使用场景:你只想记录慢请求或调试信息,不需要每条 HTTP 请求都记;或者你已用 Nginx 的 access_log 统一管理访问日志。
立即学习“PHP免费学习笔记(深入)”;
- 检查
php-fpm.conf或 pool 配置里的access.log行,注释掉或设为空:;access.log = /var/log/php-fpm/access.log - 确认
slowlog是独立开关,不影响access.log,该开就开(配合request_slowlog_timeout) - 切记:PHP-FPM 的
error.log是单文件,必须靠logrotate管,不能依赖 PHP 自身
自定义 error_log 写入 syslog 后由 rsyslog 切割
当 PHP 日志量极大、或需集中收集时,绕过文件直写 syslog 更健壮。PHP 的 error_log 函数和 error_log 配置项都支持 syslog 目标,之后交由 rsyslog 按规则分发+切割。
性能影响:写 syslog 是 socket 发送,比磁盘 I/O 延迟略高,但避免了文件锁和磁盘满风险;兼容性好,所有 PHP 版本都支持。
-
php.ini 中设:
error_log = syslog,或运行时调用error_log("msg", 4) - 在
/etc/rsyslog.d/50-php.conf里加规则,例如:if $programname == 'php' then /var/log/php/error.log - 再为
/var/log/php/error.log单独配一份logrotate,和前面一样用copytruncate - 注意:
syslog不传 PHP 文件名和行号,调试时需开启log_errors_details = On并仍写本地文件作补充
laravel / symfony 等框架的日志不要动底层 rotate 逻辑
这些框架默认用 Monolog,它内置了 RotatingFileHandler,看起来能按天/大小切——但实际是 PHP 进程内判断,和 logrotate 冲突,尤其在 FPM 模式下子进程不共享状态,切割时机不可控。
容易踩的坑:设了 daily,结果发现日志没按时切,或者某天突然多出 .1 .2 .3 一堆文件,因为多个 worker 同时执行 rotate。
- Monolog 的
RotatingFileHandler只适合 CLI 场景(如队列 worker),FPM 下禁用 - 框架配置里把日志 handler 改成
StreamHandler,指向固定文件(如storage/logs/laravel.log) - 然后把这个文件路径交给
logrotate管理,和第一部分做法完全一致 - 别信
max_files参数,它只清理旧文件,不解决并发写和句柄残留问题
真正麻烦的不是怎么切,而是谁在写、写了多久、有没有其他进程还在 hold 句柄。盯住 lsof -p $(pgrep php-fpm) 看日志文件句柄是否被长期占用,比调任何 PHP 参数都管用。











