ThinkPHP集成Pinpoint需借助第三方方案：一、用Pinpoint-PHP Bridge桥接；二、切换为SkyWalking PHP Agent；三、日志桥接写入HBase；四、Nginx+Lua注入Trace上下文。
如果您希望在ThinkPHP应用中实现分布式调用链追踪与性能监控，则需将Pinpoint Agent探针集成到PHP运行环境中。但需特别注意：Pinpoint官方原生仅支持Java应用，不直接支持PHP。因此，ThinkPHP集成Pinpoint必须借助第三方兼容方案或桥接机制。以下是可行的集成路径：
一、使用PHP兼容型APM代理（如Pinpoint-PHP Bridge）
该方案通过独立的Go/Python代理进程接收PHP应用发送的Span数据，并转换为Pinpoint Collector可识别的Thrift协议格式，实现与Pinpoint后端服务对接。
1、在服务器部署pinpoint-php-bridge服务，监听本地UDP端口（如9999）；
2、修改ThinkPHP入口文件（如public/index.php），在Application初始化前注入Span上报逻辑；
立即学习“PHP免费学习笔记（深入）”；
3、使用cURL或socket向localhost:9999发送JSON格式Span数据，包含traceId、spanId、parentSpanId、startTime、endTime、endpoint、serviceType等字段；
4、配置bridge服务将接收到的数据序列化为Pinpoint v2.0+ Thrift结构，并转发至Pinpoint Collector的span.port（默认9996）；
5、确保bridge服务与Pinpoint Collector网络互通，且时钟同步误差小于500ms。
二、切换为支持PHP的Pinpoint兼容APM（如SkyWalking PHP Agent）
该方法规避Pinpoint对PHP无原生支持的限制，改用协议兼容、UI风格近似的开源APM工具，保留Pinpoint式拓扑图与调用链能力，同时获得完整PHP探针支持。
1、下载skywalking-php-agent扩展包（支持PHP 7.4–8.2）；
2、将extension=skywalking.so添加至php.ini，并配置skywalking.collector_backend_services=172.18.0.2:11800；
3、设置skywalking.service_name=thinkphp-app-prod，与Pinpoint Web中Application Name命名规范一致；
4、在ThinkPHP中间件中调用skywalking_start_trace()与skywalking_stop_trace()手动控制Trace生命周期；
5、重启PHP-FPM服务，访问应用接口后，在SkyWalking UI中验证Trace数据是否正常上报并呈现调用链。
三、通过日志桥接方式导入Pinpoint（适用于已部署HBase场景）
该方式不依赖实时探针，而是将ThinkPHP结构化日志（含trace_id、span_id、耗时、SQL、URL等）定时写入HBase对应表（如ApplicationTraceV2），由Pinpoint Web后台读取渲染。
1、在ThinkPHP Log驱动中新增HBaseWriter类，继承think\log\driver\File；
2、重写write方法，将LogRecord按Pinpoint HBase Schema序列化为Put对象；
3、关键字段映射：rowkey = traceId + "_" + spanId，cf:span = json字符串，cf:application = app20171105001；
4、配置HBase Java Client或使用PHP-HBase REST API（需启用HBase REST Server）；
5、确保HBase表ApplicationTraceV2已存在且列族cf定义与Pinpoint Collector写入格式完全一致。
四、利用Nginx + Lua注入Trace上下文（轻量级无侵入方案）
该方法在Web服务器层完成Trace传播，避免修改ThinkPHP代码，适用于无法安装PHP扩展的受限环境。
1、在Nginx配置中启用lua-resty-trace模块；
2、在server块中添加access_by_lua_block，生成traceId并注入请求头X-B3-TraceId；
3、配置proxy_set_header X-B3-TraceId $trace_id; 将上下文透传至后端PHP进程；
4、在ThinkPHP中通过$_SERVER['HTTP_X_B3_TRACEID']获取traceId，并记录到日志或上报至独立采集服务；
5、将采集服务输出的Span数据经格式转换后推送至Pinpoint Collector或NiFi管道进行HBase写入。
