容器内composer install默认在/var/www/html/vendor而非项目目录，因未设WORKDIR且未挂载项目路径，Composer将当前路径（如/var/www/html）误判为根目录；须在Dockerfile中明确声明WORKDIR /app并确保该目录含composer.json。
容器内 composer install 为什么总在 /var/www/html/vendor 而不是项目目录？
因为 Docker 容器里没设 COMPOSER_HOME，也没把项目路径挂载为工作目录（WORKDIR），Composer 默认会把当前路径当项目根，而你可能正处在系统级路径下执行命令。
常见错误现象：composer install 成功但生成的 vendor 在 /var/www/html/vendor，而你的 PHP 代码却在 /app；或者 autoload.php 找不到——根本原因是 Composer 没在你预期的项目目录里运行。
- 确保
Dockerfile中用WORKDIR /app明确设置工作目录，且该目录下存在composer.json - 不要在
RUN cd /app && composer install这种写法里依赖 shell 切换——Docker 构建阶段不继承 shell 环境，cd无效 - 如果用多阶段构建，从
composer:latest镜像 COPY 二进制时，也要同步 COPY 全局配置（如需共享 vendor）：COPY --from=composer:latest /usr/bin/composer /usr/bin/composer COPY composer-config.json /root/.composer/config.json
如何让容器内 composer 使用宿主机的 vendor 缓存目录？
不是为了“复用 vendor”，而是避免每次构建都重装依赖——关键是挂载 Composer 的缓存目录，不是 vendor 本身。容器重启后 vendor 仍要重建，但 ~/.composer/cache 复用能极大加速 install 和 update。
- 运行容器时用
-v $(pwd)/.composer-cache:/root/.composer/cache（Linux/macOS）或-v %cd%\.composer-cache:C:\Users\ContainerUser\AppData\Roaming\Composer\Cache（Windows） - 注意：不要挂载
/root/.composer整个目录，否则会覆盖auth.json或自定义config.json - 若用 Docker Compose，写成：
volumes: - "./.composer-cache:/root/.composer/cache"
- 验证是否生效：进容器执行
composer config -g cache-dir，输出应为/root/.composer/cache
容器中配置 path 仓库为什么总是 “Could not find package”？
路径在容器里根本不存在——你写的 "../my-package" 是相对于宿主机的，而容器内没有那个父目录。path 仓库的 url 必须是容器内真实可访问的路径。
- 本地开发时，把所有依赖包目录也挂载进容器：
volumes: - "./packages/my-utils:/packages/my-utils" - "./packages/api-client:/packages/api-client"
然后repositories改成"url": "/packages/my-utils" - 绝对路径在容器里才稳定；相对路径只在构建时有效，运行时容易错位
- 确认挂载后容器内能
ls /packages/my-utils/composer.json；如果报错，说明挂载失败或路径写错 - 别忘了本地包目录必须已
git init && git commit，否则 Composer 直接跳过
如何在容器启动时自动安装并软链 vendor（而非复制）？
默认 composer install 是复制文件，但 path 仓库 + "options": {"symlink": true} 可以让 vendor 目录变成符号链接——前提是容器支持 symlink 且权限足够。
- 在项目
composer.json的repositories条目里加：{"type": "path", "url": "/packages/my-utils", "options": {"symlink": true}} - 容器启动前确保
/packages/...已挂载，且用户有创建 symlink 权限（Linux 下通常没问题；Windows 容器需开启开发者模式或以管理员身份运行） - 启动命令用
composer update --no-interaction，不是install——后者不解析repositories，不会触发 symlink - 验证：
ls -la vendor/acme/my-utils应显示指向/packages/my-utils的箭头；若显示普通目录，说明 symlink 创建失败，检查容器用户权限或 Windows 设置
路径映射和权限问题在容器里比本地更敏感，稍有偏差就会静默跳过配置。最稳妥的做法是：先进容器手动跑一遍 composer update，看报错信息，再反推挂载点或路径是否对齐。
