Debian系统ThinkPHP日志如何管理

Debian下ThinkPHP日志管理实践

一 基础配置与目录

• 默认日志路径为项目根目录下的runtime/log，按天生成文件（如：YYYY-mm-dd.log）。可在配置文件config/log.php中调整：
  • 指定日志通道与级别：
    • 通道示例：‘default’ => ‘file’
    • 级别从低到高：debug → info → notice → warning → error → critical → alert → emergency
  • 常用参数：
    • ‘path’：日志目录（留空默认 runtime/log）
    • ‘level’：保留级别（如仅记录 error 及以上）
    • ‘max_files’：最大保留文件数（控制历史数量，避免磁盘占满）
    • ‘json’：是否 JSON 格式输出
• 写入示例（使用门面 Log）：
  • Log::info(‘用户登录’, [‘user_id’ => 1]);
  • Log::error(‘支付失败’, [‘order_id’ => 1001, ‘reason’ => ‘余额不足’]);
• 排查要点：若日志不写入，优先检查runtime/log目录及上级目录的写权限。

二 轮转与保留策略

• 框架内置保留
  • 通过配置max_files限制保留的历史文件数量，适用于按天生成的日志文件，防止无限增长。
• 系统级 Logrotate（推荐）
  • 将 ThinkPHP 日志纳入logrotate统一管理，便于按大小或时间轮转、压缩与清理。
  • 示例配置（/etc/logrotate.dphp）：

    /var/www/your-app/runtime/log/*.log {
        daily
        rotate 30
        compress
        delaycompress
        missingok
        notifempty
        create 0755 www-data www-data
        copytruncate
    }
    

    • 关键参数说明：
      • daily/weekly：按天/周轮转
      • size 100M：达到100MB即轮转（可与时间策略并存）
      • rotate 30：保留30个历史文件
      • compress/delaycompress：压缩旧日志，延迟压缩最新一份
      • missingok/notifempty：文件缺失或为空时不报错/不轮转
      • create：轮转后重建日志文件并设定权限与属主
      • copytruncate：复制后截断原文件，避免应用重新打开文件句柄（适合无法发送信号的应用）
  • 测试与状态查看：
    • 手动强制执行：sudo logrotate -f /etc/logrotate.dphp
    • 查看状态：cat /var/lib/logrotate/status
  • 运行方式：
    • Debian 通常已通过**/etc/cron.daily/logrotate每日调用；如日志增长很快，可改为每小时**执行或添加 size 触发策略。

三 多通道与高级用法

• 多通道日志
  • 除文件外，可配置数据库通道等，将日志写入数据表，便于检索与聚合：

    'channels' => [
        'db' => [
            'type'       => 'database',
            'table'      => 'logs',
            'connection' => null,
        ],
    ]
    

  • 使用：Log::channel(‘db’)->info(‘订单创建’, [‘order_id’ => 2001]);
• 性能与可读性
  • 高频日志可开启批量写入：Log::batch(true)
  • 需要结构化日志时开启json输出，便于后续分析。

四 监控与清理

• 实时查看与检索
  • 实时查看：tail -f runtime/log/2025-07-07.log
  • 关键字检索：grep -i “error” runtime/log/*.log
• 归档压缩脚本（可选）
  • 通过自定义命令将历史日志按月份归档压缩，配合cron在每日 1 点执行，进一步节省空间（适合对历史数据做长期留存与离线分析）。
• 系统日志联动
  • 若需将 PHP 错误或系统级事件纳入统一管理，可使用systemd-journald并设置保留策略（如 SystemMaxUse、MaxRetentionSec），用 journalctl 查询与维护。

五 安全与合规建议

• 权限最小化：确保日志目录仅对**Web服务用户（如 www-data）**可写，其他用户只读或不可访问。
• 敏感信息：避免记录密码、密钥、银行卡号等敏感数据；上线前审计日志格式与内容。
• 保留周期：结合合规与存储成本设置合理的rotate与max_files，对超过保留期的历史日志进行压缩与归档或删除。