按模块名匹配删除logs文件需结合文件名/路径约定与时间条件,推荐用glob()配合filemtime()清理指定模块下过期日志,注意路径拼接、权限校验及避免高峰时段执行。

按模块名匹配删除 logs 文件
PHP 本身不提供日志模块自动清理功能,所谓“按模块清理”,本质是靠文件名或路径约定来识别日志归属。常见做法是把模块名嵌入日志文件名(如 user_module.log、payment_v2.log)或放在子目录里(如 logs/user/、logs/payment/)。清理时直接用 glob() 或 scandir() 匹配路径模式即可。
示例:清理所有含 api_ 前缀的 log 文件
foreach (glob("logs/api_*.log") as $file) {
unlink($file);
}- 注意
glob()不递归,若模块日志在子目录(如logs/api/v1/*.log),需用RecursiveIteratorIterator或两次glob("logs/api/*/*.log") - 路径必须是相对或绝对真实路径,不能是 URL;建议用
__DIR__ . '/logs/'拼接避免路径错误 - 执行前最好加
is_writable()判断,否则unlink()静默失败
用 filemtime 判断并清理指定天数前的模块日志
单纯按模块名删容易误伤当天日志,更安全的做法是「按模块 + 时间」双条件清理。PHP 的 filemtime() 可获取最后修改时间,配合 time() - 86400 * $days 就能筛出过期文件。
示例:清理 logs/order/ 下 7 天前的所有 .log 文件
立即学习“PHP免费学习笔记(深入)”;
$dir = __DIR__ . '/logs/order/';
$expireTime = time() - 86400 * 7;
foreach (glob($dir . "*.log") as $file) {
if (filemtime($file) < $expireTime) {
unlink($file);
}
}-
filemtime()返回秒级时间戳,不要和date()字符串比较 - 如果日志是滚动写入(如
app.log.2024-05-01),建议统一用日期后缀命名,再用preg_match('/\.log\.(\d{4}-\d{2}-\d{2})$/', $file, $m)提取日期解析 - 大目录下频繁调用
filemtime()有性能开销,可先scandir()获取文件列表,再批量 stat
避免 unlink 权限失败的三个关键点
线上环境 PHP 进程用户(如 www-data、nginx)往往没权限删其他用户创建的日志文件,unlink() 失败却不报错,导致“以为删了,其实没删”。
- 删之前务必检查:
is_file($file) && is_writable($file),缺一不可(is_writable()对文件才有效,对目录是判断能否新建文件) - 如果日志由 cron 脚本以 root 写入,而 PHP-FPM 以 www-data 运行,得改日志生成逻辑——让 PHP 进程自己写日志,或用
chown www-data:www-data $file在写入后立刻修正权限 - Windows 下注意
unlink()无法删除正在被占用的文件(比如日志还在被 tail -f 查看),会报Permission denied错误,需确保无进程锁住该文件
用 shell 命令辅助清理更可靠
纯 PHP 清理在大日志量或复杂路径下容易超时、内存溢出。实际项目中,更推荐用系统命令委托给 shell 执行,PHP 只负责触发和校验。
示例:清理 logs/search/ 下 30 天前的所有 .log 文件
$cmd = "find " . escapeshellarg(__DIR__ . '/logs/search') . " -name '*.log' -mtime +30 -delete 2>/dev/null"; exec($cmd, $output, $returnCode);
-
escapeshellarg()必须加,防止路径含空格或特殊字符导致命令注入或截断 -
-mtime +30表示“修改时间超过 30 天”,不是“30 天整”,精确到天;需要小时级控制请改用-mmin +43200 -
exec()默认被禁用,确认disable_functions中没禁掉exec、shell_exec;若被禁,只能退回纯 PHP 方案并加set_time_limit(0)
模块化日志清理真正难的不是代码怎么写,而是日志命名是否一致、权限是否可控、以及清理时机是否避开高峰写入——这些比函数选型重要得多。











