不能在容器启动时执行composer install，必须在dockerfile构建阶段完成，否则因php扩展缺失、版本不一致或环境差异，会导致class not found、parseerror或静默失败；应通过多阶段构建、提前copy依赖文件、显式锁定config.platform.php并验证composer show --platform确保环境一致。
不能在容器启动时执行 composer install，必须在 Dockerfile 构建阶段完成安装，否则大概率失败或装出不兼容的包。
为什么 composer install 不能放在 docker run 时执行？
容器启动时 PHP 环境往往不完整：缺 ext-zip、ext-xml、ext-mbstring，甚至没装 unzip 或 git —— 这些都是 Composer 运行依赖。更隐蔽的问题是：composer.lock 在宿主机生成（比如 PHP 8.2），而容器用的是 PHP 8.1，结果 install 虽然成功，运行时却报 ParseError: unexpected token "readonly"。
- 现象：容器启动后
Class not found、require(): failed to open stream、静默跳过 autoload 生成 - 根本原因：构建环境与运行环境 PHP 版本、扩展、
config.platform.php配置不一致 - 风险点：挂载宿主机
vendor/作 volume —— opcache 会拒绝加载跨版本缓存，且权限/UID 不匹配易导致写入失败
多阶段构建中正确安装 vendor/ 的关键步骤
第一阶段负责“编译”依赖，第二阶段只保留运行所需文件。重点不是“怎么写”，而是“顺序和条件”：
- 先
COPY composer.json composer.lock ./，再RUN composer install --no-dev --optimize-autoloader --classmap-authoritative—— 利用 Docker 缓存，改代码不重装依赖 - 第一阶段基础镜像必须带全扩展：
php:8.2-cli比php:8.2-cli-alpine更稳妥（Alpine 下ext-zip需手动编译） - 安装前确认
composer --version可执行：推荐用官方安装命令curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 第二阶段用
php:8.2-fpm-alpine这类精简镜像，COPY --from=builder /app/vendor /app/vendor复制依赖，不复制composer.phar或源码构建工具
config.platform.php 必须显式锁定版本
这是最容易被跳过的一步。即使你用了 PHP 8.2 镜像构建，如果 composer.json 里没设 "config": {"platform": {"php": "8.2.15"}}，Composer 仍可能根据当前环境推测平台能力，装入仅兼容 8.3 的包（比如某些高版本 symfony/console 已弃用 8.2 不支持的语法）。
- 验证方式：构建后进容器执行
composer show --platform，输出应严格匹配你锁死的版本 - 不要依赖
.env或构建参数注入该值 ——config.platform是composer.json的静态声明，必须硬编码 - 若项目需兼容多个 PHP 小版本（如 8.2.x），锁到
"8.2"即可；但严禁锁成"^8.2"或留空
本地开发时如何安全热重载代码？
别把 vendor/ 挂载进来，也别在容器里跑 composer update。正确做法是明确区分“代码”和“依赖”的挂载策略：
- 用 bind mount 整个项目目录：
- .:/app，但通过docker-compose.yml的volumes排除特定路径：- /app/vendor、- /app/composer.lock - 确保容器内
vendor/权限为非 root 用户可读（例如RUN chown -R www-data:www-data /app/vendor），否则 FPM 子进程可能无法加载类 - 如果必须更新依赖，应在宿主机执行
docker run --rm -v $(pwd):/app -w /app composer:2 install --no-dev，再重建镜像 —— 不让开发机环境污染容器
最常被忽略的其实是 config.platform.php 的存在本身——很多人以为“我镜像 PHP 版本对了就万事大吉”，却没意识到 Composer 会按运行时环境反推平台能力，而 lock 文件一旦记录了高版本包，回退就只能删 lock 重生成。
