thinkphp在ubuntu中的日志如何管理

ThinkPHP在Ubuntu中的日志管理指南

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

ThinkPHP的日志管理需通过配置文件调整，Ubuntu环境下需确保路径权限正确。

配置文件位置：
日志配置主要在项目根目录的config/config.php（或.env环境变量文件）中，关键参数包括：
- 日志驱动：默认file（文件存储），支持syslog（系统日志）等；
- 存储路径：path参数指定日志目录（如runtime/log/），需确保Ubuntu用户（如www-data）对该目录有写入权限（chmod -R 755 runtime/log/）；
- 日志级别：level参数控制记录级别（DEBUG、INFO、WARN、ERROR、FATAL），生产环境建议设为ERROR或WARN以减少日志量；
- 日志格式：format参数自定义日志输出格式（如{date} [{time}] {level} {message}）。
  示例配置（config/config.php）：
```
'log' => [
    'type' => 'file',          // 日志驱动
    'path' => './runtime/log/', // 存储路径（相对项目根目录）
    'level' => ['error', 'warn'], // 仅记录ERROR和WARN级别
    'expire' => 7,             // 日志保留7天（自动清理）
],
```
若使用.env文件（推荐），可添加：
```
LOG_TYPE=file
LOG_PATH=./runtime/log/
LOG_LEVEL=error,warn
```

二、日志记录方法

ThinkPHP提供Log门面类统一记录日志，支持分类记录（便于后续筛选）。

基础记录：

use think\facade\Log;
Log::info('用户登录成功', ['user_id' => 1001]); // INFO级别
Log::error('数据库连接失败', ['host' => 'localhost']); // ERROR级别

SQL日志：
记录执行的SQL语句（默认notice级别），需手动开启：
```
Log::sql('SELECT * FROM users WHERE id = 1'); // 自动记录到SQL分类
```

动态配置：
运行时调整日志级别（如临时开启DEBUG）：

Log::init(['level' => ['debug']]); // 仅记录DEBUG及以上级别

三、日志查看与实时监控

直接查看日志文件：
ThinkPHP日志默认存储在runtime/log/目录（如runtime/log/202509.log），使用Ubuntu命令行工具查看：

# 查看最新日志（分页）
less runtime/log/202509.log
# 实时监控新增日志（tail -f）
tail -f runtime/log/202509.log
# 搜索ERROR日志
grep 'ERROR' runtime/log/202509.log

ThinkPHP命令行工具：
使用php think log命令快速查看所有日志文件内容：

php think log     # 查看所有日志
php think log -l error  # 仅查看ERROR级别日志

Ubuntu系统工具：
若日志写入系统日志（syslog），可使用journalctl查看：

journalctl -u apache2 | grep 'ThinkPHP'  # 查看Apache关联的ThinkPHP日志
journalctl --since "2025-09-01" --until "2025-09-30"  # 按时间筛选

四、日志清理与轮转

手动清理：
直接删除旧日志文件（谨慎操作）：
```
rm -rf runtime/log/*.log  # 删除所有.log文件
```

自动轮转（推荐）：
使用Ubuntu的logrotate工具定期压缩、删除旧日志，避免磁盘空间耗尽。

创建配置文件：在/etc/logrotate.d/下新建thinkphp文件：
```
sudo nano /etc/logrotate.d/thinkphp
```

配置内容（示例）：

/path/to/your/project/runtime/log/*.log {
    daily                   # 每天轮转
    rotate 7                # 保留7天
    missingok               # 文件不存在不报错
    notifempty              # 空文件不轮转
    compress                # 压缩旧日志（.gz）
    delaycompress           # 延迟压缩（避免当天日志被压缩）
    sharedscripts           # 所有日志处理完再执行脚本
    postrotate
        /usr/bin/php /path/to/your/project/think log:clear  # 可选：执行ThinkPHP日志清理命令
    endscript
}

测试配置：

sudo logrotate -vf /etc/logrotate.d/thinkphp  # 手动测试

logrotate会自动通过cron每天运行（无需额外配置）。

五、权限与安全注意事项

目录权限：runtime/log/目录需属于Web服务器用户（如www-data），避免权限不足导致日志无法写入：
```
chown -R www-data:www-data runtime/log/
chmod -R 755 runtime/log/
```
敏感信息过滤：避免在日志中记录密码、密钥等敏感信息，可通过Log::record的context参数过滤：
```
Log::error('登录失败', ['username' => $username, 'ip' => $ip]); // 不记录密码
```
日志级别控制：生产环境关闭DEBUG级别，防止日志文件过大。

通过以上步骤，可实现ThinkPHP在Ubuntu环境中的高效日志管理，覆盖配置、记录、查看、清理全流程，确保应用运行状态可追溯。