Ubuntu中ThinkPHP日志配置与清理技巧

在日常的后端开发工作中，日志管理经常被忽视，但它实际上是一个至关重要的环节。特别是当你的项目运行在 Ubuntu 服务器上，并且基于 ThinkPHP 框架构建时，如何确保日志既清晰明了、安全可靠，又能自动完成轮转与清理，便成了一个不可回避的问题。

其实，实现这一整套流程并不复杂，核心在于两件事：一是 ThinkPHP 框架本身的日志配置，二是 Ubuntu 系统层面提供的日志轮转工具。只要这两者协同配合，日志管理基本上就能做到“省心又专业”。

一、ThinkPHP 日志基础配置

谈到 ThinkPHP 的日志管理，核心配置文件就是 config/log.php。这个文件几乎决定了日志如何存储、保存多久、记录哪些级别。更重要的是，它还支持多通道并行记录，以及敏感信息的过滤功能。在实际生产环境中，这些设置直接影响到问题排查的效率和系统的安全性。

1. 核心配置项说明

下面是一个典型的配置结构，它将日志划分为三种通道，分别对应不同的用途：常规日志、错误日志以及紧急日志。

return [
    'default'  => env('LOG_CHANNEL', 'stack'), // 默认使用stack通道（组合多个通道）
    'channels' => [
        'stack' => [
            'type'     => 'stack',
            'channels' => ['daily', 'error_file', 'emergency'], // 组合常规、错误、紧急日志通道
        ],
        'daily' => [ // 常规日志（按日分割）
            'type'     => 'file',
            'path'     => runtime_path('logs/daily'), // 日志存储路径（默认在runtime/logs下）
            'level'    => ['info', 'notice', 'warning'], // 记录info及以上级别日志
            'max_files' => 30, // 保留30天日志
            'file_size' => 10485760, // 单个日志文件超过10MB时分割
            'json'     => false, // 不使用JSON格式
        ],
        'error_file' => [ // 错误日志（单独存储）
            'type'       => 'file',
            'path'       => runtime_path('logs/error'),
            'level'      => ['error', 'critical'], // 仅记录error及以上级别
            'apart_level' => true, // 每个级别单独文件（如error.log、critical.log）
            'max_files'  => 90, // 保留90天
            'file_size'  => 20971520, // 20MB分割
            'json'       => true, // JSON格式便于后续分析
        ],
        'emergency' => [ // 紧急日志（长期保留）
            'type'     => 'file',
            'path'     => runtime_path('logs/emergency'),
            'level'    => ['emergency'],
            'max_files' => 365, // 保留1年
        ],
        // 可选：数据库日志（审计需要）
        'audit' => [
            'type'          => 'database',
            'table'         => 'system_logs',
            'connection'    => 'log_db',
            'level'         => ['info', 'notice'],
            'ignore_fields' => ['password', 'token'], // 过滤敏感字段
        ],
    ],
];

这段配置有几个值得关注的要点：

• 分级存储：将常规日志、错误日志、紧急日志分开存储，好处是一目了然。遇到紧急情况时，可以直接前往 error 目录查找，无需在成千上万条 info 级别日志中大海捞针。
• 性能控制：通过 file_size（10-20MB）和 max_files（30-365天）来限制日志文件的大小和保留周期。这能有效避免日志文件无限制膨胀，防止磁盘空间被撑爆。
• 安全增强：在数据库日志通道中加入了 ignore_fields，专门过滤 password、token 这类敏感信息。这是一个非常必要的操作，能避免因疏忽导致的数据泄露风险。

二、Ubuntu 系统日志轮转（Logrotate）

配置好框架层面的日志管理后，还需要借助系统级的工具——Logrotate。这是 Ubuntu 自带的日志管理利器，能够自动完成日志文件的轮转、压缩和删除。当项目流量增大或部署到线上环境时，这个工具几乎是必不可少的。

1. 创建 ThinkPHP 专用 Logrotate 配置

