如何优雅地修改Composer依赖包?migrify/vendor-patches助你轻松管理Vendor补丁

可以通过一下地址学习composer:学习地址

你有没有遇到过这样的情况:在你的php项目里,某个 composer 依赖包几乎完美,但就是有一个小小的功能不符合你的需求,或者有一个 bug 需要你立即修复,而官方版本还没来得及更新?

这时候,你可能会想:直接去

vendor/

目录里改一下不就行了?

是的,你确实可以这么做。但问题是,一旦你运行

composer update

或者

composer install

,你的所有修改都会被无情地覆盖掉!这简直是开发者的噩梦。为了一个微小的改动去 Fork 整个仓库,然后维护自己的分支,又显得过于笨重和耗时。手动管理

.patch

文件,也容易出错且难以维护。

这种困境,相信很多PHP开发者都深有体会。它不仅浪费时间,还增加了项目维护的复杂性。那么,有没有一种既能灵活修改依赖包,又能保证修改不会被覆盖,同时还易于管理和团队协作的方案呢?

答案是肯定的!今天,我要向大家隆重推荐一个 Composer 生态中的神器——

migrify/vendor-patches

。这个工具完美解决了我们修改第三方依赖包的痛点,它能帮助你轻松生成并应用对

vendor

目录中文件的修改,而无需直接改动原始文件或 Fork 整个仓库。

migrify/vendor-patches

的核心思想是:通过比较你修改后的文件和原始文件,自动生成一个

.patch

文件。然后,结合

cweagans/composer-patches

这个库,在每次

composer install

composer update

时,自动将这些补丁应用到你的

vendor

目录中。这样一来,你的修改就有了版本控制,再也不怕被覆盖了!

如何使用

migrify/vendor-patches

接下来,让我们看看如何一步步使用

migrify/vendor-patches

来解决这个问题。

1. 安装必要的依赖

首先,我们需要通过 Composer 安装

migrify/vendor-patches

cweagans/composer-patches

migrify/vendor-patches

主要用于生成补丁,通常只在开发环境中使用,所以我们可以将其作为

dev

依赖安装;而

cweagans/composer-patches

则是负责在

composer install

时实际应用补丁的,如果你的补丁需要在生产环境生效,那么它就必须作为普通依赖安装。

composer require symplify/vendor-patches --dev# 如果需要在生产环境应用补丁,请务必安装 cweagans/composer-patchescomposer require cweagans/composer-patches

2. 复制你想要修改的 Vendor 文件并添加

.old

后缀

现在,假设你需要修改

vendor/nette/di/src/DI/Extensions/InjectExtension.php

这个文件。第一步是复制这个文件,并在副本的末尾添加

.old

后缀。注意:是复制,不是重命名!

vendor/nette/di/src/DI/Extensions/InjectExtension.php       # 这是你将要修改的原始文件vendor/nette/di/src/DI/Extensions/InjectExtension.php.old  # 这是原始文件的备份

3. 修改原始文件

现在,你可以大胆地打开

vendor/nette/di/src/DI/Extensions/InjectExtension.php

这个文件,进行你需要的修改了。例如,我们想要修改其中一行代码,使其使用我们自己的反射辅助类:

图改改 图改改

在线修改图片文字

