Composer如何使用Artifact_Composer本地压缩包安装方式【必看】-composer-PHP中文网

必须用 artifact 类型仓库配置本地 zip 包，zip 文件名、内部 composer.json 的 name/version 字段三者须字面完全一致，且需禁用 packagist.org 才能离线安装成功。

composer如何使用artifact_composer本地压缩包安装方式【必看】

直接用 composer install 装本地 ZIP 包，必须配 artifact 类型仓库，且 ZIP 文件名、内部 composer.json、require 版本三者必须字面完全一致，否则静默跳过或报 Could not find package。

artifact 仓库配置必须写对路径和类型

在项目根目录的 composer.json 中加 repositories 块，type 必须是 artifact，url 是 ZIP 所在**目录的路径**（不是 ZIP 文件本身），且末尾不能加 /：

url 推荐用绝对路径（如 /opt/myproject/artifacts），避免 CI 或不同用户执行时因相对路径错位失效
写成 "url": "file:///path/to/zips" 或 "url": "./zips/"（带斜杠）会触发路径解析异常，某些 Composer 版本直接忽略该仓库
目录必须真实存在、PHP 进程可读（Linux 下注意 www-data 或 php-fpm 用户权限）
不能嵌套子目录：所有 ZIP 必须平铺在 url 指向的目录下，不支持 ./zips/monolog/monolog-3.5.0.zip

ZIP 文件命名和结构有硬性要求

Composer 不会解压并扫描内容来猜包信息，它靠文件名初步筛选，再校验 ZIP 内部 composer.json。错一个就找不到：

Discussion Composer

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

下载

文件名格式必须为 vendor/name-version.zip（注意是 /，不是 - 或 \），例如 monolog/monolog-3.5.0.zip
ZIP 解压后，composer.json 必须在根目录（不能是 monolog-monolog-3.5.0/composer.json）
composer.json 中的 name 字段（如 "monolog/monolog"）和 version 字段（如 "3.5.0"）必须与文件名中对应部分**完全一致**（大小写、有无 v 前缀、是否含 -beta1 等）
不支持 .tar.gz 在 Windows 下稳定解压，统一用 .zip

必须禁用 packagist.org 否则仍会联网

哪怕你配了 artifact，只要 packagist.org 还开着，Composer 默认优先查线上源——哪怕本地 ZIP 已存在，它也会先尝试回源，失败才 fallback，导致离线失败：

在 repositories 数组最顶部加 {"packagist.org": false}
不要只依赖 COMPOSER_DISABLE_NETWORK=1，它是兜底手段，不能替代显式禁用默认源
运行 composer show -s 确认输出里没有 packagist.org，才算生效
如果之前跑过 composer install，缓存可能干扰判断，加 --no-cache 重试

安装命令和版本写法不能错

artifact 不做版本约束解析，只做精确匹配。你写的版本号必须和 ZIP 文件名里的版本一模一样：

运行 composer require vendor/name:1.2.3，不是 ^1.2 或 *（后者不支持）
如果 ZIP 是 acme/utils-2.1.0.zip，composer.json 里 require 必须写 "acme/utils": "2.1.0"，写成 "2.1" 或 "v2.1.0" 都会失败
首次安装建议用 COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts，跳过远程校验和脚本执行，直奔本地 ZIP
改过 ZIP 后，必须删掉 vendor/ 和 composer.lock，再重新 install，否则旧 lock 会锁住旧 dist URL