我们可以为 ThinkPHP 编写一个专门的 Logrotate 配置文件，放置在 /etc/logrotate.d/ 目录下。例如，创建一个名为 thinkphp 的文件：

sudo nano /etc/logrotate.d/thinkphp

然后填入以下配置（请注意将日志路径替换为你的项目实际路径）：

/var/www/html/your_project/runtime/logs/*.log {
    daily                    # 每天轮转
    rotate 7                 # 保留7天日志
    compress                 # 压缩旧日志（如.gz格式）
    delaycompress            # 延迟压缩（避免当天日志被压缩）
    missingok                # 日志文件不存在时不报错
    notifempty               # 日志为空时不轮转
    create 640 www-data www-data  # 新日志文件权限（属主：www-data，属组：www-data）
    sharedscripts            # 所有日志轮转完成后执行脚本
    postrotate
        /usr/bin/systemctl reload php8.1-fpm > /dev/null 2>&1 || true  # 重启PHP-FPM（根据实际版本调整）
    endscript
}

简单说明几个关键参数：

• daily：每天轮转一次。
• rotate 7：保留最近7天的日志。
• compress：压缩旧日志，节省磁盘空间。
• create：轮转后创建新的日志文件，并设置权限为 640，确保 Web 服务器用户拥有写入权限。
• postrotate：轮转结束后重启 PHP-FPM，确保日志能正常写入新文件。这一步非常关键，否则可能出现日志写入异常。

2. 测试与手动触发 Logrotate

配置完成后，建议先进行测试，确认语法没有错误：

sudo logrotate -d /etc/logrotate.d/thinkphp

如果输出没有任何报错，说明配置有效。如果想立即查看效果（而不是等待定时任务自动触发），可以手动强制执行一次：

sudo logrotate -f /etc/logrotate.d/thinkphp

三、ThinkPHP 日志清理方法

除了依赖系统工具自动轮转，有时我们还需要手动进行清理，或者在框架层面进一步加固。

1. 手动清理

如果遇到磁盘告急等紧急情况，可以直接使用 rm 命令删除日志文件。但操作前务必确认好路径，避免误删。更稳妥的做法是使用 truncate 命令，它不会删除文件本身，而是清空其内容，从而节省 inode 开销：

# 使用truncate清空文件内容，保留文件
sudo truncate -s 0 /var/www/html/your_project/runtime/logs/*.log

2. ThinkPHP 配置定期清理

在 config/log.php 中，也可以直接设定日志的自动清理周期。例如，在 daily 通道中添加一个 clear_time 参数：

'daily' => [
    'type'       => 'file',
    'path'       => runtime_path('logs/daily'),
    'level'      => ['info', 'notice', 'warning'],
    'max_files'  => 30,
    'file_size'  => 10485760,
    'clear_time' => 1, // 每天清理一次（框架会自动删除过期日志）
],

需要注意的是，clear_time 需要与 max_files 搭配使用，这样才能确保日志不会无限增长，同时保留足够的天数用于回溯问题。

四、日志权限管理

最后，很多人容易忽略权限设置。如果不小心将日志目录的权限设置得过大，或者设置得太严导致无法写入，都会带来麻烦。合理的做法是：

# 设置runtime目录权限（属主：www-data，属组：www-data）
sudo chown -R www-data:www-data /var/www/html/your_project/runtime

# 设置logs目录权限（640：属主可读写，属组可读，其他用户无权限）
sudo chmod -R 640 /var/www/html/your_project/runtime/logs

这样一来，Web 服务器用户（通常是 www-data）拥有读写权限，同组用户可以读取，而其他用户则无权访问。既保证了日志的正常写入，也降低了不必要的安全风险。

将以上几个环节串联起来——框架配置、系统轮转、手动与自动清理、权限管控——一套完整且可靠的 Ubuntu 下 ThinkPHP 日志管理方案就落地了。无论是开发调试还是线上问题排查，都能做到心中有数、手中有据。