composer安装时注入opentelemetry sdk需通过自定义plugininterface在activate()中初始化，依赖iointerface输出日志；须用otel_exporter_otlp_endpoint指定地址、禁用otel_php_autoload_enabled；span需显式end()，上报前调用shutdownhandler::shutdown()确保完成。
Composer安装时如何注入OpenTelemetry SDK
Composer本身不支持插件式埋点，无法直接调用opentelemetry-sdk-php的Tracer API。必须通过自定义PluginInterface实现钩子，且只能在activate()阶段初始化SDK——因为Composer\IO\IOInterface此时才可用，而TracerProvider依赖IOInterface输出调试日志（否则会静默失败）。
关键点：
- SDK初始化必须放在
PluginInterface::activate()里，不能放__construct()或getSubscribedEvents() - 使用
OTEL_EXPORTER_OTLP_ENDPOINT环境变量指定Collector地址，避免硬编码 - 禁用
OTEL_PHP_AUTOLOAD_ENABLED，否则Composer autoload机制会与SDK冲突导致Class not found
如何拦截Composer下载行为并创建Span
Composer的包下载由Composer\Downloader\DownloadManager统一调度，但该类未暴露事件钩子。唯一可行路径是通过RepositoryManager::getRepository()获取Pool后，重写Package的getDistUrl()方法，或更稳妥地——在DownloadManager::download()被调用前，用Composer\EventDispatcher\EventDispatcher监听PRE_INSTALL_CMD和PRE_UPDATE_CMD，再用ReflectionClass临时替换DownloadManager::download()为带Span包装的代理方法。
实操建议：
- 不要尝试hook
file_get_contents()或cURL，Composer内部大量使用StreamContext和ZipArchive，底层调用链太深 - Span名称应设为
composer.download.package，并添加package.name、package.version、dist.type（zip/tar）作为属性 - 务必调用
$span->end()，否则Span不会上报；异常时需显式设置status为STATUS_ERROR
为什么vendor目录扫描会导致Span丢失
Composer执行dump-autoload阶段会扫描vendor/下所有PSR-4/PSR-0映射，这个过程由Composer\Autoload\ClassMapGenerator触发，它绕过EventDispatcher，直接调用file_get_contents()读取PHP文件。此时OpenTelemetry的全局Hook（如otlp_exporter）尚未激活，Span Context无法传播。
解决办法只有两个：
- 在
POST_AUTOLOAD_DUMP事件中手动创建Span，记录classmap.generate耗时，但无法关联到具体包 - 改用
Composer\Script\Event在post-autoload-dump脚本里上报，代价是丢失调用链上下文（parent Span ID为空）
本质上，Composer的autoload生成是纯I/O密集型操作，不属于“下载”范畴，强行追踪反而污染Trace数据。
OTLP exporter配置常见失败点
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf在Composer环境下大概率失败，因为http/protobuf依赖ext-curl且要求HTTP/2支持，而多数CI环境（如GitHub Actions默认Ubuntu镜像）的curl版本低于7.68，不支持HTTP/2 ALPN协商。
稳妥方案：
- 强制设为
OTEL_EXPORTER_OTLP_PROTOCOL=http/json，兼容性更好 - 设置
OTEL_EXPORTER_OTLP_TIMEOUT=10，避免网络抖动导致Composer卡死 - 禁用
OTEL_TRACES_SAMPLER（保持默认parentbased_always_on），否则composer install --no-interaction模式下因无父Span而采样率为0
真正难的是让Span在composer install进程退出前完成上报——必须调用ShutdownHandler::shutdown()，且不能依赖register_shutdown_function()（Composer会提前清空该队列）。
