Composer在Docker中不可用因官方PHP镜像默认未安装，需用curl安装至/usr/local/bin并确保PATH包含；构建时依赖安装慢主因是网络与缓存问题，应优先COPY composer.lock、配置国内镜像源、分层缓存及正确处理权限。
composer 命令在 Docker 容器里执行不了？先确认 PHP 环境和 PATH
直接运行 composer 报 command not found，不是 Composer 没装，而是容器里压根没这个命令。官方 PHP 镜像（比如 php:8.2-cli）默认不带 Composer，得自己装，且必须确保它在 $PATH 里。
- 推荐用
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer安装到全局可执行路径 - 别用
php composer-setup.php装到当前目录，否则每次都要写php ./composer.phar - 如果用 Alpine 镜像，记得先装
curl和openssl：apk add --no-cache curl openssl - 验证是否生效：
docker run --rm php:8.2-cli composer --version—— 这步不通过，后面全白搭
Dockerfile 里写 composer install，为什么总卡在“Resolving dependencies”？
本质是网络 + 缓存问题。Docker 构建时无法复用宿主机的 Composer 缓存，又默认走 packagist.org，国内直连极慢甚至超时。
- 加国内镜像源：构建时用
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停用，现推荐https://mirrors.aliyun.com/composer/） - 更稳的做法是在
composer install前加环境变量：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 避免在
RUN composer install前复制整个vendor/或composer.lock以外的代码 —— 否则每次改一行 PHP 就重装依赖，构建巨慢 - 务必
COPY composer.lock .在COPY composer.json .之后、composer install之前，否则 Composer 会退化成update行为
写一键安装脚本时，composer create-project 总失败？检查权限和工作目录
composer create-project 不是单纯下载 ZIP，它要执行 post-root-package-install 等脚本，还可能生成缓存文件。容器里非 root 用户或挂载卷权限不对，立马报错。
- 脚本开头加
cd /app && mkdir -p var/cache var/log，再跑composer create-project，避免因目录不存在或不可写中断 - 如果用
docker run -v $(pwd):/app，宿主机当前目录属主不是 UID 1001（PHP 容器常用用户），就会Permission denied—— 改用docker run -u $(id -u):$(id -g) -v $(pwd):/app - 别在脚本里写
composer create-project laravel/laravel . --stability=stable，末尾的.在某些 shell 下会被误解析；明确写绝对路径，如/app - 加
--no-interaction和--remove-vcs，跳过交互提示和 .git 目录，适合自动化
CI/CD 流水线里 composer install 很慢？别每次都重装，分层缓存才是关键
Docker 构建缓存失效，根源常在 composer.json 和 composer.lock 的 COPY 时机不对，导致依赖安装步骤无法命中缓存。
- 把
COPY composer.* .放在最前面，紧接着就RUN composer install --no-dev --optimize-autoloader—— 这样只要锁文件不变，这层就复用 - 不要合并写成
COPY . .，否则哪怕改了个 README，整个 vendor 重装 - GitHub Actions 或 GitLab CI 中，可用
cache关键字缓存~/.composer/cache，但注意不同 PHP 版本缓存不通用 - 如果项目用了私有包，记得在
composer install前配置 auth：composer config http-basic.repo.example.com $USERNAME $TOKEN
最常被忽略的一点：本地测试时用 docker build --no-cache 看似“干净”，实则掩盖了缓存逻辑缺陷；真要验证分层是否合理，得删掉中间镜像后反复构建两次，看 install 层是否跳过。
