composer怎么在无互联网连接时初始化composer项目?

4次阅读

离线执行 composer create-project 失败的核心原因是其强制联网校验仓库元数据,需提前同步完整 packagist 镜像(含 packages.json、分片文件及 dist 包),配置本地仓库路径,禁用插件与脚本,并用分步法(init + 复制 vendor + dump-autoload)替代黑盒命令,同时确保 composer.lock、vendor-dir、cache-dir 严格匹配且可写。

composer怎么在无互联网连接时初始化composer项目?

composer create-project 离线失败的典型表现

执行 composer create-project laravel/laravel myapp 时卡在 “Loading composer repositories”,或报错 Could not fetch https://repo.packagist.org/packages.json —— 这不是配置问题,是 Composer 默认强制联网校验仓库元数据,哪怕本地有缓存也不走离线路径。

提前下载并固化 packagist 镜像到本地

离线可用的前提,是把 Packagist 的完整元数据(packages.json 及其分片)和所有依赖包的 zip/tar 存档提前拉下来。不能只靠 composer install --no-installcomposer dump-autoload,那些不解决初始化源头问题。

  • 在线机器上用 composer archive 或第三方工具如 packagist-mirror 同步全量数据,重点导出:packages.jsonprovider-laravel~framework.json 类分片文件、以及 .zip 包(放在 dist/ 目录下)
  • 把整个镜像目录(比如 /path/to/packagist-offline)拷贝到离线机器
  • 在离线机的 composer.json 中显式指向本地仓库:
    {"repositories": [{"type": "composer", "url": "file:///path/to/packagist-offline"}]}
  • 必须加 --no-plugins --no-scripts,避免插件尝试联网或执行需网络的脚本

用 composer init + 手动 vendor 替代 create-project

composer create-project 是个“黑盒”命令,内部会自动跑 installautoload dump、甚至触发 post-root-package-install 脚本 —— 这些在离线环境大概率失败。更可控的做法是跳过它,分步构造:

  • 先在离线机运行 composer init,手动填包名、描述、依赖(此时不联网,只是生成空 composer.json
  • 把已下载好的 vendor/ 目录(含完整 autoload.php 和所有依赖代码)直接复制进来
  • 运行 composer dump-autoload --classmap-authoritative,确保类映射不依赖文件扫描(否则可能漏类)
  • 验证:php -r "require 'vendor/autoload.php'; echo class_exists('IlluminateSupportStr') ? 'ok' : 'fail';"

为什么 vendor-dir 和 cache-dir 位置很关键

Composer 在离线时仍会尝试写缓存、生成锁文件、检查 vendor 目录结构。如果 vendor/ 不在默认路径,或 COMPOSER_CACHE_DIR 指向了不可写位置,会静默失败或报错 Could not write to /root/.composer/cache

  • 始终用绝对路径设 vendor-dir(在 composer.json 中),避免相对路径在不同工作目录下解析异常
  • 离线机上提前创建好 cache 目录,并用 COMPOSER_CACHE_DIR=/path/to/local/cache 环境变量锁定
  • composer.lock 必须和 composer.json 一起带入离线环境 —— 它记录了确切版本哈希,没有它,install 会拒绝继续

离线初始化最麻烦的不是命令怎么敲,而是「哪些文件算‘足够’」—— packages.json 缺一个分片、vendor 里少一个 autoload_static.php、lock 文件时间戳比 json 新……任何一项不匹配,Composer 就会放弃离线模式,转头去报错。得一个个对着 hash 校验。

text=ZqhQzanResources