你是否也曾遇到过这样的场景：你正在开发一个大型 PHP 应用，其中包含多个独立的本地库（比如一个核心框架、几个业务模块或第三方插件）。当你在某个本地库中进行了修改，想要立即在主应用中测试这些变更时，通常会面临几种选择：
-
提交并更新版本：将本地库的修改提交到 Git 仓库，打上新版本标签，然后在主应用中运行
composer update。这种方式流程繁琐，对于频繁的小改动来说，效率极其低下。 -
使用
path仓库：在主应用的composer.json中添加path类型的仓库，直接指向本地库的路径。这种方法虽然能实现本地链接，但它会修改composer.json和composer.lock文件，不适合作为临时的开发调试方案，容易污染项目配置，并且在团队协作时可能引发冲突。 -
手动软链接：直接在
vendor目录中创建软链接。这种方式虽然直接，但脱离了 Composer 的管理，容易出错且不易维护。
这些传统方法都无法完美解决本地包的快速迭代和调试问题，开发体验大打折扣。那么，有没有一种既高效又优雅的方式，能让我们在不修改项目 composer.json 的前提下，实现本地依赖包的实时调试呢？
救星来了：sandersander/composer-link
sandersander/composer-link 就是为解决这个痛点而生的 Composer 插件！它允许你将本地开发的包直接“链接”到你的 Composer 项目中，就像创建了一个软链接，但又完全在 Composer 的控制之下。最棒的是，它不会修改你的 composer.json 或 composer.lock 文件，这意味着你可以放心地进行本地开发和测试，而不用担心污染项目配置。
如何使用 sandersander/composer-link
1. 安装插件
你可以选择全局安装或按项目安装。
全局安装 (推荐)： 如果你经常需要在不同项目中使用本地链接功能，全局安装是最方便的选择。
composer global require sandersander/composer-link
按项目安装： 如果你只想在特定项目中使用，可以作为开发依赖安装。
composer require --dev sandersander/composer-link
2. 链接本地包
安装完成后，你就可以使用 link 命令来链接本地包了。
假设你的主应用在 my-app/ 目录下，而你正在开发的本地库在 ../my-library/ 目录下。
# 在 my-app 目录下执行 composer link ../my-library
如果你的插件是全局安装的，并且你想链接一个全局包，可以这样：
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
# 在任何目录下执行，如果链接的是全局 Composer 包 composer global link ../path/to/global-package
你甚至可以使用通配符一次性链接一个目录下所有的包：
# 链接 ../packages/ 目录下所有已安装的包 composer link ../packages/* --only-installed
默认情况下，composer link 会自动安装/更新链接包所需的依赖。如果你想阻止这个行为，可以使用 --without-dependencies 标志。同时，如果你不想安装根包的 require-dev 依赖，可以使用 --no-dev。
3. 查看已链接的包
想知道当前项目链接了哪些本地包？使用 linked 命令一目了然：
composer linked
4. 取消链接
当你完成本地调试，或者不再需要链接某个包时，可以使用 unlink 命令取消链接：
composer unlink ../my-library
如果你想取消所有已链接的包，可以使用 unlink-all 命令：
composer unlink-all
优势与实际应用效果
- 开发效率飞跃：这是最核心的优势。当你修改了本地库的代码后，无需任何额外的 Composer 命令，主应用就能立即感知到这些变更。这意味着你可以像在同一个项目里一样，无缝地进行跨包调试和测试，大幅缩短开发周期。
-
项目配置整洁：
sandersander/composer-link不会触碰你的composer.json和composer.lock。这对于团队协作至关重要，你的本地开发环境不会引入任何特定的配置，避免了因path仓库等导致的配置冲突。 -
无缝集成 Composer 生态：尽管是本地链接，但它依然在 Composer 的管理之下。你可以继续运行
composer install或composer update，composer-link会智能地处理这些操作，确保你的项目始终处于正确的状态。 -
灵活多变：无论是单个包的链接，还是通过通配符一次性链接多个包，甚至全局包的链接，
composer-link都提供了强大的灵活性。
总结
sandersander/composer-link 是一个简单而强大的 Composer 插件，它完美解决了 PHP 项目中本地依赖包的调试痛点。通过它，你可以在不污染项目配置的前提下，实现本地包的实时调试，极大地提升开发效率和体验。如果你经常需要在主应用和本地库之间切换开发，那么 composer-link 绝对是你的开发工具箱中不可或缺的一员。告别繁琐的提交和更新，拥抱高效、流畅的本地开发流程吧！
