PHP日志自动切割技巧分享

PHP应用日志切割不应依赖代码内轮转或框架自带机制，而应交由系统级工具logrotate统一管理，以避免并发写入冲突、日志丢失、权限错误及句柄残留等生产环境常见陷阱；正确配置copytruncate、create权限，并禁用PHP-FPM的access.log以防干扰，高并发或集中采集场景可结合syslog+rsyslog提升可靠性，框架如Laravel/Symfony也需关闭内置日志轮转、改用固定文件路径交由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-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 参数都管用。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP日志自动切割技巧分享》文章吧，也可关注golang学习网公众号了解相关技术文章。