Debian系统中ThinkPHP日志管理指南

一、ThinkPHP日志配置（Debian环境适配）

ThinkPHP的日志配置文件位于application/config.php（旧版本）或config/log.php（新版本），核心配置项包括日志通道、存储路径、级别、滚动策略等，需根据Debian服务器环境调整权限和路径。

1. 基础配置示例（新版本）

// config/log.php
return [
    'default' => env('APP_LOG_CHANNEL', 'file'), // 默认通道（通过.env文件动态切换）
    'channels' => [
        'file' => [ // 文件日志通道（默认）
            'type' => 'file',
            'path' => runtime_path('log'), // 日志目录（runtime为项目runtime目录）
            'level' => ['info', 'error', 'critical'], // 记录级别（低于该级别的日志将被过滤）
            'max_files' => 30, // 最大保留日志文件数（避免磁盘占满）
            'json' => false, // 是否以JSON格式存储（便于ELK等工具解析）
        ],
        // 生产环境可添加邮件报警通道（需配置SMTP）
        'email_alert' => [
            'type' => 'email',
            'receivers' => ['admin@example.com'],
            'subject' => 'ThinkPHP系统错误报警',
            'level' => ['emergency', 'critical'], // 仅发送高严重级别日志
        ],
    ],
];

2. Debian环境注意事项

目录权限：确保runtime/log目录可被Web服务器用户（如www-data）写入，执行以下命令修复权限：
```
chown -R www-data:www-data /path/to/your/project/runtime/log
chmod -R 755 /path/to/your/project/runtime/log
```
路径适配：若项目部署在Debian的/var/www/html下，runtime_path()会自动指向/var/www/html/runtime，无需修改路径。

二、日志级别与记录方法

ThinkPHP支持8种日志级别（从低到高）：debug→info→notice→warning→error→critical→alert→emergency，可根据需求过滤日志。

1. 常用日志记录方法

use think\facade\Log;

// 基础记录（手动触发）
Log::write('这是一条手动记录的info日志', 'info');

// 快速方法（自动关联级别）
Log::info('用户登录成功', ['user_id' => 1001]); // info级别
Log::error('数据库连接失败', ['host' => 'localhost']); // error级别

// 带上下文的日志（数组会自动转为JSON）
Log::warning('磁盘空间不足', ['usage' => '95%', 'partition' => '/']);

2. 级别控制技巧

开发环境：设置为debug级别，记录详细信息（包括SQL、请求响应）：
```
// .env文件（开发环境）
APP_LOG_LEVEL = debug
```
生产环境：设置为error或critical级别，仅记录关键错误，减少日志量：
```
// .env文件（生产环境）
APP_LOG_LEVEL = error
```

三、日志文件存储与管理

1. 默认存储路径

ThinkPHP的日志默认按天分割存储在runtime/log/YYYY-mm-dd.log（如runtime/log/2025-10-06.log），便于按日期归档和查询。

2. 查看日志文件

命令行查看：使用tail命令实时监控最新日志（如查看2025-10-06的error日志）：
```
tail -f /path/to/your/project/runtime/log/2025-10-06.log | grep "error"
```
ThinkPHP命令：通过php think log命令查看所有日志文件内容：
```
cd /path/to/your/project
php think log
```
支持选项：--level=error（仅查看error级别）、--channel=file（指定通道）。

四、日志清理与轮转

1. 手动清理

直接删除runtime/log目录下的旧日志文件（如删除30天前的日志）：

find /path/to/your/project/runtime/log -type f -name "*.log" -mtime +30 -delete

2. 自动清理（Debian系统）

使用logrotate工具实现日志自动轮转（Debian默认已安装），编辑/etc/logrotate.d/thinkphp文件：

/path/to/your/project/runtime/log/*.log {
    daily                   # 每天轮转
    missingok               # 忽略缺失文件
    rotate 30               # 保留30天日志
    compress                # 压缩旧日志（节省空间）
    notifempty              # 空日志不轮转
    create 640 www-data www-data # 新日志文件权限
    sharedscripts           # 所有日志轮转完成后执行脚本
    postrotate
        /usr/bin/php /path/to/your/project/think log:clear # 可选：执行ThinkPHP日志清理命令
    endscript
}

保存后，logrotate会每天自动执行（可通过logrotate -vf /etc/logrotate.d/thinkphp测试）。

五、高级配置（可选）

1. 自定义日志通道（如数据库）

若需将日志存储到数据库，可配置channels中的db通道：

// config/log.php
return [
    'channels' => [
        'db' => [
            'type' => 'database',
            'table' => 'system_logs', // 数据库表名（需提前创建）
            'connection' => 'mysql', // 数据库连接配置（对应config/database.php中的连接名）
        ],
    ],
];

使用时通过channel方法指定通道：

Log::channel('db')->info('订单创建成功', ['order_id' => 2001]);

2. 集成Sentry（错误监控）

通过Sentry捕获异常并发送到监控平台，提升错误处理效率：

# 安装Sentry SDK
composer require sentry/sdk

// 初始化Sentry（如config/bootstrap.php）
use Sentry\SentrySdk;
SentrySdk::init(['dsn' => 'https://your-sentry-dsn@sentry.io/123456']);

// 捕获异常（如app/middleware/Error.php）
try {
    // 业务代码
} catch (\Exception $e) {
    SentrySdk::captureException($e);
    throw $e; // 继续抛出异常
}

六、常见问题排查

日志不写入：检查runtime/log目录权限、config/log.php中的default通道配置是否正确。
日志过大：调整max_files（限制文件数量）或file_size（限制单个文件大小，单位字节）。
敏感信息泄露：避免在日志中记录密码、密钥等敏感数据，可使用Log::record()过滤上下文。

0 赞

0 踩