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