Composer不支持composer require ./path语法，必须先在composer.json中配置type为path的仓库并指定相对url，再以标准包名加"*"约束引入，否则报“Could not find package”。
直接用 path 仓库类型，别走 git 或 dist 流程——本地包不是远程库，不需要 clone 或下载。
为什么 composer require ./local-package 总报错？
这是最常见误操作：composer require 默认只接受包名（如 monolog/monolog），不支持路径参数。强行写 ./my-lib 会触发 “Could not find a matching version” 错误，因为 Composer 根本没去解析路径。
- 错误示例：
composer require ./vendor/my-company/utils→ 不合法语法 - 正确思路：先声明一个本地
path类型仓库，再以标准包名引入 - 注意：该路径是容器内的路径，不是宿主机路径；若用
docker-compose挂载，需确保挂载后路径存在且可读
如何在 composer.json 中配置 path 仓库
在项目根目录的 composer.json 里加 repositories 字段，指向容器内已存在的本地包目录。Composer 会自动扫描其 composer.json 并注册为可安装包。
{
"repositories": [
{
"type": "path",
"url": "./packages/my-utils"
}
],
"require": {
"my-company/utils": "*"
}
}
-
url值必须是相对路径（从composer.json所在位置算起），且容器中该路径下要有合法的composer.json -
"*"表示允许任意开发版（dev-main、dev-develop等），无需打 tag - 如果本地包
composer.json里写了"version": "1.0.0"，这里也可写"1.0.0"，但通常开发阶段用*更灵活
Docker 构建时 vendor 无法命中本地包？检查三件事
构建镜像时 composer install 找不到本地包，90% 是路径或时机问题。
-
COPY顺序错了：必须先COPY packages/ ./packages/，再COPY composer.json composer.lock ./，最后才RUN composer install。否则构建时./packages/my-utils根本不存在 - Alpine 镜像下权限被拒：某些 Alpine 版本默认 umask 限制严格，
RUN chmod -R a+r ./packages可临时解决 - 用了多阶段构建但漏复制：若在 builder 阶段装依赖，需确认
packages/目录也一并COPY --from=builder过去，或改用单阶段构建避免路径断裂
开发调试时怎么热更新本地包？
挂载本地代码进容器后，composer install 默认不会重链接已安装的 path 包——它缓存了 symlink 路径。要强制刷新，得删掉 vendor 下对应目录再重装。
- 进容器执行：
rm -rf vendor/my-company/utils && composer install - 更稳妥做法：加
--prefer-source参数，确保每次走 symlink 而非 dist 解压：composer install --prefer-source - 注意：
--prefer-source在生产镜像中禁用，它会让 vendor 变大且含 .git 目录
真正容易被忽略的是：path 仓库不校验包名是否唯一。如果两个本地包都声明 "name": "my-company/utils"，Composer 只取第一个匹配项，不会报错——静默覆盖，排查起来极难定位。
