如何将一个Subversion (SVN) 仓库作为Composer的依赖源？ (VCS仓库配置)

composer 不原生支持 svn，因内置 VCS 驱动仅含 git、hg、perforce，SvnDriver 自 2.0 起默认禁用且无 tags/branches 可靠解析；应改用 package 类型配 dist 下载或 git-svn 镜像方案。

Composer 本身不原生支持 SVN 作为 VCS 类型，composer.json 中直接写 "type": "vcs" 并指定 SVN URL 会失败——它只识别 git、hg、perforce，但**不包括 svn**。

为什么 composer install 会报 “No driver found to handle VCS repository”？

这是 Composer 在解析仓库类型时的明确拒绝。即使你把 SVN 地址（如 https://svn.example.com/project/trunk）放进 repositories，Composer 也会跳过它，因为内置驱动列表里没有 svn。错误信息通常类似：

Could not fetch https://svn.example.com/project/trunk, enter your password to access it No driver found to handle VCS repository https://svn.example.com/project/trunk

这不是权限或网络问题，而是类型不被支持。

• Composer 的 VCS 驱动硬编码在 src/Composer/Repository/Vcs 下，SvnDriver 类确实存在但**默认禁用**
• 从 Composer 2.0 起，svn 驱动被标记为 @internal，且文档中完全移除说明
• 即便手动启用（如通过插件或 hack composer.json），也缺乏对 tags、branches 的可靠解析支持

替代方案：用 package 类型 + dist 方式接入 SVN 项目

绕过 VCS 驱动限制的可行路径是放弃“自动拉取源码”，改用 "type": "package" 显式声明版本，并提供 dist 下载地址（zip/tar 包）。SVN 服务需支持 !svn/bc 或 export 接口生成归档。

• 确认 SVN 服务器允许导出：访问 https://svn.example.com/project/trunk/?format=zip 或 https://svn.example.com/project/trunk/!svn/bc/12345/ 看是否返回压缩包
• 在 composer.json 的 repositories 中添加 package 条目，必须包含 version 字段（如 "1.2.0"），不能用 dev-trunk 这类别名
• dist 必须含 url 和 type（zip 或 tar），type 错误会导致解压失败

示例配置：

{     "repositories": [         {             "type": "package",             "package": {                 "name": "vendor/svn-package",                 "version": "1.2.0",                 "dist": {                     "url": "https://svn.example.com/project/trunk/?format=zip",                     "type": "zip"                 },                 "autoload": {                     "psr-4": { "Vendor\SvnPackage\": "src/" }                 }             }         }     ],     "require": {         "vendor/svn-package": "^1.2.0"     } }

更现实的选择：用 git-svn 做一层桥接

如果 SVN 项目长期需要 Composer 集成，最稳定的做法不是硬连 SVN，而是用 git-svn 在 github/gitlab 上维护一个镜像仓库。Composer 只认 Git，而 git-svn 可单向同步（或双向，但需谨慎）。

• 初始化镜像：git svn clone https://svn.example.com/project --stdlayout
• 推送到 Git 托管平台后，在 composer.json 中按标准 Git VCS 写法配置："type": "vcs" + "url": "https://github.com/you/svn-mirror.git"
• 后续更新靠定时 git svn rebase && git push，避免直接在 Git 侧提交（否则 svn dcommit 会混乱）

这增加了运维步骤，但换来的是 Composer 全功能支持（版本约束、分支映射、autoload 自动发现等）。

真正卡住的地方往往不是“怎么配”，而是没意识到 Composer 对 SVN 的支持早已退居二线；用 package 类型要自己管版本号和归档链接，用 git-svn 则得接受双仓库同步成本——这两者都不是开箱即用的方案。