thinkphp 8.0需通过自定义contextformatter类扩展日志上下文，添加请求id、ip、uri等信息；须创建于app/extend/log/目录，命名空间严格匹配，配置log.php中file通道的formatter项指向该类，并验证日志是否含结构化前缀。
ThinkPHP 8.0 默认日志格式不包含请求ID、用户IP、URI等上下文信息，调试时难以快速关联一次请求的完整日志链；直接修改核心日志驱动会破坏升级兼容性，必须通过自定义 Formatter 实现结构化扩展。
创建 Formatter 类并继承 FileFormatter
在 app/extend/log/ 目录下新建 ContextFormatter.php 文件（若目录不存在请手动创建），文件内容如下：
这一步不能放在 vendor 或 runtime 下，否则框架启动时无法自动加载；命名空间必须与目录结构严格匹配，否则类自动加载失败。
```php
namespace app\extend\log;
use think\log\driver\FileFormatter;
use think\facade\Request;
class ContextFormatter extends FileFormatter
{
public function format($message, $level, $time, $extra = [])
{
$context = [
'ip' => Request::ip() ?: 'unknown',
'uri' => Request::url() ?: '/',
'method' => Request::method(),
'request_id' => $this->getRequestId(),
];
$extra = array_merge($extra, $context);
return parent::format($message, $level, $time, $extra);
}
private function getRequestId()
{
return $_SERVER['HTTP_X_REQUEST_ID'] ?? substr(md5(uniqid('', true)), 0, 8);
}
}
注册 Formatter 到 file 通道
打开 config/log.php，找到 'channels' => ['file' => [...]] 配置段，在 file 通道数组内添加 formatter 键：
【'formatter' => '\app\extend\log\ContextFormatter'】 这个字符串必须是完整命名空间路径，且用双反斜杠转义，写成单反斜杠或漏掉前导反斜杠会导致类找不到而静默回退到默认格式器。
修改后该段应类似：
```php
'file' => [
'type' => 'File',
'path' => runtime_path('log/'),
'single' => false,
'max_files' => 30,
'formatter' => '\app\extend\log\ContextFormatter',
],
验证上下文是否生效
第一步：清空 runtime/log/ 目录，避免旧日志干扰判断；
第二步：在任意控制器中插入测试日志：
Log::info('订单创建开始', ['order_id' => 'ORD20260707001']);
第三步：访问对应路由触发该代码；
第四步：打开最新生成的日志文件（如 runtime/log/2026_07/07.log），查找刚写入的那条记录——确认行首时间戳后是否紧跟着 [ip:127.0.0.1][uri:/api/order/create][method:POST][request_id:abc123de] 这类结构化前缀；
若未出现，检查 app/extend/log/ContextFormatter.php 是否被正确命名并保存为 UTF-8 无 BOM 格式，BOM 头会导致 PHP 解析失败且无任何报错提示。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
