不能,Composer原生不支持SVN协议地址作为包源;需在repositories中声明type为"vcs"、url为可checkout的SVN地址,且目标目录必须含合法composer.json。

Composer 能不能直接 require SVN 仓库?
不能。Composer 原生不支持 svn://、https://(SVN over HTTPS)或 file://(本地 SVN)这类 SVN 协议地址作为包源。当你在 composer.json 里写 "vendor/package": "dev-trunk" 并配一个 SVN URL,Composer 会报错:Could not fetch https://svn.example.com/repo, package information was not found —— 因为它根本不会尝试用 SVN 命令去检出。
必须用 Composer 的 VCS Repository + 自定义 type
要让 Composer 拉 SVN 代码,得把它“伪装”成一个合法的 VCS 包源,并显式声明类型为 svn。关键点有三个:
- 在
repositories数组中添加一个type: "package"或更推荐的type: "vcs"条目,且url必须是可被svn命令直接 checkout 的地址(如https://svn.example.com/project/trunk) -
type: "vcs"是必须的,否则 Composer 不会调用svn;type: "package"需手动写完整dist/source,不推荐 - 目标仓库的根目录下**必须存在
composer.json**(不是你项目里的那个),且其中定义了name和version(如"version": "dev-trunk")
示例 repositories 配置:
{
"repositories": [
{
"type": "vcs",
"url": "https://svn.example.com/project/trunk"
}
]
}
require 时怎么指定分支或路径?
SVN 没有 Git 那样的语义化分支名,Composer 对 SVN 的版本约束实际依赖于 SVN URL 的路径结构和 composer.json 中的 version 字段:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 如果 trunk 目录下
composer.json写的是"version": "dev-trunk",就用"vendor/name": "dev-trunk" - 如果想拉 tags/v1.2,URL 应设为
https://svn.example.com/project/tags/v1.2,且该目录下composer.json的version得是"1.2.0"或"v1.2.0" - 不支持
@dev、@stable这类修饰符;也不支持#subpath(SVN 没有子模块路径语法) - Composer 会执行
svn checkout -r HEAD {url},所以确保你有权限且svn命令在$PATH中
常见失败原因和绕过技巧
最常卡在权限、路径和元数据不匹配上:
-
Failed to execute svn --non-interactive info ...:检查系统是否装了 SVN 客户端,以及 URL 是否能被svn info {url}正常访问(尤其注意证书、认证方式) -
Could not find package vendor/name at version dev-trunk:大概率是 SVN URL 对应目录下没有composer.json,或里面缺name/version,或name和你require的不一致 - 想用私有 SVN 但不想暴露密码:用
~/.subversion/auth/缓存凭证,或改用svn+ssh://配密钥 - 实在搞不定 SVN 集成?把 SVN 仓库定期导出为 ZIP,用
package类型 +dist指向公开 ZIP 地址,绕过 SVN 依赖
SVN 支持是 Composer 的遗留能力,文档少、调试信息弱,一旦出问题,第一反应应该是用 svn info {url} 和 cat {url}/composer.json(用浏览器或 curl)手动验证两层可达性。










