Composer怎么安装OpenTelemetry PHP_Composer如何引入open-telemetry接入分布式链路追踪【教程】-composer-PHP中文网

根本原因是php版本低于8.1或缺少ext-grpc/ext-curl扩展，需升级php、安装对应扩展，并确认otlp端点与collector监听地址一致，同时严格管理span生命周期。

composer怎么安装opentelemetry php_composer如何引入open-telemetry接入分布式链路追踪【教程】

composer require 装不上 `open-telemetry/opentelemetry` 怎么办

根本原因不是包不存在，而是 PHP 版本或 Composer 配置拦住了。官方 open-telemetry/opentelemetry 包最低要求 PHP 8.1，且依赖 ext-grpc 或 ext-curl（后者仅限部分 exporter）。如果你用的是 PHP 7.4 或 8.0，composer require 会静默失败或报 Your requirements could not be resolved。

先运行 php -v 确认版本，低于 8.1 就得升级 PHP，别试降级包版本——PHP-SDK 没有向下兼容分支
检查扩展：php -m | grep -E 'grpc|curl'；没 grpc 的话，OTLPExporterHttp 可用，但 OTLPExporterGrpc 会直接报 Class "OpenTelemetry\Contrib\Grpc\Exporter" not found
如果启用了 Composer 的 minimum-stability 为 stable（默认），而当前只有 dev-main 或 beta 版本，需显式指定：composer require open-telemetry/opentelemetry:dev-main

引入后调用 `TracerProvider::getInstance()` 报错 Class not found

这不是漏装包，是自动加载没触发或命名空间写错。PHP SDK 不提供全局函数，所有类都严格按 PSR-4 规范组织，且入口类不在顶层命名空间。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

确保已执行 composer dump-autoload -o，尤其在手动改过 composer.json 后
TracerProvider 在 OpenTelemetry\SDK\Trace 命名空间下，必须 use OpenTelemetry\SDK\Trace\TracerProvider;，不能只写 use TracerProvider;
常见手误：TracerProvider::get_instance()（下划线）——实际是 getInstance()（驼峰），PHP 会报 Call to undefined method
若用 Laravel/Symfony，别在配置文件里直接 new 实例；SDK 初始化必须在 request 生命周期早期完成，否则 tracer 可能为 null

链路数据发不到 Jaeger / OTLP 后端，`OTLPExporterHttp` 一直超时

Exporter 默认走 http://localhost:4318/v1/traces，但这个地址既不等于 Jaeger 的 UI 端口（16686），也不等于其 collector 端口（14250/14268），更不是 Prometheus 的 endpoint。配错就是“没数据”，且无明显报错。

Jaeger 需额外启动 jaeger-collector 并暴露 OTLP HTTP 接口：启动命令加 --otlp.http.host-port=:4318
用 curl -v http://localhost:4318 能返回 404 是正常的（说明服务起来了）；返回 connection refused 才是没跑起来
OTLPExporterHttp 默认禁用 SSL，如果后端强制 HTTPS，要传 ['endpoint' => 'https://...'] 并确保 PHP 支持 TLS 1.2+
别忽略环境变量：OTEL_EXPORTER_OTLP_ENDPOINT 会覆盖代码中传的 endpoint，调试时先 unset OTEL_EXPORTER_OTLP_ENDPOINT

手动创建 `Span` 没出现在追踪视图里

Span 必须被 Tracer 显式启动、结束，并且所属的 TracerProvider 得提前注册了 Exporter。漏任一环，Span 就进内存然后被 GC 掉，日志里也不会提醒。

必须调用 $span->end()，不能只靠析构函数——PHP 的 GC 不保证及时性，未 end 的 Span 不会被导出
确认 TracerProvider::getInstance() 返回的对象已调用 addSpanProcessor()，例如：new SimpleSpanProcessor(new OTLPExporterHttp())
Span 名称别用空格或控制字符，Jaeger UI 会过滤掉异常名称；建议用 user.login 这种点分格式，别用 用户登录
如果用 Swoole 或 Hyperf，注意协程上下文：Span 默认绑定到当前协程，跨协程传递需用 Context::withValue() + Context::current()，否则子协程里 getActiveSpan() 是 null