php定时自动清理logs的实现背景
php项目运行时会产生大量运行日志、错误日志等文件,长期不清理会占用大量服务器磁盘空间,甚至影响项目运行效率。通过定时自动清理logs,可以按需保留指定时长的日志,自动删除过期文件,降低运维成本。

方案一:php脚本结合系统定时任务
实现原理
先编写php脚本实现日志清理逻辑,再通过系统自带的定时任务工具(Linux系统用crontab,Windows系统用任务计划程序)定时调用该脚本,实现自动清理。
清理脚本编写
以下是一个通用的php日志清理脚本,可自定义日志目录、保留天数等参数:
<?php
// 配置参数
$logDir = '/www/project/logs/'; // 日志目录路径
$keepDays = 7; // 保留最近7天的日志
$logExt = ['log', 'txt']; // 要清理的日志文件后缀
// 计算过期时间戳
$expireTime = time() - $keepDays * 24 * 3600;
// 遍历日志目录
if (is_dir($logDir)) {
$files = scandir($logDir);
foreach ($files as $file) {
// 跳过.和..目录
if ($file == '.' || $file == '..') {
continue;
}
$filePath = $logDir . $file;
// 只处理文件,跳过目录
if (is_file($filePath)) {
// 检查文件后缀是否符合要求
$ext = pathinfo($filePath, PATHINFO_EXTENSION);
if (in_array($ext, $logExt)) {
// 获取文件修改时间
$fileMtime = filemtime($filePath);
// 修改时间早于过期时间则删除
if ($fileMtime < $expireTime) {
unlink($filePath);
echo "已删除过期日志文件:{$filePath}" . PHP_EOL;
}
}
}
}
} else {
echo "日志目录不存在:{$logDir}" . PHP_EOL;
}
配置系统定时任务
如果是Linux系统,执行crontab -e命令添加定时任务,例如每天凌晨2点执行清理脚本:
0 2 * * * /usr/bin/php /www/project/clear_logs.php >> /www/project/clear_logs.log 2>&1
如果是Windows系统,打开任务计划程序,创建基本任务,设置触发时间为每天凌晨2点,操作选择启动程序,程序填写php.exe路径,参数填写清理脚本的绝对路径即可。
方案二:php内置函数实现内部定时清理
实现原理
利用php的ignore_user_abort和set_time_limit函数让脚本后台运行,通过循环和sleep函数实现定时触发清理逻辑,适合没有系统定时任务权限的场景。
代码实现
以下是内部定时清理的实现代码:
<?php
// 忽略用户断开连接
ignore_user_abort(true);
// 设置脚本不超时
set_time_limit(0);
// 配置参数
$logDir = '/www/project/logs/';
$keepDays = 7;
$logExt = ['log', 'txt'];
$clearInterval = 24 * 3600; // 清理间隔24小时
while (true) {
// 执行清理逻辑
$expireTime = time() - $keepDays * 24 * 3600;
if (is_dir($logDir)) {
$files = scandir($logDir);
foreach ($files as $file) {
if ($file == '.' || $file == '..') {
continue;
}
$filePath = $logDir . $file;
if (is_file($filePath)) {
$ext = pathinfo($filePath, PATHINFO_EXTENSION);
if (in_array($ext, $logExt)) {
$fileMtime = filemtime($filePath);
if ($fileMtime < $expireTime) {
unlink($filePath);
}
}
}
}
}
// 休眠指定间隔再执行下一次清理
sleep($clearInterval);
}
将该脚本通过命令行启动后,会在后台持续运行,按照设定的间隔自动清理过期日志。注意该方案会占用一个进程资源,适合小型项目使用。
注意事项
- 清理脚本执行前建议先备份重要日志,避免误删必要文件
- 日志目录路径需要设置正确的读写权限,确保php进程可以访问和删除文件
- 系统定时任务方案更稳定,优先选择该方案,内部定时方案仅作为无系统权限时的备选
- 可根据项目需求调整保留天数、清理文件后缀等参数,适配不同的日志存储规则