diff命令生成补丁最直接,diff -u old.php new.php > changes.patch输出统一格式补丁,支持-w忽略空格、-i忽略大小写,路径差异需用-p1调整;PHP中可用xdiff扩展的xdiff_string_diff(),但非默认安装且大文件易内存溢出。

用 diff 命令生成补丁文件最直接
Linux/macOS 下原生 diff 是最轻量、最可控的差异提取方式,不需要额外依赖。它能精准输出行级变更,且格式被 patch 工具原生支持,适合自动化修改。
- 基本用法:
diff -u old.php new.php > changes.patch(-u生成统一格式,含上下文,推荐) - 只比内容不比空格:加
-w;忽略大小写加-i;跳过注释行可用grep -v '^//' | diff预处理 - 注意路径:如果
old.php和new.php在不同目录,diff输出的文件路径会带前缀,应用补丁时需用-p1或-p2调整层级
PHP 里用 xdiff_string_diff() 做内存内比对
如果你必须在 PHP 进程中完成比对(比如 Web 后台触发更新),xdiff 扩展提供原生函数,但前提是已启用该扩展(不是默认安装)。
- 检查是否可用:
extension_loaded('xdiff'),否则会报Fatal error: Uncaught Error: Call to undefined function xdiff_string_diff() - 简单用法:
$patch = xdiff_string_diff($old_content, $new_content, XDIFF_PATCH_NORMAL);,返回的是二进制 patch 数据,不能直接当文本补丁用 - 若要生成类似
diff -u的可读 patch,得用xdiff_string_diff()+xdiff_string_patch()配合,但不如 shelldiff稳定,尤其对大文件易内存溢出
用 patch 命令安全应用差异
生成 patch 后,别手动改文件——用 patch 才能校验上下文、避免错位修改。它会检查变更前后的代码行是否匹配,不匹配就拒绝打补丁。
- 基本命令:
patch -p1 (-p1表示去掉补丁里路径的第一个前缀,如src/file.php→file.php) - 先预览不执行:
patch --dry-run -p1 ,看到Hunk #1 succeeded才算安全 - 常见失败原因:
Reversed (or previously applied) patch detected表示补丁已存在或方向反了;Hunk failed多因目标文件已被其他修改污染
Web 场景下慎用自动差异覆盖
线上 PHP 文件一旦被自动覆盖,出错很难回滚——没有原子写入,也没有事务保障。哪怕 diff 显示“只改了一行”,实际可能因编码、BOM、换行符差异导致整文件解析失败。
立即学习“PHP免费学习笔记(深入)”;
- 永远备份原文件:
cp file.php file.php.bak.$(date +%s),别依赖 Git(有些环境没提交) - 禁止直接 patch 生产
index.php或入口文件,优先走部署流程(rsync + symlink 切换) - 如果必须热更新,用
file_put_contents($f, $new, LOCK_EX)替代 diff/patch,更可控;diff 只用于审计和灰度验证
patch 就从工具变成事故开关。











