Debian系统中ThinkPHP日志管理指南

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

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

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

// config/log.phpreturn ['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' => ['[email protected]'],'subject' => 'ThinkPHP系统错误报警','level' => ['emergency', 'critical'], // 仅发送高严重级别日志],],];

2. Debian环境注意事项

• 目录权限：确保runtime/log目录可被Web服务器用户（如www-data）写入，执行以下命令修复权限：

  chown -R www-data:www-data /path/to/your/project/runtime/logchmod -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 thinkfacadeLog;// 基础记录（手动触发）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/projectphp 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.phpreturn ['channels' => ['db' => ['type' => 'database','table' => 'system_logs', // 数据库表名（需提前创建）'connection' => 'mysql', // 数据库连接配置（对应config/database.php中的连接名）],],];

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

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

2. 集成Sentry（错误监控）

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

# 安装Sentry SDKcomposer require sentry/sdk

// 初始化Sentry（如config/bootstrap.php）use SentrySentrySdk;SentrySdk::init(['dsn' => 'https://[email protected]/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()过滤上下文。