Composer 的 path 类型仓库是本地开发私有包最直接、最轻量的方式，通过配置 repositories 指向本地路径并设 "symlink": true 实现改即生效；需确保路径正确、name 匹配、权限正常。
Composer 的
类型仓库是本地开发私有包最直接、最轻量的方式——它让 Composer 把本地文件夹当作一个可安装的包源，无需每次改完代码都重新打包、推送、更新版本号，真正实现“改即生效”。
配置 path 仓库的基本结构
在项目根目录的
中添加
配置，指向你本地包的路径：
注意两点：
-
是相对于当前
文件的路径，支持相对路径（推荐）或绝对路径；
- 包名（
）必须与被引用包自身
中的
字段完全一致；
- 版本约束写
即可，Composer 会自动识别该路径下
中的
或使用
（若为分支）。
启用 symlink 模式提升开发体验
默认情况下，Composer 会把本地包复制进
，改代码后需手动重新 install。开启
后，Composer 直接创建符号链接，编辑本地源码立刻反映到项目中：
在
条目中增加
；
确保你的系统支持符号链接（Linux/
mac
OS 默认支持，Windows 需启用开发者模式或以管理员运行终端）；
执行
触发重链接（首次安装也生效）。
验证是否成功：进入
，用
（macOS/Linux）或
（Windows）查看是否为链接而非普通文件夹。
配合 autoload-dev 和脚本快速调试
本地包常需独立测试，建议在它的
中合理配置：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
声明测试类路径，如
；
加入一键命令，例如
；
主项目中无需额外操作——因为 symlink 已让代码实时同步，直接在主项目里运行
或调用包内类即可验证修改效果。
小技巧：如果包里用了
或文件路径相关逻辑，注意 symlink 不影响运行时路径解析，PHP 仍会按真实文件位置工作，无需特殊处理。
常见问题
与绕过方式
遇到安装失败？先检查这几个点：
路径拼写错误（尤其 Windows 下反斜杠、大小写敏感）；
本地包缺少
，或其中
与主项目
不匹配；
权限问题导致无法创建 symlink（macOS/Linux 可试
临时排查，但不推荐长期使用）；
已存在同名包且被缓存，运行
再重试。
不想全局启用 symlink？可以只对某个包启用：
放在对应 repository 下，不影响其他仓库。
pathcomposer.jsonrepositories{
"repositories": [
{
"type": "path",
"url": "../my-awesome-package"
}
],
"require": {
"vendor/my-awesome-package": "*"
}
}urlcomposer.jsonvendor/my-awesome-packagecomposer.jsonname"*"composer.jsonversiondev-mainvendor/symlinkrepositories"options": { "symlink": true }composer update vendor/my-awesome-packagevendor/vendor/my-awesome-packagels -ladircomposer.json"autoload-dev""tests/": "tests/""scripts""test": "phpunit"vendor/bin/phpunit__DIR__composer.jsonnamerequiresudo composer updatecomposer clear-cache"options": { "symlink": true }