Composer如何用VCS仓库_Composer VCS版本控制仓库教程【速学】-composer-PHP中文网

需在 composer.json 的 repositories 中添加 type: "vcs" 的 git 仓库地址，require 时用 dev-分支名、vtag名或 dev-分支#commit 方式指定版本，并确保仓库根目录有合法 composer.json。

composer如何用vcs仓库_composer vcs版本控制仓库教程【速学】

怎么让 Composer 从 Git 仓库装包而不是 Packagist

Composer 默认只认 packagist.org 上的包，想直接拉私有 Git 仓库或未发布到 Packagist 的开源项目，得手动告诉它“这个仓库能当包用”。核心就一条：在 composer.json 里加 repositories 配置，类型设为 vcs。

必须写全仓库 URL，https:// 或 git@ 都行，但 HTTPS 更稳妥（免 SSH 配置）
URL 要指向仓库根目录，不是某个子路径或网页链接；比如 https://github.com/username/repo ✅，https://github.com/username/repo/tree/main/src ❌
如果仓库没带 composer.json，Composer 会直接报错 Could not find package ... at any version —— 它不关心代码有没有，只认这个文件
私有仓库若需认证，优先走 auth.json 配置 token，别把密码写进 composer.json

require 时怎么指定分支、Tag 或 Commit

VCS 包不走语义化版本号，而是靠 Git 引用解析。Composer 会自动把 dev- 前缀的版本名映射到分支，v1.2.3 映射到 Tag，dev-master 是默认 fallback，但不推荐硬写。

要装 main 分支最新：写 "vendor/name": "dev-main"
要装 v2.1.0 这个 Tag：写 "vendor/name": "v2.1.0"（注意带 v）
要锁定某次提交："vendor/name": "dev-main#abc1234"，其中 abc1234 是 commit hash 前 7 位
别写 dev-master —— GitHub 默认分支早就不叫 master 了，很多仓库是 main 或 trunk，写错就拉不到
如果分支名含斜杠（如 feature/login），必须写成 dev-feature/login，不能省略 dev- 前缀

为什么装完发现 vendor 里没 autoload 或命令失效

VCS 包的加载行为和 Packagist 包完全一致，但容易栽在两个地方：一是仓库里 composer.json 的 autoload 段没配，二是你本地 composer.json 没执行重载。

Discussion Composer

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

下载

检查目标仓库的 composer.json 是否有 autoload（如 "psr-4": {"Vendor\": "src/"}），没有就只能手动 require 文件
改完 repositories 或 require 后，必须运行 composer update vendor/name，不是 install —— install 只读 composer.lock，不会重新解析 VCS 元数据
如果用了 path 类型仓库（本地路径），它不走 Git，但规则一样：目录下必须有合法 composer.json，且 autoload 有效
composer dump-autoload 不解决 VCS 加载问题，它只刷新自动加载映射，前提是包已经成功安装进 vendor

私有 GitLab/Gitee 仓库常见报错和绕过方法

自建或国内平台仓库常因 SSL、API 权限或域名解析失败卡住，错误信息通常是 Failed to clone https://... 或 Could not fetch packages。

GitLab 私有项目必须开启 api scope 的 Personal Access Token，并在 auth.json 里配置：
```
{"http-basic": {"gitlab.example.com": {"username": "token", "password": "xxx"}}
```
Gitee 不支持 composer install 直接走 API，得用 type: "package" 手动声明，再填 dist 下载地址（zip 包）
内网 Git 服务器若用自签名证书，临时加 "secure-http": false 到全局 config（composer config -g secure-http false），但上线前务必关掉
GitHub 私有库若用 SSO，Token 必须勾选 read:packages 和 delete:packages，光有 repo 权限不够

最麻烦的是跨平台镜像同步不及时——比如你刚 push 一个 tag，Composer 却说找不到，其实是因为 Packagist 缓存或平台 Webhook 没触发。这时候别反复重试，先用 composer clear-cache，再确认 tag 确实被平台识别（GitHub 上看 Releases 页面有没有生成）。