本文介绍一种安全、高效的方法，使用 php 读取整个文件、逐行匹配并修改目标行，最后一次性写回磁盘，避免追加写入或清空误操作，适用于配置文件等场景。
在 PHP 中直接“原地覆盖”文件某一行是不可行的——因为文件系统不支持随机长度的行级覆写（尤其当新旧行长度不同时，会引发数据错位或残留）。因此，正确的做法是：全量读取 → 内存中修改 → 全量写回。这虽非严格意义上的“就地编辑”，却是最可靠、可移植且符合 POSIX/Windows 文件语义的标准方案。
以下是一个完整、健壮的实现示例：
✅ 关键要点说明：
- ✅ 避免 fopen('a+') 的误区：a+ 模式将文件指针始终置于末尾，fwrite() 必然追加；它不支持向前定位写入，也无法安全覆盖中间内容。
- ✅ str_starts_with() 更精准：相比 strpos($line, 'mode1') !== false，它能避免误匹配（如 mode12Hello=），提升可靠性（PHP 8.0+ 原生支持；低版本可用 strncmp($line, 'mode1Hello=', 11) === 0 替代）。
- ✅ LOCK_EX 保障原子性：在多进程/多请求环境下，防止写入过程中被其他进程截断或覆盖。
- ✅ 末尾换行符处理：implode("\n", $lines) 不自动添加结尾换行，手动补上可确保与原始文件风格一致（Unix/Linux 标准）。
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 对于超大文件（>100MB），应改用流式处理（fgets + 临时文件），避免内存溢出；
- 若需保留原始文件编码（如 GBK），请使用 file_get_contents + mb_convert_encoding 显式处理；
- 生产环境建议先备份原文件（如 copy($filename, $filename . '.bak')）再执行写入。
该方法简洁、可读性强、无副作用，是 PHP 中修改配置行的推荐实践。
