kknongchang_2506/UCore/Logging

UCore 自定义日志驱动 - 支持文件大小限制的每日轮转

功能特点

1. 按日期创建日志文件：如 laravel-2025-05-26.log
2. 文件大小限制：当文件超过指定大小时自动分割
3. 自动备份：分割后的文件命名为 laravel-2025-05-26-1.log、laravel-2025-05-26-2.log 等
4. 自动清理：支持设置保留天数，自动删除过期文件
5. 灵活配置：支持多种文件大小单位（K、M、G）

使用方法

1. 环境变量配置

在 .env 文件中设置：

# 使用自定义日志驱动
LOG_CHANNEL=size_rotating_daily

# 最大文件大小（支持 K、M、G 单位）
LOG_MAX_FILE_SIZE=100M

# 保留天数
LOG_DAILY_DAYS=14

# 日志级别
LOG_LEVEL=debug

2. 配置选项说明

配置项	说明	默认值	示例
max_file_size	单个文件最大大小	100M	50M, 1G, 512K
days	保留天数（0表示不限制）	14	7, 30, 0
path	日志文件路径	storage/logs/laravel.log	-
level	日志级别	debug	info, warning, error
permission	文件权限	0777	0644, 0755
locking	是否使用文件锁	false	true, false

3. 文件大小单位

• K 或 KB：千字节
• M 或 MB：兆字节
  
• G 或 GB：千兆字节
• 无单位：字节

示例：

• 1024 = 1024 字节
• 10K = 10 千字节
• 50M = 50 兆字节
• 2G = 2 千兆字节

文件命名规则

基础文件

• laravel-2025-05-26.log - 当天的主日志文件

分割文件

• laravel-2025-05-26-1.log - 第一个分割文件
• laravel-2025-05-26-2.log - 第二个分割文件
• laravel-2025-05-26-3.log - 第三个分割文件

分割逻辑

1. 当主文件大小超过限制时，创建 -1 后缀的文件
2. 当 -1 文件也超过限制时，创建 -2 后缀的文件
3. 以此类推...

使用示例

基本使用

use Illuminate\Support\Facades\Log;

// 记录日志
Log::info('这是一条信息日志');
Log::error('这是一条错误日志');
Log::debug('这是一条调试日志');

在特定通道中使用

// 在配置文件中定义多个通道
'channels' => [
    'api' => [
        'driver' => 'size_rotating_daily',
        'path' => storage_path('logs/api.log'),
        'max_file_size' => '50M',
        'days' => 7,
    ],
    'error' => [
        'driver' => 'size_rotating_daily',
        'path' => storage_path('logs/error.log'),
        'max_file_size' => '200M',
        'days' => 30,
        'level' => 'error',
    ],
],

// 使用特定通道
Log::channel('api')->info('API 请求日志');
Log::channel('error')->error('系统错误日志');

自动清理机制

UCore 提供了自动清理过期日志文件的功能：

清理命令

# 使用配置文件中的保留天数（默认读取 size_rotating_daily.days 配置）
php artisan ucore:clean-size-rotating-logs

# 自定义保留天数
php artisan ucore:clean-size-rotating-logs --days=3

# 试运行（仅显示将要删除的文件）
php artisan ucore:clean-size-rotating-logs --dry-run

自动计划任务

系统会自动在每天凌晨3点执行清理任务，使用 size_rotating_daily.days 配置的保留天数。

性能考虑

1. 文件锁定：在高并发环境下，建议启用 locking 选项
2. 文件大小：建议设置合理的文件大小限制，避免单个文件过大
3. 保留天数：定期清理旧日志文件，避免磁盘空间不足

故障排除

权限问题

确保 Laravel 有权限写入日志目录：

chmod -R 755 storage/logs
chown -R www-data:www-data storage/logs

磁盘空间

定期检查磁盘空间，确保有足够空间存储日志文件。

配置验证

可以通过以下命令测试日志配置：

php artisan tinker
Log::info('测试日志消息');

与标准 daily 驱动的区别

特性	标准 daily	size_rotating_daily
按日期分割	✅	✅
按大小分割	❌	✅
自动备份	❌	✅
文件大小限制	❌	✅
保留天数	✅	✅
自动清理	❌	✅
性能	高	中等

注意事项

1. 该驱动会在每次写入日志时检查文件大小，可能会有轻微的性能影响
2. 分割后的文件不会再次分割，如果需要更细粒度的控制，请调整 max_file_size 参数
3. 备份文件会自动移动到 size_rotating_daily 子目录中进行管理