直接用官方 composer 镜像即可，无需宿主机 PHP 环境；需挂载当前目录并指定工作目录（-w /app），推荐加 --user $(id -u):$(id -g) 避免 vendor 权限问题，缓存可通过挂载 COMPOSER_CACHE_DIR 复用。
直接在容器里跑 composer 命令行就行，不用装 PHP 环境
官方 composer 镜像（composer:latest）本身是基于 php:alpine 构建的独立可执行镜像，它把 composer.phar 打包进去了，不依赖宿主机 PHP。你不需要自己配 PHP 容器、挂载 vendor、或手动下载 phar 文件。
常见错误是误以为必须先起一个带 PHP 的容器再进去装 Composer —— 其实完全没必要。只要你的项目 composer.json 在本地，就能直接用官方镜像跑安装、更新、dump-autoload 等所有命令。
- 确保当前目录下有
composer.json - 执行：
docker run --rm -v $(pwd):/app -w /app composer install
-
--rm避免残留容器；-v $(pwd):/app把当前目录挂载为/app；-w /app指定工作目录，否则 Composer 会报 “No composer.json found”
composer install 后 vendor 目录权限不对？别硬改宿主机权限
Docker 容器内默认以 root 用户运行 composer，所以生成的 vendor 文件属主是 root，宿主机普通用户无法修改或删除。这不是 bug，是默认行为。强行 chown 宿主机目录风险高（尤其 macOS / Windows），也不符合 Docker 的“一次构建、随处运行”原则。
- 推荐做法：加
--user $(id -u):$(id -g)让容器以当前用户身份运行docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) composer install
- Windows PowerShell 用户注意：
$(id -u)不可用，改用--user 1001:1001（或查 WSL 中的 UID/GID） - 如果项目需要后续在 PHP 容器里加载
vendor，PHP 容器也得用同 UID 启动，否则仍可能因权限被拒
离线场景下如何复用已有的 vendor 或缓存？
官方 composer 镜像默认不持久化缓存，每次运行都重新拉包，CI/CD 或弱网环境会很慢。它支持通过卷挂载 COMPOSER_HOME 来复用缓存，但要注意路径和权限。
- 缓存目录建议挂载到宿主机固定位置，比如
~/.composer-cachedocker run --rm -v $(pwd):/app -v ~/.composer-cache:/tmp/cache -e COMPOSER_CACHE_DIR=/tmp/cache -w /app composer install
-
COMPOSER_CACHE_DIR必须设为容器内路径（/tmp/cache），且与-v映射的目标一致 - 若要跳过平台检查（比如宿主机是 M1 Mac，但目标部署是 x86 服务器），加
--ignore-platform-reqs参数，但仅限测试阶段使用
为什么 composer create-project 在容器里失败？多半是没指定工作目录
这个命令会创建新目录，如果没用 -w 指定容器内工作路径，它会在根目录（/）下尝试写入，而 / 是只读的，报错类似：Could not create directory '/myproject'。
- 正确写法（假设想生成
myproject目录）：docker run --rm -v $(pwd):/host -w /host composer create-project laravel/laravel myproject
- 注意：
-w /host是关键，否则create-project默认在/下操作，失败 - 生成后
myproject目录会出现在当前宿主机目录下，属主由--user决定，不加则为 root
-w 工作目录或 --user 权限映射 —— 这两个参数几乎每次都要带上。 
