离线安装 Composer 需跳过远程请求，依赖已预装的 vendor/ 和 composer.lock；Docker 中应 COPY vendor/ 并修正权限，构建后运行 composer dump-autoload --optimize 生成类映射。
离线安装 Composer 时，composer install 为什么总报 Could not fetch packages
因为默认行为会连 packagist.org 或你配置的镜像源，没网络就卡死。离线前提不是“不联网”，而是让 Composer 完全跳过远程请求——靠本地 vendor/ 和 composer.lock 文件驱动，且所有依赖必须已提前下载好。
实操建议：
- 在有网环境用
composer install --no-dev --prefer-dist装完全部依赖，再把整个vendor/打包带走 -
composer.lock必须随项目一起带入 Docker，它决定了每个包的精确版本和哈希值，缺了就无法校验离线包 - Docker 构建阶段不能执行
composer install（除非挂载本地 vendor），否则每次 build 都会触发网络请求失败
Dockerfile 里怎么安全地复用本地 vendor/
直接 COPY vendor/ 最快，但要注意路径和权限。Docker 默认以 root 运行，而 PHP 应用常以非 root 用户（如 www-data）运行，文件属主不匹配会导致 require(): failed to open stream。
实操建议：
- 构建时先
COPY vendor/ /app/vendor/，再RUN chown -R www-data:www-data /app/vendor - 避免在
composer install后再COPY—— 那样会覆盖掉刚装好的 vendor，白忙一场 - 如果用多阶段构建，第一阶段拉取依赖并导出
vendor/，第二阶段只COPY --from=0 /app/vendor /app/vendor，更干净
composer dump-autoload 在离线环境下要重跑吗
要，而且必须在 vendor 已就位之后、应用启动前运行。离线时虽然不装包，但自动加载映射（vendor/autoload.php）仍需根据当前 vendor/ 结构重新生成，尤其当你用了 PSR-4 映射或 classmap 优化。
实操建议：
- 在 Dockerfile 的最后加一句
RUN cd /app && php composer.phar dump-autoload --optimize - 别漏掉
--optimize，它生成vendor/composer/autoload_classmap.php，能绕过文件系统扫描，提升加载速度 - 如果项目含自定义 autoloader（比如
autoload.files），也得确保对应文件随代码一并进镜像，否则 dump 出来也没用
为什么 composer create-project 在离线 Docker 里根本走不通
因为它本质是先下载 zip 包再解压，全程依赖网络，且会尝试访问 packagist 元数据。离线场景下这个命令毫无意义，等同于强行联网。
实操建议：
- 完全放弃
create-project，改用git clone+ 离线 vendor 方案 - 若必须初始化新项目，就在宿主机跑一次
composer create-project，然后把生成的完整目录（含composer.lock和vendor/）整体 COPY 进镜像 - 注意检查
composer.json里的repositories字段——哪怕只是写了个空数组，也会触发 Composer 去查源，离线时直接报错
最易被忽略的是：vendor/ 里有些包会自带 bin/ 脚本或 install 钩子（比如 symfony/flex），它们可能在 install 时执行 shell 命令或读取环境变量。离线打包前，务必确认这些钩子已在有网环境完整跑过，否则进 Docker 后不会补跑，功能就残了。
