Composer如何引入本地私有包_配置Repository本地路径【案例】-composer-PHP中文网

唯一稳定生效方式是在composer.json根级repositories数组中添加"type": "path"配置；url须为相对或绝对路径，指向含合法composer.json的目录，且name、version、autoload必须严格匹配require声明。

composer如何引入本地私有包_配置repository本地路径【案例】

直接在 composer.json 的 repositories 数组里加一条 "type": "path" 配置，是唯一能稳定生效的方式。其他任何“改 require 里加路径”“手动复制进 vendor”“用 package 类型硬写版本”都不可靠，不是报错就是不更新。

本地包的 `composer.json` 必须合法且匹配

Composer 不会校验语法错误，但遇到问题就静默跳过整个 path 源——你连报错都看不到。

name 字段必须和你在主项目 require 中写的包名**完全一致**，包括大小写和斜杠（比如 "acme/utils" ≠ "Acme/utils"）
version 字段建议显式写成 "dev-main" 或 "1.0.0"；如果留空或只写 "dev-master"，而主项目又没配 "minimum-stability": "dev"，就会被稳定性策略过滤掉
必须有 autoload（如 "psr-4": {"Acme\Utils\": "src/"} ），否则类加载失败，不是 Composer 报错，而是运行时报 Class not found
文件不能有多余逗号、单引号、UTF-8 BOM —— 这些都会让 Composer 完全忽略该目录

`repositories` 配置位置和格式不能错

它必须是根级数组，和 require 同级，不能嵌套在别的字段里，也不能放在 require-dev 下面。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

{
    "repositories": [
        {
            "type": "path",
            "url": "../my-local-package"
        }
    ],
    "require": {
        "acme/utils": "*"
    }
}

url 只接受相对路径（以 ./ 或 ../ 开头）或绝对路径（如 /Users/me/my-local-package），**不能带 file:// 前缀**
Windows 下路径分隔符用正斜杠 / 更稳妥（../my-local-package 而非 ..\my-local-package）
路径必须指向包含 composer.json 的目录，不是它的子目录
多个 path 源按数组顺序尝试匹配，但实际不依赖顺序——只要 name 对得上就行

安装与更新行为取决于 symlink 设置

默认启用符号链接（Linux/macOS）或复制（Windows），但这个行为不是自动“热重载”，而是由 install 或 update 触发的快照。

首次引入：运行 composer require acme/utils 或 composer install
改了本地包代码后：无需重新 require，但要执行 composer update acme/utils 才会刷新链接（除非你加了 "options": {"symlink": true} 并确认 Composer 版本 ≥ 2.2）
想关掉软链改用复制（比如调试时怕路径泄露）：在 repository 配置里加 "options": {"symlink": false}
CI/CD 环境下，path 源默认失效（路径不存在），上线前必须删掉 repositories 里的这条，否则构建失败

常见现象和对应检查点

运行完 composer require，vendor/acme/utils 不存在？别急着清缓存，先看这几处：

执行 ls -la vendor/acme/utils，如果不是指向源目录的软链（或 Windows 下的完整副本），说明配置根本没被读取
检查本地包目录下 composer.json 是否能被 json_decode(file_get_contents('composer.json'), true) 正常解析
运行 composer config --list | grep repositories，确认配置已加载（有时 IDE 自动保存失败）
把本地包的 version 改成 "dev-main"，然后 require 时显式写 "acme/utils": "dev-main"，绕过版本解析歧义