PHP日志自动清理无内置阈值,需用外部机制:Linux常用cron+find按天数(如7天)清理,框架如Laravel通过'days'=>14设保留天数,不支持单文件大小阈值。

PHP 日志文件自动清理该用什么阈值?
PHP 本身不提供日志自动轮转或按阈值清理的功能——error_log 只负责写,不负责删。所谓“设置 logs 清理阈值”,实际是靠外部机制(如系统 cron + shell 脚本)或框架/应用层逻辑控制,核心判断依据通常是:文件大小、保留天数、日志数量。
常见误操作是试图在 php.ini 里找类似 log_max_size 的配置项,它并不存在。真正起作用的是你部署时定义的清理策略。
用 find 命令按天数清理 error_log 文件最稳妥
Linux 下最常用、最可靠的方式是配合 cron 定期执行 find 删除旧日志。例如,每天凌晨删掉 /var/log/php/ 下 7 天前的 *.log:
find /var/log/php/ -name "*.log" -mtime +7 -delete
-
-mtime +7表示“修改时间超过 7 天”,注意不是“创建时间” - 务必先用
-print测试,确认匹配路径无误再加-delete - 若日志被 PHP 进程持续写入(如 FPM worker 持有句柄),直接
rm可能导致磁盘空间不释放,find ... -delete在大多数场景下更安全 - 不要对正在写入的单一
error_log文件设“大小阈值后截断”,这容易破坏日志完整性,且 PHP 不会自动 reopen
自定义错误处理器中实现大小阈值截断(慎用)
如果你坚持要在 PHP 层做“单文件大小控制”,只能自己封装日志写入逻辑,在每次写入前检查文件大小。但要注意:error_log() 函数无法获取当前目标文件路径,所以必须绕过它,改用 fopen() + fwrite()。
立即学习“PHP免费学习笔记(深入)”;
示例逻辑(仅作示意,生产环境需加锁和异常处理):
$logFile = '/var/log/myapp/php_errors.log';
$maxSize = 10 * 1024 * 1024; // 10MB
if (file_exists($logFile) && filesize($logFile) > $maxSize) {
file_put_contents($logFile, '');
}
error_log("Something went wrong", 3, $logFile); // 注意:这里仍用 error_log 写,但目标固定- 这种做法只适用于你完全掌控日志路径(即不用系统默认
error_log配置)的场景 -
filesize()和file_put_contents('')不是原子操作,高并发下可能丢失日志 - PHP-FPM 下多个 worker 同时检查+清空,极易冲突,不推荐
Laravel / Symfony 等框架的日志阈值在哪配?
主流框架都基于 monolog/monolog,清理阈值由 RotatingFileHandler 控制,关键参数是 maxFiles(保留最多几个历史文件)和 filename 格式(隐含按天轮转)。它不直接支持“单文件最大 50MB 后滚动”,而是靠日期切分 + 数量限制。
以 Laravel 的 config/logging.php 为例:
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
'days' => 14, // ← 这就是“时间阈值”:只保留最近 14 天
],-
'days' => 14是最常用也最安全的阈值设定方式 - 想按大小滚动?Monolog 原生不支持,得换用
WhatFailureGroupHandler组合或自定义Handler - 注意:Laravel 9+ 默认使用
stack驱动,daily只是其中一个 channel,确保你在LOG_CHANNEL中启用它
真正的难点不在“设多少”,而在于确认日志路径是否被多进程共享、是否有权限删除、以及轮转后旧文件是否还在被某个僵尸进程 hold 住句柄——这些比数字阈值更容易导致磁盘爆满。











