官方 Composer 镜像可直接运行，无需本地 PHP 环境，但需挂载工作目录并用 --user 指定 UID/GID 避免 vendor/ 属主为 root；缺失扩展时优先 --ignore-platform-req，必要时改用带扩展的 PHP 镜像手动安装 Composer。
可以直接用官方 composer 镜像运行，无需本地 PHP 环境，但必须注意工作目录挂载和用户权限问题。
用 composer 官方镜像快速执行命令
官方镜像 composer（即 docker.io/composer）已预装 Composer 和兼容的 PHP 运行时，适合一次性命令场景。它不依赖宿主机 PHP，但默认以 root 用户运行，容易导致生成文件属主为 root。
- 基础命令格式：
docker run --rm -v $(pwd):/app -w /app composer install
- 指定 Composer 版本（如 2.5.8）：
docker run --rm -v $(pwd):/app -w /app composer:2.5.8 update
- 传入 auth 参数（如私有包 token）：
docker run --rm -v $(pwd):/app -v ~/.composer/auth.json:/root/.composer/auth.json -w /app composer config -g github-oauth.github.com abc123
为什么 composer install 生成的 vendor/ 文件属主是 root？
因为容器内默认以 UID 0（root）运行，挂载到宿主机后，vendor/ 目录及其内容全部归 root 所有，后续用本地编辑器或 CLI 工具操作会提示权限拒绝。
- 解决办法：用
--user参数映射当前用户 UID/GID：docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) composer install
- Mac 上若遇
id: unknown user错误，改用$(id -u):$(id -g)的数值形式（如501:20） - Windows WSL2 下推荐直接用 WSL 内的 UID/GID，避免 Windows 文件系统权限透传异常
需要自定义 PHP 扩展（如 ext-zip）怎么办？
官方 composer 镜像不含扩展，遇到 Your requirements could not be resolved 且提示扩展缺失时，不能简单换 PHP 镜像——Composer 本身不执行 PHP 代码，但某些包的 require-dev 或脚本（如 post-install-cmd）可能触发扩展检查。
立即学习“PHP免费学习笔记（深入）”；
- 优先尝试跳过平台检查：
docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) composer install --ignore-platform-req=ext-zip
- 若必须启用扩展（例如运行
phpunit前需ext-dom），则改用带扩展的 PHP 镜像 + 手动安装 Composer：docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) php:8.2-cli docker-php-ext-install zip && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer && composer install
最常被忽略的是 --user 参数和 -w /app 的组合——漏掉 -w 会导致 Composer 在容器根目录执行，挂载卷形同虚设；漏掉 --user 会让 vendor/ 变成只读陷阱。这两处出错，90% 的人会回头去查“为什么 vendor 没生成”或“为什么 chmod 不生效”。
