Linux下ThinkPHP如何实现日志管理

在 Linux 环境下用 ThinkPHP 做日志管理，说复杂也复杂，说简单也简单。核心其实就是四件事：怎么配、怎么记、怎么看、怎么切。下面我们一个一个来拆解。

1. 配置日志设置

日志相关的配置，通常躺在 application 目录下的 config.php 文件中。你可以在这里定义日志类型、存储路径、记录级别等关键参数。举个例子：

return [
    // ...
    'log' => [
        'type'    => 'file',   // 日志类型：file、daily、syslog、errorlog、monolog 等
        'path'    => LOG_PATH, // 日志文件保存目录
        'level'   => 'info',   // 记录级别：error、warn、info、debug、sql 等
        'max-file'=> 5,        // 日志文件最大数量
        'max-size'=> 2048,     // 单个日志文件最大大小（KB）
        'day'     => '',       // 按天切割，留空则不切割
    ],
    // ...
];

这里有几个细节值得注意：日志级别决定了哪些信息会被写进去；max-file 和 max-size 能帮你控制磁盘占用，避免日志把磁盘撑爆。

2. 记录日志

真正在代码里写日志，用的是 think\Log 类。它提供了几个很直观的方法，按需求调用即可：

use think\Log;

// 错误日志
Log::error('这是一个错误日志');
// 警告日志
Log::warn('这是一个警告日志');
// 信息日志
Log::info('这是一个信息日志');
// 调试日志
Log::debug('这是一个调试日志');
// SQL日志
Log::sql('这是一个SQL日志');

实际项目中，建议只在关键路径（比如异常捕获、数据库操作、外部接口调用）上打日志，别塞太多无关紧要的调试信息，否则后期查日志会非常痛苦。

3. 查看日志

写完了日志，怎么实时查看？Linux 下最常用的就是 tail 命令。假设你的日志文件在 application/runtime/log/ 文件夹下，可以这样：

tail -f ./application/runtime/log/your_log_file.log

加上 -f 参数后，终端会持续监听文件变化，新写入的日志会立刻显示出来，debug 的时候特别顺手。当然，grep、less 这些命令也经常配合使用，按需搜索特定关键词。

4. 日志切割

前面配置里设置了按天切割（'day' => '' 留空则不按天），如果你配置了按天，ThinkPHP 会在每天凌晨自动创建新文件并归档旧文件。不过，生产环境更推荐用系统自带的 logrotate 来做统一管理，因为它的策略更灵活。

在 Linux 上，logrotate 的配置通常放在 /etc/logrotate.d/ 目录下。创建一个针对 ThinkPHP 的配置文件，比如 /etc/logrotate.d/thinkphp，内容如下：

/path/to/your/thinkphp/runtime/log/*.log {
    daily
    missingok
    rotate 7
    compress
    notifempty
    create 640 root adm
}

这段配置的含义很简单：每天切割一次，保留最近7天的日志，旧文件压缩归档，如果日志为空就不管它，并且创建新文件时设定权限为 640、属主为 root、属组为 adm。这样既能控制磁盘使用量，又不会丢数据。

总结一下：日志管理这件事，配置优雅、记录规范、查看方便、切割自动，才算真正落地。从实践角度看，很多项目前期忽视日志策略，等到线上出问题才手忙脚乱地去翻，那时候再优化就麻烦了。所以建议一开始就按上面这套思路搭好，后面能省不少心。