thinkphp在ubuntu下的日志管理怎么做

在Ubuntu下为ThinkPHP项目配置高效的日志管理

在Ubuntu服务器上部署ThinkPHP应用，一套清晰、可靠的日志管理方案是保障应用可观测性和排查问题的基石。下面，我们就来一步步搭建这套体系。

第一步：从配置文件入手

一切的基础在于正确的配置。你需要打开ThinkPHP项目的配置文件，通常是根目录下的 .env 文件或 config 目录下的 log.php。核心是设定好日志级别和存储路径。

例如，在 .env 文件中进行如下设置：

# .env 文件
LOG_LEVEL=debug
LOG_FILE=runtime/log/app.log

或者在 config.php 文件中以数组形式配置：

// config.php 文件
return [
    // ...
    'log' => [
        'level' => 'debug',
        'file'  => runtime_path() . 'log/app.log',
    ],
    // ...
];

这样一来，日志级别被设定为最详细的 debug，所有日志都将被写入项目 runtime/log 目录下的 app.log 文件中。

第二步：创建日志目录

配置写好了，但目录真的存在吗？为了避免运行时出错，最好手动创建好日志目录。在项目根目录下执行一条简单的命令即可：

mkdir -p runtime/log

第三步：在代码中记录日志

配置和目录就绪后，就可以在业务代码中灵活地记录日志了。在控制器或模型里，使用ThinkPHP内置的Log门面（Facade）非常方便：

use think\facade\Log;

// 记录一条信息级别的日志
Log::write('Hello, ThinkPHP!', 'info');

执行后，这条“Hello, ThinkPHP!”信息就会以info级别被写入之前配置的 runtime/log/app.log 文件中。

第四步：查看与分析日志

日志记下来了，怎么看？在Ubuntu这种命令行环境下，有两种主流方式。

如果你想实时追踪日志的动态，比如调试一个正在发生的问题，tail -f 命令是你的最佳伙伴：

tail -f runtime/log/app.log

当然，你也可以直接用文本编辑器（如 nano 或 vim）打开文件进行查看：

nano runtime/log/app.log

第五步：配置日志轮转，防止磁盘爆满

这是生产环境必不可少的一步。如果放任不管，日志文件会无限增长，最终撑满磁盘。Ubuntu自带的 logrotate 工具可以优雅地解决这个问题。

首先，为你的项目创建一个专属的logrotate配置文件：

sudo nano /etc/logrotate.d/thinkphp

然后，将以下配置内容粘贴进去：

/var/www/your_project_path/runtime/log/*.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
    create 640 root adm
}

关键提示：别忘了将 /var/www/your_project_path 替换成你项目的实际绝对路径。这段配置意味着：日志将按天轮转，保留最近7天的文件，并对旧的日志进行压缩以节省空间。

最后，确保logrotate服务已经启用并运行起来：

sudo systemctl enable logrotate
sudo systemctl start logrotate

完成以上所有步骤后，你的ThinkPHP项目在Ubuntu上就拥有了一套从记录、查看到自动维护的完整日志管理体系了。这不仅能帮助快速定位问题，也让系统管理更加规范。