局域网内搭建Nexus作为Composer私有镜像的步骤-composer-PHP中文网

必须使用nexus 3.68.0+版本，因composer仓库类型自3.45.0起为实验性功能且默认关闭，3.68.0才稳定支持；旧版本（如3.42.0）无composer选项，创建仓库需严格按proxy→hosted→group顺序，并显式启用http端口、禁用packagist.org。

局域网内搭建nexus作为composer私有镜像的步骤

必须用 Nexus 3.68.0+ 版本，低于这个版本根本看不到 composer (proxy) 或 composer (hosted) 选项——不是配置错，是功能压根没加进来。

为什么 Nexus 默认不支持 Composer 仓库？

Nexus OSS 3.x 从 3.45.0 开始把 composer 当作实验性功能引入，但默认关闭；3.68.0 才真正稳定可用。旧镜像（比如 sonatype/nexus3:3.42.0）连创建入口都没有，点开 Create repository 下拉菜单，只有 maven2、npm、raw，没有 composer。

现象：控制台里搜不到 composer，或新建仓库后 composer require 报 Could not parse version constraint
原因：Nexus 不识别 composer 协议路径，本质是没启用该格式支持
验证方式：访问 http://nexus-host:8081/service/rest/beta/formats，看返回 JSON 中是否含 "composer" 字段

创建三类 Composer 仓库的顺序和关键参数

不能跳步，也不能颠倒顺序。proxy → hosted → group 是唯一可行链路，缺一不可。

Discussion Composer

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

下载

composer (proxy)：Remote storage URL 必须填 https://packagist.org（HTTP 会拒绝连接），且要勾选 HTTP port（默认不开启，不勾就 404）
composer (hosted)：Deployment policy 必须选 Allow redeploy，否则上传私有包（如 myorg/my-package）失败；不需要开 HTTP 端口
composer (group)：只用来对外暴露，把前两个拖进去就行；URL 是客户端唯一要配的地址，例如 http://nexus:8081/repository/composer-group/

客户端怎么配才能同时走镜像和私有包？

别只改全局 config，得在项目级 composer.json 里显式声明 repositories，否则私有包找不到，公共包也 fallback 不到镜像。

错误写法：composer config -g repos.xxx http://nexus/... —— 这种全局配置无法区分私有/公共包来源
正确写法：在项目 composer.json 的 repositories 数组里，按顺序放 proxy 镜像 + package 私有定义

示例片段：

"repositories": [
  { "type": "composer", "url": "http://nexus:8081/repository/composer-group/" },
  { "type": "package", "package": { "name": "myorg/my-package", "version": "1.0.0", "dist": { "url": "http://nexus:8081/repository/composer-hosted/dist/myorg-my-package-1.0.0.zip", "type": "zip" } } }
]

容易被忽略的权限和网络细节

很多失败不是逻辑错，而是卡在边界条件上。

Nexus 容器启动时，ports 要映射对：除了 8081（Web UI），proxy 和 hosted 仓库依赖的 HTTP 端口（比如 8082）也得映射出来，否则请求进不来
如果 Nexus 在内网，客户端 PHP 环境要能解析 nexus 域名或 IP；DNS 不通时，composer install 会卡在 DNS lookup
上传私有包用 composer publish 或直接 curl -X PUT 到 hosted 仓库 URL，但必须带 Authorization: Bearer xxx，Nexus 的 Realm 里要激活 Composer Bearer Token Realm