Linux中ThinkPHP日志如何查看

Linux下查看 ThinkPHP 日志的实用方法

一 定位日志目录

• 默认情况下，日志位于应用运行目录的 runtime/log（或 runtime/Logs）。框架提供了路径常量 LOG_PATH，其默认值为 RUNTIME_PATH.‘Logs/’，而 RUNTIME_PATH 默认是 APP_PATH.‘Runtime/’。因此常见路径为：项目根目录/runtime/log/ 或 项目根目录/Application/Runtime/Logs/。实际项目中，日志目录可由配置或常量调整，优先以项目配置为准。

二 常用 Linux 命令

• 实时查看当天日志（最常用）
  • 命令：tail -f runtime/log/$(date +%Y-%m-%d).log
  • 说明：动态输出当天日志，适合边操作边排查。
• 查看指定日期日志
  • 命令：tail -n 200 runtime/log/2025-07-07.log
  • 说明：查看某一天末尾 200 行，便于定位当日问题。
• 按模块或入口区分查看（适用于多模块/多入口项目）
  • 命令：tail -f runtime/log/index/30.log
  • 说明：部分版本或部署会将日志按模块/入口分目录或按日再分子文件，文件名可能是 30.log（按日）等，需按实际目录结构查找。
• 结合 grep 过滤关键字
  • 命令：tail -f runtime/log/*.log | grep -i "exception\|SQL\|支付失败"
  • 说明：快速筛选包含异常、SQL、业务关键字（如“支付失败”）的日志行。
• 权限不足时先确认目录可写
  • 命令：ls -ld runtime/log 或 namei -l runtime/log
  • 说明：确保 runtime/log 对运行 PHP 的用户（如 www-data、nginx）可写，否则日志可能不生成。

三 不同版本与常见路径对照

四 看不到日志时的排查要点

• 配置日志级别与通道
  • 建议将日志级别至少包含 error（如：'level' => ['error']），否则 debug/info 不会写入；如使用多通道，确认当前通道为 file。示例（TP5 常见写法）：
    • 配置：'log' => ['level' => ['error'], 'type' => 'File', 'path' => '../runtime/log/']
• 确认日志写入路径
  • 若项目自定义了 LOG_PATH 或 path，需到自定义目录查找；也可在代码中打印 echo LOG_PATH; 确认实际路径。
• 目录权限与磁盘空间
  • 确保 runtime/log 可写（chmod/chown），并关注磁盘是否已满（日志过大可能被系统或进程轮转/截断）。
• 多模块/多入口结构
  • 日志可能分散在模块目录（如 Home/Admin/index）或按日期分子目录，需逐层查找对应日期文件。