composer镜像本身不采集span数据，它仅是php依赖管理工具；真正实现链路追踪的是通过composer require引入的sdk（如jukylin/jaeger-php或open-telemetry/opentelemetry-auto-http-async），其span上报依赖显式初始化、正确上下文传播、准确endpoint配置及fpm下实例隔离。
Composer 镜像本身不处理 HTTP 请求，也不运行服务——它只是 PHP 依赖管理工具的可执行二进制包。所以如果你在镜像里“加 OpenTelemetry 追踪”，大概率是在做无用功，甚至会破坏镜像的确定性与安全性。
为什么 Composer 镜像不适合直接接入 OpenTelemetry
OpenTelemetry 的 Trace 必须依附于一个有生命周期、能发起网络调用、能承载 Span 上下文的运行时环境。而 composer 命令行工具：
- 是短生命周期进程（几秒内启动→执行→退出），无法维持 TracerProvider 或 Exporter 连接
- 不监听端口、不接收请求、不传播
traceparent，根本不存在“跨服务链路”的上下文透传场景 - 没有标准的 PHP 运行时扩展加载机制（如
opentelemetry/sdk依赖 Composer 自身安装，会引发循环依赖） - 官方
composer/composer镜像基于alpine或debian-slim，默认不含ext-opentelemetry，也难以安全注入
真正该埋点的位置：用 Composer 构建的 PHP 应用镜像
你真正想追踪的，不是 composer install 这条命令，而是它构建出来的那个 PHP 服务——比如 Laravel API、Swoole 微服务或 Symfony CLI 工具。这时 OpenTelemetry 才有落脚点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
Dockerfile中，RUN composer install后应紧接着RUN pecl install opentelemetry && docker-php-ext-enable opentelemetry（仅限 PHP >=8.1 + ZTS 启用环境） - 确保应用入口（如
public/index.php或 Swooleserver->start()）调用OpenTelemetry\SDK\Trace\TracerProvider::getInstance() - HTTP 入口处必须从
$_SERVER['HTTP_TRACEPARENT']提取并注入上下文，否则所有 Span 都是孤立的 Root Span - 若使用 Swoole 5.0+，优先启用内置支持：
'open_telemetry' => true，避免手动管理 Span 生命周期
常见错误：把 OTel 配置写进 composer.json 或 vendor 目录
这类操作看似“集成成功”，实则埋下三个隐患：
-
composer.json中声明"require": {"opentelemetry/sdk": "^1.12"}会导致vendor/被写入 SDK，但生产镜像通常用--no-dev --optimize-autoloader，SDK 类不会被自动加载 - 在
vendor/内修改autoload.php强行 require OTel 初始化，违反 Composer 的 autoload 隔离原则，且在composer dump-autoload -a后失效 - 误将
OTEL_EXPORTER_OTLP_ENDPOINT等环境变量设在composer config里，实际运行时 PHP 进程根本读不到
真正起效的配置必须落在容器启动阶段：通过 docker run -e OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4317 注入，或在 php.ini 中写死（仅限调试）。Span 的创建、结束、错误标记，全部得由业务代码或框架中间件触发——不是靠 Composer 安装某个包就能自动发生的。
