使用composer-patches插件可为PHP依赖包打补丁：1. 生成修改的diff文件并存入项目patches目录；2. 在composer.json中添加cweagans/composer-patches依赖并配置enable-patching及patches项；3. 运行composer install或update自动应用补丁；4. 注意补丁适用范围、版本控制和长期维护问题。
在使用 Composer 管理 PHP 项目时，有时需要对依赖包进行小范围修改，比如修复一个 bug，但又不想 fork 整个项目或等待官方发布新版本。这时可以通过打补丁（patch）的方式来实现。以下是具体操作方法。
1. 准备补丁文件
你需要先生成一个 diff 文件，记录你对某个依赖包的修改。
假设你发现 vendor/symfony/http-foundation 中有个问题，你已经手动修改了代码：- 进入 vendor 目录对应包的路径
- 使用 git 生成 diff：
git diff > /path/to/patches/symfony-http-foundation-fix-header.patch
这个 patch 文件应提交到你项目的仓库中，比如放在 patches/ 目录下。
2. 使用 composer-patches 插件
Composer 本身不支持直接打补丁，需借助第三方插件：cweagans/composer-patches。
在项目根目录的 composer.json 中添加：
"require": {
"cweagans/composer-patches": "^1.7"
},
"extra": {
"enable-patching": true,
"patches": {
"symfony/http-foundation": {
"Fix header issue": "patches/symfony-http-foundation-fix-header.patch"
}
}
}
- enable-patching 启用补丁功能
- patches 定义了哪个包应用哪个补丁，支持多个
3. 应用补丁
运行以下命令安装或更新依赖，补丁会自动应用：
composer install 或 composer update
插件会在下载包后自动将 patch 文件应用到对应目录。如果补丁冲突，会提示错误，需手动处理。
4. 注意事项
- 补丁仅适用于源码由 Git 管理的项目（如从 packagist 下载的包通常解压后无 .git，可能无法应用）
- 建议将 patch 文件存放在项目内，并提交到版本控制
- 补丁不会自动更新，若依赖包升级，需重新评估补丁是否仍适用
- 长期解决方案仍是提交 PR 到原项目，避免维护成本过高
基本上就这些。通过 composer-patches，你可以灵活地为第三方包打补丁，同时保持项目可维护性。