图改改 455 查看详情 图改改

            if (DIHelpers::parseAnnotation($rp, 'inject') !== null) {-               if ($type = DIHelpers::parseAnnotation($rp, 'var')) { // 原始代码+               if ($type = AppReflectionHelperStaticReflectionHelper::getPropertyType($rp)) { // 我们的修改+               } elseif ($type = DIHelpers::parseAnnotation($rp, 'var')) { // 兼容原始逻辑                    $type = Reflection::expandClassName($type, Reflection::getPropertyDeclaringClass($rp));

一个非常棒的特性是:只有没有

.old

后缀的文件会被加载和执行。这意味着你可以在生成补丁之前,先运行你的应用程序,确保你所做的修改是正确的并且没有引入新的问题。这大大降低了风险!

4. 运行

generate

命令,生成补丁!?️

当你的修改测试通过后,激动人心的时刻到了!运行

vendor-patches generate

命令,它会遍历所有带有

.old

后缀的文件,并为你生成对应的

.patch

文件。

vendor/bin/vendor-patches generate

命令执行后,你会在项目根目录下看到一个

patches/

目录,里面包含了为你生成的补丁文件,例如:

/patches/nette-di-di-extensions-injectextension.php.patch

。这个补丁文件的命名是基于原始文件路径的,保证了其唯一性。

更智能的是,

migrify/vendor-patches

还会自动更新你的

composer.json

文件,在

extra

配置项中添加

cweagans/composer-patches

所需的补丁信息:

{    "extra": {        "patches": {            "nette/di": [                "patches/nette_di_di_extensions_injectextension.patch"            ]        }    }}

如果你有特殊的补丁文件路径需求,也可以通过

--patches-file

选项来指定:

vendor/bin/vendor-patches generate --patches-file=patches.json

5. 应用补丁

现在,万事俱备,只欠东风!你只需要运行标准的 Composer 安装命令,你的补丁就会被自动应用到

vendor

目录中了!

composer install

如果补丁没有成功应用,或者你想查看更详细的日志,可以使用

--verbose

选项:

composer install --verbose

小贴士: 如果你使用的是 macOS 系统,并且在应用补丁时遇到问题,可能是因为缺少

gpatch

工具。你可以通过 Homebrew 安装它:

brew install gpatch

优势与实际应用效果

使用

migrify/vendor-patches

带来的好处是显而易见的,它彻底改变了我们处理第三方依赖的方式:

优雅且非侵入式: 你的修改以补丁的形式存在,不会直接污染

vendor

目录,保持了项目的整洁性。可维护性极强: 补丁文件可以像其他代码一样被版本控制(Git),方便团队成员共享和追踪修改。自动化管理: 借助

cweagans/composer-patches

,补丁的安装和更新完全自动化,无需手动干预。灵活且精准: 你可以只对你需要的部分进行修改,而不是被迫接受整个 Fork 带来的复杂性。告别 Fork 困境: 对于小的改动,你不再需要 Fork 整个仓库,节省了大量的维护成本和时间。团队协作无忧: 团队成员只需

composer install

,就能获得所有必要的补丁,确保开发环境的一致性。

总结

在现代PHP开发中,Composer 已经成为不可或缺的工具。而

migrify/vendor-patches

则是 Composer 生态中一个非常实用的补充,它解决了许多开发者在处理第三方依赖时面临的痛点。通过它,我们能够以一种更加专业、高效、可维护的方式来管理对

vendor

包的修改,让我们的项目更加健壮,开发流程更加顺畅。下次再遇到需要微调依赖包的情况,不妨试试这个神器,它一定会让你爱不释手!

以上就是如何优雅地修改Composer依赖包?migrify/vendor-patches助你轻松管理Vendor补丁的详细内容,更多请关注php中文网其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/269453.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月4日 11:40:13
下一篇 2025年11月4日 11:41:24

相关推荐

  • 旋转长方形后,如何计算其相对于画布左上角的轴距?

    绘制长方形并旋转,计算旋转后轴距 在拥有 1920×1080 画布中,放置一个宽高为 200×20 的长方形,其坐标位于 (100, 100)。当以任意角度旋转长方形时,如何计算它相对于画布左上角的 x、y 轴距? 以下代码提供了一个计算旋转后长方形轴距的解决方案: const x = 200;co…

    2025年12月24日
    000
  • 旋转长方形后,如何计算它与画布左上角的xy轴距?

    旋转后长方形在画布上的xy轴距计算 在画布中添加一个长方形,并将其旋转任意角度,如何计算旋转后的长方形与画布左上角之间的xy轴距? 问题分解: 要计算旋转后长方形的xy轴距,需要考虑旋转对长方形宽高和位置的影响。首先,旋转会改变长方形的长和宽,其次,旋转会改变长方形的中心点位置。 求解方法: 计算旋…

    2025年12月24日
    000
  • 旋转长方形后如何计算其在画布上的轴距?

    旋转长方形后计算轴距 假设长方形的宽、高分别为 200 和 20,初始坐标为 (100, 100),我们将它旋转一个任意角度。根据旋转矩阵公式,旋转后的新坐标 (x’, y’) 可以通过以下公式计算: x’ = x * cos(θ) – y * sin(θ)y’ = x * …

    2025年12月24日
    000
  • 如何计算旋转后长方形在画布上的轴距?

    旋转后长方形与画布轴距计算 在给定的画布中,有一个长方形,在随机旋转一定角度后,如何计算其在画布上的轴距,即距离左上角的距离? 以下提供一种计算长方形相对于画布左上角的新轴距的方法: const x = 200; // 初始 x 坐标const y = 90; // 初始 y 坐标const w =…

    2025年12月24日
    200
  • CSS元素设置em和transition后,为何载入页面无放大效果?

    css元素设置em和transition后,为何载入无放大效果 很多开发者在设置了em和transition后,却发现元素载入页面时无放大效果。本文将解答这一问题。 原问题:在视频演示中,将元素设置如下,载入页面会有放大效果。然而,在个人尝试中,并未出现该效果。这是由于macos和windows系统…

    2025年12月24日
    200
  • 如何计算旋转后的长方形在画布上的 XY 轴距?

    旋转长方形后计算其画布xy轴距 在创建的画布上添加了一个长方形,并提供其宽、高和初始坐标。为了视觉化旋转效果,还提供了一些旋转特定角度后的图片。 问题是如何计算任意角度旋转后,这个长方形的xy轴距。这涉及到使用三角学来计算旋转后的坐标。 以下是一个 javascript 代码示例,用于计算旋转后长方…

    2025年12月24日
    000
  • HTML、CSS 和 JavaScript 中的简单侧边栏菜单

    构建一个简单的侧边栏菜单是一个很好的主意,它可以为您的网站添加有价值的功能和令人惊叹的外观。 侧边栏菜单对于客户找到不同项目的方式很有用,而不会让他们觉得自己有太多选择,从而创造了简单性和秩序。 今天,我将分享一个简单的 HTML、CSS 和 JavaScript 源代码来创建一个简单的侧边栏菜单。…

    2025年12月24日
    200
  • 前端代码辅助工具:如何选择最可靠的AI工具?

    前端代码辅助工具:可靠性探讨 对于前端工程师来说,在HTML、CSS和JavaScript开发中借助AI工具是司空见惯的事情。然而,并非所有工具都能提供同等的可靠性。 个性化需求 关于哪个AI工具最可靠,这个问题没有一刀切的答案。每个人的使用习惯和项目需求各不相同。以下是一些影响选择的重要因素: 立…

    2025年12月24日
    300
  • 带有 HTML、CSS 和 JavaScript 工具提示的响应式侧边导航栏

    响应式侧边导航栏不仅有助于改善网站的导航,还可以解决整齐放置链接的问题,从而增强用户体验。通过使用工具提示,可以让用户了解每个链接的功能,包括设计紧凑的情况。 在本教程中,我将解释使用 html、css、javascript 创建带有工具提示的响应式侧栏导航的完整代码。 对于那些一直想要一个干净、简…

    2025年12月24日
    000
  • 布局 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在这里查看视觉效果: 固定导航 – 布局 – codesandbox两列 – 布局 – codesandbox三列 – 布局 – codesandbox圣杯 &#8…

    2025年12月24日
    000
  • 隐藏元素 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看隐藏元素的视觉效果 – codesandbox 隐藏元素 hiding elements hiding elements hiding elements hiding elements hiding element…

    2025年12月24日
    400
  • 如何使用 Laravel 框架轻松整合微信支付与支付宝支付?

    如何通过 laravel 框架整合微信支付与支付宝支付 在 laravel 开发中,为电商网站或应用程序整合支付网关至关重要。其中,微信支付和支付宝是中国最流行的支付平台。本文将介绍如何使用 laravel 框架封装这两大支付平台。 一个简单有效的方法是使用业内认可的 easywechat lara…

    2025年12月24日
    000
  • 居中 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看垂直中心 – codesandbox 和水平中心的视觉效果。 通过 css 居中 垂直居中 centering centering centering centering centering centering立即…

    2025年12月24日 好文分享
    300
  • Laravel 框架中如何无缝集成微信支付和支付宝支付?

    laravel 框架中微信支付和支付宝支付的封装 如何将微信支付和支付宝支付无缝集成到 laravel 框架中? 建议解决方案 考虑使用 easywechat 的 laravel 版本。easywechat 是一个成熟、维护良好的库,由腾讯官方人员开发,专为处理微信相关功能而设计。其 laravel…

    2025年12月24日
    500
  • 如何在 Laravel 框架中轻松集成微信支付和支付宝支付?

    如何用 laravel 框架集成微信支付和支付宝支付 问题:如何在 laravel 框架中集成微信支付和支付宝支付? 回答: 建议使用 easywechat 的 laravel 版,easywechat 是一个由腾讯工程师开发的高质量微信开放平台 sdk,已被广泛地应用于许多 laravel 项目中…

    2025年12月24日
    000
  • 使用Laravel框架如何整合微信支付和支付宝支付?

    使用 Laravel 框架整合微信支付和支付宝支付 在使用 Laravel 框架开发项目时,整合支付网关是常见的需求。对于微信支付和支付宝支付,推荐采用以下方法: 使用第三方库:EasyWeChat 的 Laravel 版本 建议直接使用现有的 EasyWeChat 的 Laravel 版本。该库由…

    2025年12月24日
    000
  • 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中?

    如何简洁集成微信和支付宝支付到 Laravel 问题: 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中? 答案: 强烈推荐使用流行的 Laravel 包 EasyWeChat,它由腾讯开发者维护。多年来,它一直保持更新,提供了一个稳定可靠的解决方案。 集成步骤: 安装 Laravel …

    2025年12月24日
    100
  • 如何在移动端实现子 div 在父 div 内任意滑动查看?

    如何在移动端中实现让子 div 在父 div 内任意滑动查看 在移动端开发中,有时我们需要让子 div 在父 div 内任意滑动查看。然而,使用滚动条无法实现负值移动,因此需要采用其他方法。 解决方案: 使用绝对布局(absolute)或相对布局(relative):将子 div 设置为绝对或相对定…

    2025年12月24日
    000
  • 移动端嵌套 DIV 中子 DIV 如何水平滑动?

    移动端嵌套 DIV 中子 DIV 滑动 在移动端开发中,遇到这样的问题:当子 DIV 的高度小于父 DIV 时,无法在父 DIV 中水平滚动子 DIV。 无限画布 要实现子 DIV 在父 DIV 中任意滑动,需要创建一个无限画布。使用滚动无法达到负值,因此需要使用其他方法。 相对定位 一种方法是将子…

    2025年12月24日
    000
  • 移动端项目中,如何消除rem字体大小计算带来的CSS扭曲?

    移动端项目中消除rem字体大小计算带来的css扭曲 在移动端项目中,使用rem计算根节点字体大小可以实现自适应布局。但是,此方法可能会导致页面打开时出现css扭曲,这是因为页面内容在根节点字体大小赋值后重新渲染造成的。 解决方案: 要避免这种情况,将计算根节点字体大小的js脚本移动到页面的最前面,即…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信