在 Ubuntu 上使用 ThinkPHP 进行日志管理

在 Ubuntu 环境下为 ThinkPHP 项目配置一套清晰、高效的日志管理体系，其实并不复杂。关键在于理解框架的日志机制，并做好相应的配置和目录管理。下面这几个步骤，可以说是搭建这套体系的基石。

1. 配置日志设置

一切从配置文件开始。打开项目 application 目录下的 config.php 文件，找到日志配置部分（通常在文件末尾）。这里的每一项设置，都直接决定了日志的行为模式。

return [
    // ...
    'log' => [
        'type' => 'File', // 日志类型，支持 File、Daily、Mysql 等
        'path' => runtime_path() . 'logs', // 日志文件存储路径
        'level' => ['error', 'info'], // 日志记录级别
        'max_file' => 5, // 单个日志文件最大大小，单位 MB
        'max_days' => 7, // 日志文件最大保留天数
    ],
    // ...
];

简单解读一下：type 定义了存储方式，最常用的是按文件存储；path 指明了日志的“家”在哪里；level 控制着哪些级别的信息会被记录，比如这里就只记录错误和信息级别；而 max_file 和 max_days 则是日志的“自动清理”规则，防止磁盘被陈年日志占满。

2. 创建日志目录

配置文件里指定的路径，系统可不会自动创建。这就需要我们手动确保目录存在。打开终端，运行下面这条命令：

mkdir -p /path/to/your/project/runtime/logs

记得把 /path/to/your/project 替换成你项目的实际根目录路径。这一步看似简单，却经常被忽略，导致日志写入失败。

3. 记录日志

配置好了“场地”，接下来就是在代码中“播种”日志了。ThinkPHP 提供了非常便捷的日志门面（Facade）来调用。在需要记录日志的地方，可以这样操作：

use think\facade\Log;

// 记录错误日志
Log::error('Error message');
// 记录信息日志
Log::info('Info message');
// 记录调试日志
Log::debug('Debug message');

根据不同的业务场景和问题严重程度，选择合适的日志级别进行记录，这对于后续的问题排查和系统监控至关重要。

4. 查看和清理日志

日志记下来了，怎么查看呢？对于正在运行的服务，实时跟踪日志是排查问题的利器。在终端使用 tail -f 命令：

tail -f /path/to/your/project/runtime/logs/think.log

同样，需要将 /path/to/your/project 替换为实际路径。这个命令会持续输出日志文件末尾的新内容，让你对系统状态一目了然。

至于日志清理，虽然框架配置了保留天数，但有时我们可能需要更主动地管理。可以运行以下命令手动清理过期文件：

find /path/to/your/project/runtime/logs -type f -name "*.log.*" -mtime +7 -exec rm {} \;

这个命令会查找指定目录下7天前的日志文件并删除。当然，/path/to/your/project 和 +7（天数）都可以根据你的实际需求进行调整。

遵循以上步骤，就能在 Ubuntu 上为 ThinkPHP 项目建立起一套基础的日志管理流程。剩下的，就是根据项目具体的性能和存储需求，对配置进行微调，让日志系统真正成为开发运维的得力助手。