官方PHP镜像（如php:8.3-cli）通常预装Composer，Alpine等精简镜像需手动安装；必须验证composer --version是否生效，构建阶段执行composer install并配置国内镜像源、分层缓存及权限对齐，禁用运行时安装。
容器里跑 composer 脚本不是“能不能”，而是“在哪跑、谁来跑、怎么避免崩”。官方 PHP 镜像（如 php:8.3-cli）已预装 composer，但 Alpine、自建镜像或 CI 环境中常缺失；直接在 ENTRYPOINT 里调用 composer install 属于反模式，构建阶段固化依赖才是正解。
怎么确认容器里真有 composer 命令
别信文档，动手验证。很多镜像标着 “PHP + Composer”，实际只装了 php，没放 composer 可执行文件。
- 先看基础镜像：用
php:8.3-cli或php:8.3-apache一般自带；php:8.3-cli-alpine需手动装，apk add --no-cache composer最快，但版本可能滞后 - 验证方式：运行
docker run --rm php:8.3-cli composer --version，失败就说明没装 - 手动安装推荐脚本方式：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer，确保/usr/local/bin在$PATH里 - Alpine 用户注意：必须先
apk add --no-cache curl openssl ca-certificates，否则 HTTPS 握手失败，报Curl error: SSL certificate problem
composer install 卡在 “Resolving dependencies” 怎么办
这不是 Composer 慢，是它在等网络响应——默认连 packagist.org，国内直连大概率超时或 DNS 解析失败。
- 构建时注入镜像源最稳：
RUN composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/（注意是repos.packagist，不是旧写法repo.packagist） - 临时生效也可加环境变量：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 别依赖宿主机的
~/.composer/config.json：Docker 构建不读这个，必须显式RUN或COPY进去 - 如果还卡，加
-vvv看具体卡在哪一步；常见是 GitHub API 限流，需挂GITHUB_TOKEN环境变量
Dockerfile 里写 RUN composer install 的分层陷阱
顺序错了，缓存全废；参数漏了，镜像不可复现；时机错了，每次改一行代码都重装 vendor。
- 必须把
COPY composer.json composer.lock ./单独成一层，且放在composer install之前——只有这两个文件变，才触发重装 -
RUN composer install必须带这些参数：--no-dev --optimize-autoloader --no-interaction --no-progress，缺一不可 - 别在
COPY . .之后再装依赖：那样只要改一行 PHP，整个 vendor 就重建，构建时间爆炸 - 多阶段构建中，
composer install只能出现在 builder 阶段；最终镜像用COPY --from=builder /app/vendor /app/vendor复制，不带composer二进制和 dev 包
开发时想动态跑 composer 脚本，但 vendor 权限总错乱
宿主机 UID 和容器内用户 UID 不一致，导致挂载进来的 vendor 目录属主是 root 或其他 UID，PHP 进程读不了，Class not found 就来了。
- 开发场景下，**不要挂载整个
vendor目录**：改用只挂载源码（如./src:/app/src），在容器内执行composer install生成vendor - 如果非挂不可（比如 CI 场景），提前在宿主机运行：
chown -R 1001:1001 vendor（假设容器用户 UID=1001） - 更彻底的方案：Dockerfile 里创建统一用户：
RUN useradd -u 1001 -m app && chown -R app:app /app，再USER app - 挂载后记得在容器内补一次：
composer dump-autoload -o，防止类加载路径因文件系统缓存未刷新
真正容易被忽略的点是 config.platform —— 它强制 Composer 模拟某个 PHP 版本解析依赖，一旦和容器真实 PHP 版本不匹配，--no-dev 会失效，或者装出一堆不兼容的包。检查 composer.json 里的 config.platform.php，确保它和你用的 php:8.3-cli 镜像版本一致。
