jukylin/jaeger-php拉取失败主因是Packagist元数据同步延迟、GitHub Releases国内CDN不稳定及默认不接受dev版本；需通过自定义repositories指向可控ZIP源，并分步执行minimum-stability配置与require命令。
PHP 项目里装 jukylin/jaeger-php 失败，大概率不是包本身有问题，而是 Composer 默认源拉取慢或超时导致的“拉取难”——尤其在 CI/CD 环境或国内网络下。
为什么 jukylin/jaeger-php 经常拉不动？
这个包本身是开源、轻量、无复杂依赖的，但它的发布包托管在 GitHub Releases，而 Composer 默认通过 Packagist.org 解析元数据后，再从 GitHub 下载 ZIP 包。问题就出在这两步：
- Packagist.org 的元数据同步有延迟（尤其 dev 分支），
composer require jukylin/jaeger-php可能报Could not find package或no matching package found - GitHub Releases 的 CDN 节点在国内访问不稳定，下载 ZIP 时经常卡在
Downloading...或直接 timeout - 未配置
minimum-stability时，Composer 默认不接受dev版本，而该包最新功能（如 OpenTelemetry 兼容层）只在dev-main分支提供
绑定专属 APM 镜像：三步搞定拉取
不用换源、不用科学上网，直接让 Composer 从你可控的镜像地址拉取 —— 关键是把 GitHub Releases 的 ZIP 下载代理到国内可稳定访问的 CDN 或私有对象存储。
- 在项目根目录创建
composer.json（若无），添加自定义仓库配置：{ "repositories": [ { "type": "package", "package": { "name": "jukylin/jaeger-php", "version": "dev-main", "dist": { "url": "https://your-cdn.example.com/jukylin-jaeger-php-dev-main.zip", "type": "zip" }, "autoload": { "psr-4": { "Jaeger\": "src/" } } } } ] } - 确保该 ZIP 包内容与官方
dev-main分支一致（可用git archive --format=zip HEAD | sha256sum校验），并上传至你的 CDN 或私有 OSS - 执行：
composer config minimum-stability dev composer require jukylin/jaeger-php:dev-main --no-update composer update jukylin/jaeger-php
注意必须分步执行，否则 Composer 仍会尝试走默认源
CI/CD 中如何稳定复用？
在 GitHub Actions / GitLab CI 等环境中，不能每次手动上传 ZIP。推荐做法是用构建脚本自动抓取并缓存：
- CI 启动时运行 shell 脚本：
curl -L https://github.com/jukylin/jaeger-php/archive/refs/heads/main.zip -o jaeger-php-main.zip # 上传到内部对象存储，生成固定 URL upload_to_oss jaeger-php-main.zip jukylin-jaeger-php-dev-main.zip
- 把生成的 URL 写入
composer.json的repositories字段（可用sed替换模板） - 关键点：
composer install前必须确保composer.json已更新且不含"packagist.org": false这类全局禁用配置——否则会连monolog/monolog等基础依赖都拉不到
真正卡住的从来不是 initTracer() 调用失败，而是 composer require 这一步根本跑不完。镜像不是“加速”，而是把不可控的 GitHub 下载变成你可控的 HTTP GET，这才是 PHP 微服务链路追踪落地的第一道门槛。
