使用cweagans/composer-patches插件是为Composer项目添加补丁的推荐方式，支持在composer.json中定义本地或远程补丁文件，实现可重复部署；也可通过手动应用补丁临时调试，或创建fork长期维护修改，结合git diff生成patch文件，确保依赖完整性与开发效率。
在使用 Composer 管理 PHP 项目依赖时，有时需要对第三方包进行小范围修改，比如修复一个 bug 或适配本地环境。此时可以直接为项目添加补丁（patch），而无需等待官方发布更新。以下是几种常见的为 Composer 项目添加 patch 的方法。
使用 composer-patches 插件（推荐）
最常用且维护良好的方式是使用 cweagans/composer-patches 插件，它允许你在 composer.json 中定义补丁文件或远程链接。
步骤如下：
- 安装插件：
- 在
composer.json中启用 patches 配置：
{
"extra": {
"patches": {
"drupal/devel": {
"Fix a critical bug in dev module": "https://www.drupal.org/files/issues/2807497-13.patch"
},
"vendor/package-name": {
"Local fix for issue #123": "patches/my-local-fix.patch"
}
}
}
}
说明：
- 键名是你要打补丁的 Composer 包名。
- 值是一个对象，key 是补丁描述，value 是补丁路径或 URL。
- 补丁文件可以放在项目中的
patches/目录下。
手动应用补丁（适用于临时调试）
如果只是临时测试，可以在包安装后手动打补丁。
- 找到 vendor 中的目标包目录。
- 使用命令行应用 patch：
patch -p1
注意：-p1 表示忽略路径的第一级，通常适用于 git diff 或 diff -u 生成的补丁。
⚠️ 此方法的缺点是运行 composer install 或 update 后更改会被覆盖。
创建并维护自己的 fork（适合长期修改）
如果补丁较复杂或需长期维护，建议 fork 原始仓库，在自己的分支上提交修改，然后在 composer.json 中指向该 fork。
"repositories": [
{
"type": "vcs",
"url": "https://github.com/your-username/package-name"
}
],
"require": {
"vendor/package-name": "dev-your-branch"
}
这种方式便于持续更新，但需自行同步上游变更。
生成补丁文件的方法
如果你需要基于某个包生成 patch，可这样做：
- 克隆原始包代码，checkout 到与 vendor 中一致的版本。
- 做修改后，使用 git 生成补丁：
将生成的 patch 文件放入项目 patches/ 目录，并在 composer.json 中引用即可。
基本上就这些。使用 cweagans/composer-patches 是最方便、可重复部署的方式，适合团队协作和 CI 环境。补丁管理得当，能有效提升开发效率，又不破坏依赖完整性。
