Composer用什么方式引入本地库_Composer软连接安装【教学】-composer-PHP中文网

composer引入本地库唯一可靠方式是配置path类型仓库，需在repositories字段正确定义相对或绝对路径，目录下有合法composer.json，并在本地包中设"options":{"symlink":true}启用符号链接。

composer用什么方式引入本地库_composer软连接安装【教学】

Composer 引入本地库唯一可靠的方式是配置 path 类型仓库，不是改 require、不是手动 symlink、也不是靠 autoload 注入——配错任意一环，vendor 里出现的就是复制副本，改代码完全不生效。

怎么写 repositories 才让 Composer 认出本地路径

关键不在 require，而在 repositories 字段是否被正确识别。Composer 只有先知道“这个目录是个包源”，才会去解析它。

url 必须是相对路径（如 ../my-package）或绝对路径（如 /Users/me/my-package），不能带 file:// 前缀，也不能用 ~/
Windows 下必须用正斜杠 / 或双反斜杠 \，单反斜杠会导致解析失败
路径必须指向一个已存在的目录，且该目录下必须有合法的 composer.json（无语法错误、无多余逗号、字段名和字符串值都用双引号）
推荐把 repositories 放在 composer.json 根级，和 require 同级；顺序无关，但建议放最前

为什么 vendor 里是复制而不是 symlink

Composer 默认行为就是复制——这是为构建可重现性做的保守设计。所谓“软链接”必须显式启用，且只对 path 类型仓库生效。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

最稳妥方式：在本地包自己的 composer.json 中加 "options": {"symlink": true}（注意：不是主项目的配置）
替代方式：全局开启 composer config --global path.repo.symlink true，但会影响所有项目
composer install 不触发 symlink 创建；必须执行 composer update vendor/name 或全量 composer update
验证是否成功：ls -la vendor/vendor/name（macOS/Linux）输出中应含 -> 指向你本地源码路径

require 写什么版本才匹配本地包

path 仓库不走语义化版本解析逻辑，它只做字符串比对。你 require 的版本必须和本地包 composer.json 里的 version 字段或分支名一致，否则直接报 Could not find package。

常见写法："dev-main"、"dev-master"、"*@dev"，前提是本地包有对应分支或设置了 "minimum-stability": "dev"
如果本地包没设 minimum-stability，主项目顶层就得加 "minimum-stability": "dev"，否则 dev-main 会被忽略
不要写 "1.2.0" 这类固定版本号，除非本地包 composer.json 的 version 字段明确写了它

改了本地包代码，为什么没立刻生效

符号链接本身是实时的，但自动加载映射（autoload）不会自动更新。改了命名空间、新增了类路径、调整了 psr-4 映射，都必须手动刷新。

改本地包的 composer.json（比如加了个新 psr-4 映射），必须在主项目运行 composer dump-autoload
改了类文件内容（如函数逻辑、新增方法），只要 symlink 正常，就立刻生效，无需任何命令
删掉 vendor/vendor/name 再跑 composer update vendor/name，可强制重建链接（适合怀疑软链损坏时）
CI/CD 环境下 path 仓库默认失效，因为路径不存在；上线前必须切换回 Packagist 或私有仓库，否则构建失败

最容易被忽略的是：本地包目录必须是 Git 仓库（哪怕只有一次空提交），否则 Composer 会静默跳过整个仓库；还有就是 name 字段大小写和 vendor 名必须与 require 完全一致——差一个字母，就报 Could not find package，而错误信息根本不会提示是名字不匹配。