配置 path 类型仓库指向本地包目录，2. 确保本地包有正确 name 字段的 composer.json，3. 运行 composer require 安装，支持软链接或复制，4. 建议用相对路径并统一开发环境，完成后可迁移至私有仓库。
在使用 Composer 安装本地路径的包时，可以通过配置 path 类型的仓库来实现。这种方式适合开发中的私有包或尚未发布到 Packagist 的本地组件。
1. 配置本地路径仓库
在项目的 composer.json 文件中添加一个类型为 path 的仓库，指向本地包所在的目录：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package/"
}
],
"require": {
"my-vendor/my-local-package": "*"
}
}
其中：
-
../my-local-package/是本地包的相对或绝对路径。 -
my-vendor/my-local-package必须与本地包的name字段一致（即其 composer.json 中定义的包名）。
2. 确保本地包有正确的 composer.json
被引用的本地包必须包含一个有效的 composer.json 文件，例如：
{
"name": "my-vendor/my-local-package",
"version": "1.0.0",
"autoload": {
"psr-4": {
"MyVendor\MyLocalPackage\": "src/"
}
}
}
3. 安装包
运行以下命令安装包：
composer require my-vendor/my-local-package
Composer 会从指定的本地路径软链接（symlink）或复制文件到 vendor 目录。
注意：如果系统支持符号链接，Composer 默认会创建 symlink；否则会复制文件。可通过以下方式强制使用 symlink：
<pre class="brush:php;toolbar:false;">"repositories": [
{
"type": "path",
"url": "../my-local-package/",
"options": {
"symlink": true
}
}
]
4. 开发调试建议
- 使用相对路径便于团队协作。
- 确保本地包路径在所有开发环境中都有效。
- 开发完成后，可将包发布到私有仓库或 Packagist，并移除 path 配置。
