composer如何使用本地缓存安装依赖？

composer install 总是重新下载包是因为默认缓存未启用或失效，需检查缓存路径权限、禁用–no-cache、确保prefer-dist模式及清除损坏缓存。

composer install 为什么总是重新下载包？

因为默认不启用本地缓存，每次 composer install 都会从远程仓库拉取 ZIP 或通过 git 克隆，尤其在 CI/CD 或多项目开发时明显变慢。Composer 其实自带缓存机制，但需要确认是否启用、路径是否可写、缓存是否被绕过。

• 检查是否启用：composer config --global cache-dir 查看路径，确保该目录存在且当前用户有读写权限
• 常见坑：docker 容器内未挂载缓存目录，或 CI 环境清空了 $HOME 导致全局配置丢失
• 如果用 --no-cache 参数（比如某些 CI 脚本硬编码），缓存会被强制禁用，需删掉该参数

如何让 composer 使用本地已有的 vendor 包？

Composer 不支持直接复用其他项目的 vendor/ 目录，但可通过 composer install --prefer-dist + 缓存机制实现“本地已有就跳过下载”。前提是包以 dist 方式安装（即 ZIP 归档），而非 source（Git 克隆）。

• --prefer-dist 是默认行为，但某些 composer.json 中写了 "preferred-install": {"*": "source"}，会绕过缓存，需删掉或改为 "dist"
• 缓存命中条件：包名 + 版本号 + dist URL 的 SHA256 值一致；若 packagist.org 上包更新了 ZIP URL，旧缓存失效，会重新下载
• 手动验证缓存是否生效：运行 composer install -v，看到 Downloading <code>xxx.zip from cache 行才表示真用了缓存

缓存路径被占用或磁盘满导致失败怎么办？

缓存写入失败时，Composer 通常静默降级为直连下载，不会报错，但你会感觉“缓存没起作用”。真实错误藏在 verbose 日志里，比如 Failed to create cache Directory: /home/user/.composer/cache/files。

• 检查磁盘空间：df -h $(composer config --global cache-dir)
• 修复权限：chown -R $USER:$(id -gn) $(composer config --global cache-dir)
• 临时换路径（如 CI 中）：composer config --global cache-dir /tmp/composer-cache，但注意 /tmp 可能被定时清理
• 清除损坏缓存：composer clear-cache，它会删掉所有内容并重建目录结构

在 Docker 或 CI 中稳定启用缓存的关键点

Docker 构建层默认不保留缓存目录，CI 工作流也常重置环境变量，导致 Composer 每次都从零开始。必须显式挂载或配置。

• Dockerfile 中不要用 RUN composer install 单独一层，应把 composer.json 复制后立即运行 install，并确保缓存目录在构建阶段可用（例如用 --cache-dir 指向 /tmp/cache）
• github Actions 示例片段：composer config --global cache-dir $HOME/.composer/cache 必须在 run 步骤中执行，不能只靠 setup-php action 默认配置（某些版本不自动启用）
• 私有包场景下，若用 repo.packagist.com 类型仓库，缓存仍有效；但若用 path 仓库类型（本地文件路径），则完全不走缓存逻辑

缓存不是开关一开就万事大吉的事，它依赖路径可达性、磁盘状态、安装方式和网络响应一致性——任一环节断开，Composer 就默默切回“无缓存模式”，而你可能根本没意识到。