PHP 8.5 本身不内置链路追踪，需集成 OpenTelemetry PHP 等 SDK 并透传 trace_id：入口提取 traceparent、出站注入头、异步序列化上下文，并利用其异常增强联动记录 trace_id 与参数。
PHP 8.5 本身不内置链路追踪能力，但它的错误处理增强（如更完整的堆栈帧、参数快照、结构化异常上下文）天然适配分布式追踪场景。配置微服务链路追踪的关键不是升级 PHP 版本，而是**在 PHP 8.5 环境中正确集成追踪 SDK 并透传上下文**。下面分三步讲清实操要点：
用 jukylin/jaeger-php 或 OpenTelemetry PHP 实现埋点
推荐优先使用 OpenTelemetry PHP（官方维护、兼容 W3C trace-context 标准），若已有 Jaeger 基础可沿用 jukylin/jaeger-php。
- 安装 OpenTelemetry：
composer require open-telemetry/exporter-otlp-http open-telemetry/sdk-trace - 初始化时启用自动 HTTP 上下文提取（支持
traceparent头）：
确保中间件或请求入口处调用TraceContextPropagator::getInstance()->extract($carrier) - 手动创建 Span 示例：
$span = $tracer->spanBuilder('db.query')->startSpan();<br>$span->setAttribute('db.statement', 'SELECT * FROM users');<br>// ... 执行查询<br>$span->end();
确保 trace_id 全链路透传（PHP 8.5 下特别注意）
PHP 8.5 的异常堆栈增强依赖准确的调用上下文，而上下文必须和 trace_id 对齐。重点检查三个环节：
-
入口层：Nginx 或 API 网关生成
traceparent（W3C 标准），并透传给 PHP；若无网关，可在 PHP 入口（如 index.php）用OpenTelemetry\Trace\TracerProvider::getDefault()->getTracer(...)->startSpan()创建 root span -
出站调用：所有 cURL、Guzzle、Redis 客户端、PDO 封装层，必须在发送前注入
traceparent和tracestate头（OpenTelemetry SDK 可自动完成） - 异步任务：Swoole Task/Worker、Beanstalkd、RabbitMQ 消费者需将当前 span 上下文序列化后随消息传递，并在消费端反序列化恢复
与 PHP 8.5 错误机制联动提升可观测性
利用 PHP 8.5 新增的异常细节，让错误日志自带 trace_id，实现“报错即定位”：
立即学习“PHP免费学习笔记（深入）”；
- 在全局异常处理器中，从当前 span 获取 trace_id：
$traceId = $span->getContext()->getTraceId();<br>error_log("[TRACE={$traceId}] Uncaught exception: {$e->getMessage()}"); - 开启
error_reporting.trace_args=On（php.ini），使堆栈日志包含函数入参，便于复现慢请求中的异常输入 - 对高频非致命错误（如
ValueError），避免直接 throw，改用recordException($e)记录为 Span 事件，减少性能损耗
不复杂但容易忽略：PHP 8.5 的增强能力只有在追踪上下文存在时才能发挥最大价值——没 trace_id，再好的堆栈也串不成链。
