Composer解析path类型仓库时，基于主项目composer.json所在目录处理相对路径，支持绝对路径和glob模式（2.0+），如"../my-package"指向同级目录，通配符可匹配多个包，需确保路径存在、权限正确且大小写匹配，避免跨驱动器问题，团队协作应统一结构，调试可用composer show -v查看映射。
Composer 在处理 path 类型仓库时，会将本地文件系统路径映射为一个可安装的包。这种机制常用于开发阶段，允许你在本地测试尚未发布到 Packagist 的包。关于相对路径的解析，Composer 有一套明确的规则来确保路径正确指向目标目录。
path 类型仓库的基本配置
在 composer.json 中添加本地路径仓库的方式如下：
{
"repositories": [
{
"type": "path",
"url": "../my-package"
}
],
"require": {
"my/package": "*"
}
}
这里的 url 可以是相对路径或绝对路径。Composer 会根据主项目根目录解析相对路径。
相对路径的解析逻辑
Composer 解析 path 仓库中的相对路径时，遵循以下原则：
- 相对路径基于主项目的
composer.json所在目录进行解析 - 路径不支持
~或环境变量（如$HOME） - 符号链接（symlink）会被正常处理，但需注意操作系统权限和配置
- 路径末尾是否带斜杠不影响解析结果
例如，若主项目位于 /var/www/project，配置了 "url": "../my-package"，则实际指向 /var/www/my-package。
通配符与 glob 支持
从 Composer 2.0 开始，path 仓库支持 glob 模式匹配：
{
"repositories": [
{
"type": "path",
"url": "../packages/*"
}
]
}
这会扫描所有匹配的目录，并自动识别其中符合 Composer 包结构的项目。每个子目录必须包含有效的 composer.json 文件。
常见问题与注意事项
使用相对路径时容易遇到以下情况：
- 路径不存在或无读取权限：Composer 会跳过该仓库并提示警告
- 跨驱动器路径（Windows）：确保路径在同一磁盘卷下，否则可能无法访问
- 大小写敏感性：Linux/macOS 系统区分大小写，路径必须完全匹配
- 性能影响：大量使用 glob 或深层嵌套路径可能导致加载变慢
建议在团队协作环境中统一项目结构，避免因路径差异导致依赖解析失败。
基本上就这些。只要路径能被正确解析且目标目录包含有效包信息，Composer 就能正常工作。调试时可用 composer show -v 查看具体路径映射情况。
