在CircleCI构建链中对Composer install命令进行增量缓存-composer-PHP中文网

circleci中必须只缓存~/.composer/cache路径，因其仅存dist包和元数据，与环境解耦；缓存vendor/会导致autoload错乱，缓存整个~/.composer/则泄露配置和凭证。

在circleci构建链中对composer install命令进行增量缓存

CircleCI里缓存~/.composer/cache到底该挂哪一级路径

必须只缓存 ~/.composer/cache，不能缓存 vendor/，更不能缓存整个 ~/.composer/。前者导致 autoload 错乱，后者会把用户配置、凭证等不该共享的内容也卷入缓存，引发权限或镜像失效问题。

CircleCI 的 save_cache 和 restore_cache 只认路径，不自动识别 Composer 缓存结构。所以你要显式指定：

paths: ["~/.composer/cache"] —— 这是唯一安全且有效的路径
key 必须包含 ${{ checksum "composer.lock" }}，否则 lock 文件一变，缓存就失效
别写成 ~/.composer/cache/files 或 ~/.composer/cache/repo —— Composer 2.2+ 会动态调整子目录结构，硬写死路径容易漏掉校验文件

为什么 composer install --no-dev -o 在 CircleCI 里必须加 --classmap-authoritative

不加 --classmap-authoritative，即使开了 --optimize-autoloader，Composer 仍会在运行时 fallback 到 PSR-4/PSR-0 扫描，这在 CI 构建后打包镜像、再部署到不同环境时，极易因文件系统大小写或符号链接行为差异触发 Class not found。

这个参数强制 autoloader 只信任 classmap，彻底关闭动态扫描。它和 --optimize-autoloader 是配套组合，不是可选项：

composer install --no-dev -o --classmap-authoritative 是生产级 CI 构建的最小安全集
漏掉 --classmap-authoritative，-o 效果打折；漏掉 -o，--classmap-authoritative 无法生成 classmap
某些 Laravel 项目还会额外需要 --apcu-autoloader，但前提是 PHP 已加载 apcu.so 且未设 apc.enable_cli=1

怎么验证 CircleCI 中 Composer 镜像真生效了

执行 composer config -g repo.packagist 输出为空、null 或仍是 https://packagist.org，说明镜像没落到实际运行命令的用户家目录下——这是 CircleCI 里最常踩的坑。

Discussion Composer

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

下载

原因通常是：sudo composer config -g 写进了 root 的 ~/.composer/config.json，而 CircleCI 默认以 circleci 用户运行 job，读不到 root 的配置。

正确做法是：

在 job 的 steps 里，用普通用户身份执行 composer config -g repo.packagist https://mirrors.aliyun.com/composer/
紧接着跑 composer install -vvv | head -n 20，确认日志里出现 GET https://mirrors.aliyun.com/composer/p2/
别依赖 COMPOSER_REPO_PACKAGIST 环境变量——它只影响单次命令，不写入全局 config，缓存复用时会失效

cache key 里除了 composer.lock 还要带什么

只靠 ${{ checksum "composer.lock" }} 不够。Composer 缓存内容受 PHP 版本、扩展开关（如 ext-zip）、甚至 Composer 自身版本影响。同一份 lock 文件，在 PHP 8.1 和 8.2 下生成的 classmap 不兼容。

所以 key 必须拼接多维标识：

composer-cache-v1-{{ checksum "composer.lock" }}-{{ .Environment.PHP_VERSION }}-{{ arch }}
CircleCI 提供 .Environment.PHP_VERSION，但没内置 arch，可用 run: echo "arch=$(uname -m)" >> $BASH_ENV 注入
如果用了自定义 cache-dir（比如挂到 /tmp/composer-cache），key 里还得体现该路径哈希，否则多个 job 并行时可能相互污染

缓存命中的安静，往往掩盖了跨版本复用的风险；真正出问题，是在部署后第一秒 autoload 失败。