要实现PHP框架HTTP请求响应时间的量化、追踪与告警，需在请求生命周期内注入毫秒级计时点并实时推送至APM；Laravel中通过OpenTelemetry SDK配置TracerProvider、中间件埋点及全局注册实现自动追踪；ThinkPHP6支持构造函数+方法末尾手动埋点；XHProf扩展可进行函数级耗时快照，但全量采集会显著增加CPU开销。
要让PHP框架的每一次HTTP请求响应时间都可量化、可追踪、可告警，必须绕过日志抽样和被动统计，直接在请求生命周期内注入毫秒级计时点，并将数据实时推送至APM后端。这要求监控逻辑与框架中间件深度耦合，且不能因采集导致TPS下降超过5%。
在Laravel中启用OpenTelemetry自动追踪
第一步：安装OpenTelemetry PHP SDK及HTTP导出器依赖：composer require open-telemetry/sdk-contrib-opentelemetry-contrib-otlp-http。
第二步：在bootstrap/app.php顶部添加初始化代码，确保在服务容器启动前完成TracerProvider注册：
use OpenTelemetry\SDK\Trace\TracerProvider;<br>use OpenTelemetry\Contrib\Otlp\OtlpHttpTransport;<br>$transport = new OtlpHttpTransport('http://otel-collector:4318/v1/traces');<br>$provider = new TracerProvider($transport);<br>$provider->addSpanProcessor(new SimpleSpanProcessor($transport));<br>GlobalTracerProvider::set($provider);
立即学习“PHP免费学习笔记（深入）”；
第三步：创建app/Http/Middleware/TraceRequest.php中间件，在handle()开头调用$span = $tracer->startSpan('http.request')，并在finally块中执行$span->end()。注意：若未调用$span->end()，该Span将永远滞留在内存中，【导致内存泄漏】。
第四步：在app/Providers/AppServiceProvider.php的boot()方法中注册中间件到全局栈：$this->app['router']->pushMiddlewareToGroup('web', TraceRequest::class);。
在ThinkPHP6中手动埋点记录关键路径耗时
适用于无法启用自动插桩的老项目或定制化路由场景。只需在控制器方法入口和出口插入两行代码即可获取端到端耗时。
方法一：在控制器构造函数中记录起始时间戳
protected $startTime;<br>public function __construct(){ $this->startTime = microtime(true); }
方法二：在任意操作方法末尾计算并上报
public function index(){<br> $data = $this->service->fetchUserData();<br> $duration = round((microtime(true) - $this->startTime) * 1000, 2);<br> // 上报至StatsD：<br> udp_send("php.tp6.controller.index.duration:{$duration}|ms");<br> return json($data);<br>}
这一步操作起来很简单，直接把udp_send()函数封装成公共助手即可复用。但注意UDP发送不保证送达，高并发下可能丢包——如需强一致性，请改用cURL POST到Prometheus Pushgateway。
配置XHProf扩展实现函数级耗时快照
当需要定位具体哪个方法拖慢了整个请求链路时，XHProf比APM更轻量、更直观，且无需修改业务代码。
① 编译安装xhprof扩展（PHP 8.2+需使用xhprof-ng分支）：pecl install xhprof-ng，然后在php.ini中添加extension=xhprof.so和xhprof.output_dir="/tmp/xhprof"。
② 在入口文件public/index.php顶部加入启动指令：xhprof_enable(XHPROF_FLAGS_NO_BUILTINS | XHPROF_FLAGS_CPU | XHPROF_FLAGS_MEMORY);。
③ 在同一文件底部添加采集与保存逻辑：
$xhprof_data = xhprof_disable();<br>$file = '/tmp/xhprof/' . date('Ymd_His') . '_' . uniqid() . '.xhprof';<br>file_put_contents($file, serialize($xhprof_data));。
④ 使用xhprof_html前端查看分析报告——该目录需通过Web服务器可访问，否则无法渲染火焰图。默认不启用采样模式，【全量采集会显著增加CPU开销】，上线前务必设为XHPROF_FLAGS_SAMPLED并调整采样率。
⑤ 将生成的.xhprof文件拖入https://github.com/perftools/xhgui部署好的界面，即可看到函数调用树与耗时占比。
