如何离线使用Composer工具（离线模式）-composer-PHP中文网

离线安装 composer 需先在同 php 版本的联网机下载并校验 installer，生成 composer.phar 后拷贝至离线机；部署项目依赖须同步 vendor/、composer.json 和 composer.lock，并用 composer_disable_network=1 执行 install。

如何离线使用composer工具（离线模式）

离线安装 Composer 本身要分两步走

离线环境里不能直接运行 curl -sS https://getcomposer.org/installer | php——这条命令会立即失败，报错 curl: (7) Failed to connect to getcomposer.org port 443。Composer 不是单个二进制文件，它依赖 PHP 运行时和网络校验，必须先在联网机器上生成带哈希校验的 composer.phar，再拷过去。

关键步骤顺序不能错：

在与目标机相同 PHP 版本的联网机器上执行：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
用官网当前最新 SHA384 哈希值校验（不是固定值，每次更新）：php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f6a331a8365dfe33b4d8d826ad669113f128fd004e28787949af298b') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); exit(1); }"
执行安装：php composer-setup.php
清理临时文件：php -r "unlink('composer-setup.php');"
把生成的 composer.phar 拷到离线机，加执行权限：chmod +x composer.phar，建议软链到 /usr/local/bin/composer

别用 apt install composer 或 yum install php-composer：这些包管理器装的版本老旧，不兼容 PHP 8.2+ 新特性，且默认不带 --no-plugins 等离线关键参数。

离线部署项目依赖只认 vendor/ + composer.lock 组合

离线机上运行 composer install 报错 Could not find package，基本是因为缺 composer.lock 或它内容不全。没有 lock 文件，Composer 就不知道该装哪个 exact commit 和 sha256，根本没法跳过网络。

正确做法是：在联网机上完整跑一遍 composer install --no-dev --prefer-dist --optimize-autoloader，确保所有包以 ZIP 形式下载并解压，然后把整个 vendor/ 目录连同 composer.json 和 composer.lock 一起打包拷过去。

离线机执行时必须加环境变量兜底：COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-dev。这个变量比 --offline 更彻底——后者只拦 HTTP 请求，而 COMPOSER_DISABLE_NETWORK=1 会让任何可能触发 DNS 解析或 curl_init 的地方直接 abort。

常见坑：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

vendor/ 目录里有 symlink（比如 Laravel 的 public/vendor），离线机文件系统不支持或挂载为只读，导致 autoload 失败
某包含 post-install-cmd 脚本（如 php artisan clear-compiled），没关 --no-scripts 就会卡住
composer.lock 是从另一台机器生成的，但 PHP 版本低了 0.1（如源机 8.2.12，离线机 8.2.11），某些平台约束校验直接失败

想在离线机上新增包？改用 path 类型仓库

composer update 在离线环境下几乎必然失败，哪怕你配了本地 repo——因为它默认仍会尝试 fallback 到 packagist.org 获取元数据。想加新包，唯一可行路径是 path 类型仓库。

操作分两步，缺一不可：

在项目 composer.json 的 repositories 字段里声明：{"type":"path","url":"./packages/my-utils"}，注意路径必须是相对路径或绝对路径，且该目录下要有含 name 和 version 的有效 composer.json
执行 composer require my-vendor/my-utils:dev-main@dev，版本号必须和本地包里的 version 或分支名严格一致；如果没设 "minimum-stability": "dev"，@dev 后缀不能省

别指望 composer require xxx --no-update 能离线工作：它只是不跑 update 流程，但仍会尝试解析远程包信息，网络不通就报错。path 仓库才是真·零网络依赖。

为什么 vendor 直接复制有时会失败

看似最简单的方案——把 vendor/ 整个目录拷过去——其实对环境一致性要求极高。失败不是因为复制错了，而是因为底层 ABI 或扩展行为不匹配。

必须检查三件事：

PHP 小版本是否完全一致（如 8.2.12 vs 8.2.11）：opcache 编译产物、某些扩展的内部结构（如 ext-zip 的压缩流处理）可能不兼容
关键扩展是否齐全：ext-zip（解压 dist 包必需）、ext-openssl（验证签名）、ext-mbstring（autoload 路径解析）缺一不可
Composer 版本是否对齐：composer --version 查看，旧版 Composer 生成的 installed.json 格式，新版可能读取失败

如果不确定，别直接运行应用，先在离线机上执行：php -r "require 'vendor/autoload.php'; var_dump(class_exists('Monolog\Logger'));"。返回 bool(true) 才算真正可用——否则后续任何 Class not found 错误，都不是 Composer 的问题，而是环境没对齐。