需在主项目中通过Composer path仓库机制实时验证本地PHP组件改动:先确保本地包含合法composer.json及Git仓库,再于主项目composer.json中配置path型repositories并require对应dev-分支,最后执行composer update指定包。

你需要在主项目中实时验证一个尚未发布的PHP组件改动,改完本地代码后立刻生效,不走发布→下载流程。
确认本地包已具备合法结构
进入你的本地包目录(例如 ../my-sdk),检查是否存在 composer.json 文件;若不存在,必须先创建。
该文件至少需包含 【name】 和 【autoload】 两个字段,name 必须是带 vendor 的完整格式(如 "acme/sdk"),不能只写 "sdk";autoload 推荐用 PSR-4,例如 {"psr-4": {"Acme\Sdk\": "src/"}}。
运行 git init && git add . && git commit -m "init" —— Composer 要求本地包目录下有 Git 仓库且至少一个 commit,否则直接拒绝加载。
在主项目中配置 path 类型仓库
打开主项目的 composer.json,在根级添加 repositories 字段(不是在 require 里加)。
方法一:用相对路径(推荐)
在 repositories 数组中插入一项:{"type": "path", "url": "../my-sdk"}。路径必须相对于主项目 composer.json 的位置,不能以 ~/ 或 $HOME/ 开头。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
方法二:用绝对路径(仅限开发机固定环境)
例如 Linux/macOS 下写 {"type": "path", "url": "/Users/you/projects/my-sdk"};Windows 下写 {"type": "path", "url": "C:\dev\my-sdk"},注意双反斜杠或正斜杠均可。
⚠️ 切勿把 repositories 写进本地包自己的 composer.json —— 它只对主项目生效,放错位置会导致完全不识别。
声明依赖并安装
第一步:在主项目 composer.json 的 require 中添加条目,格式为 "acme/sdk": "dev-main"。
注意:版本号必须是 【dev-开头的分支名】,不是 *、^1.0 或 "1.0.0";如果本地包默认分支是 develop,就得写 "dev-develop"。
第二步:执行 composer update acme/sdk。
不要用 composer install 或全量 update,前者会跳过新 require,后者可能意外升级其他包。
第三步:检查 vendor/acme/sdk 是否为符号链接(Linux/macOS)或快捷方式(Windows);ls -l vendor/acme/sdk 显示 -> ../my-sdk 即表示成功——这是 path 源的正常行为,改本地代码,项目里立刻可见。

















