容器中不能直接用系统 Composer，因其未预装且包管理器安装的版本老旧不兼容v2 lock文件；应通过官方脚本安装并校验SHA384签名，注意挂载路径、工作目录及用户权限，并利用BuildKit缓存加速构建。
容器里为什么不能直接用系统 Composer
因为官方 PHP 镜像（比如
）默认不带
，它不是 PHP 运行时依赖，而是开发工具。你 exec 进去跑
会报
——这不是环境变量或路径问题，是压根没装。
常见错误：在 Dockerfile 里写
，结果发现 Debian/Ubuntu 仓库里的
包版本老旧（常是 1.x），且不支持
的 v2 格式，后续
直接失败。
正确做法是用官方安装脚本：下载
，设为可执行，全局软链到
别用包管理器装，除非你明确需要旧版且接受兼容性风险
如果项目已用 Composer 2+，容器里必须用 2.2+，否则
会提示 “lock file is not compatible with this version”
Dockerfile 中安装 Composer 的安全写法
重点不是“能不能装”，而是“装得对不对”。官方推荐方式是校验 SHA384 签名，避免中间人篡改。跳过校验（比如只用
）在 CI/CD 或生产镜像中属于安全隐患。
实操建议：
用
最简，但无校验
生产级写法应分三步：
下载 installer、
下载对应 SHA384、
校验、再执行安装
PHP 镜像若基于 Alpine，记得先装
和
（
），否则
命令不存在
容器内运行
composer
install 的权限和路径陷阱
你在宿主机
没问题，进容器却报
或
，大概率是挂载或工作目录错了。
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理，并提供网络代理控制。
下载
关键点：
确保
挂载的是项目根目录（含
），不是子目录
启动容器时加
，否则工作目录可能是
或
，
会找不到配置文件
如果用 root 用户跑容器，
生成的文件属主是 root，宿主机普通用户就删不掉——建议在 Dockerfile 末尾加
，并提前
CI 场景下如何复用 Composer 缓存加速构建
每次
都重装依赖，既慢又浪费带宽。Docker 本身不共享层间缓存给
，因为
是输出，不是输入。
可行解法只有两个：
用 BuildKit 的
：在
指令中挂载缓存目录，例如
把
放到构建阶段末尾，靠 Docker 层缓存：只要
和
没变，整个
层就会被复用
注意：不要在
后
，否则前面的缓存全失效；应先
，再
，最后
缓存是否生效，看
输出里有没有 “CACHED” 字样——没看到，基本就是 COPY 顺序或文件变动导致断了缓存链。
php:8.2-clicomposercomposer --versioncommand not foundRUN apt-get install composercomposercomposer.lockcomposer installcomposer.phar/usr/local/bin/composercomposer installcurl -sS https://getcomposer.org/installer | phpRUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composercurlcurlsha384sum -ccurlopensslapk add --no-cache curl opensslcurlcomposer installPermission deniedCould not open input file vendor/autoload.phpdocker run -v $(pwd):/appcomposer.json-w /app//var/wwwcomposer installvendor/USER 1001RUN groupadd -g 1001 app && useradd -u 1001 -g app appdocker buildcomposer installvendor/--mount=type=cacheRUNRUN --mount=type=cache,target=/root/.composer/cache composer installcomposer installcomposer.jsoncomposer.lockRUN composer installcomposer installCOPY . .COPY composer.* .RUN composer installCOPY . .docker build