FrankenPHP怎么关联访问日志和业务日志-php教程-PHP中文网

frankenphp 默认不关联访问日志与业务日志，需通过 x-request-id 实现关联：启动时用 --log-format 注入 header，php 入口生成并透传该 id，所有日志显式携带，monolog 用 processor 统一注入，避免依赖 $_server['request_id']。

frankenphp怎么关联访问日志和业务日志

FrankenPHP 的访问日志和业务日志默认不关联

FrankenPHP 本身不自动注入请求 ID 或 trace ID 到 PHP 进程上下文，所以 error_log()、Monolog 或 Laravel 的日志写入，和 Nginx/Apache 风格的访问日志（如 access.log）天然脱节。你看到的每条访问日志行和每条 PHP 错误/调试日志之间，没有可直接匹配的字段。

用 `X-Request-ID` 头 + 自定义日志格式打通两端

最轻量且兼容性最好的方式是：由 FrankenPHP 在入口层生成唯一 X-Request-ID，透传给 PHP，并让 PHP 日志器在每条日志中显式输出该 ID；同时修改 FrankenPHP 的日志格式，把该 header 写入 access.log。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

FrankenPHP 启动时加 --log-format 参数，例如：

frankenphp --log-format='{"time":"%t","status":%s,"method":"%m","path":"%U","request_id":"%{X-Request-ID}i"}'

在 PHP 入口（如 public/index.php）开头加：

$requestId = $_SERVER['HTTP_X_REQUEST_ID'] ?? bin2hex(random_bytes(8));<br>putenv("REQUEST_ID=$requestId");

所有后续日志（包括 error_log()、Monolog handler）都应手动拼接该 ID，例如：
```
error_log("[{$requestId}] User login failed: invalid token");
```
注意：FrankenPHP 不会自动设置 X-Request-ID，需前端反代（如 Nginx）或客户端携带；若无外部网关，可在 frankenphp.yaml 的 server 下用 headers 注入：
```
headers:<br>  X-Request-ID: "{{.RequestID}}"
```

PHP 中避免依赖 `$_SERVER['REQUEST_ID']` 直接读取

FrankenPHP 不会把自定义环境变量（如 REQUEST_ID）自动注入到 $_SERVER 数组里，只对 putenv() 设置的变量生效于当前进程——但很多日志库（如 Laravel 的 Log::info()）默认不读取环境变量，也不会自动带入上下文。

不要写 $_SERVER['REQUEST_ID'] —— 它不存在，会返回 undefined index
改用 getenv('REQUEST_ID') 或 $_ENV['REQUEST_ID']（需确保 variables_order 包含 E）

Monolog 可用 Processors 统一注入：

$logger->pushProcessor(new \Monolog\Processor\PsrLogMessageProcessor());<br>$logger->pushProcessor(function ($record) {<br>    $record['extra']['request_id'] = getenv('REQUEST_ID') ?: 'unknown';<br>    return $record;<br>});