PHP无法在文件中间直接插入字符串，fopen+ fseek+ fwrite仅能覆盖；安全做法是读取-拆分-拼接-全量写回，中小文件用file_get_contents，大文件用临时文件流式处理。
用 fopen() 配合 fseek() 直接写入会覆盖原有内容
PHP 没有原生“在文件中间插入字符串”的函数，fopen($file, 'r+') + fseek() + fwrite() 看似可行，但实际只会覆盖而非插入——因为磁盘文件是连续存储的，中间加字节必须把后续所有内容往后搬移，而 fwrite() 不会自动做这件事。
常见错误现象：fseek() 定位后 fwrite()，结果后面的内容被截断或错乱，尤其当插入内容长度 ≠ 原位置已有长度时。
- 这是底层文件系统限制，不是 PHP 的 bug
- 适用于“替换固定长度内容”，比如日志中更新某个字段值，但不适用于“插入新行”或“追加一段文本到中间”
- 若强行用此法，需先读取并缓存 offset 之后全部内容，再重写整段（见下一条）
安全插入的通用做法：读取 → 拆分 → 拼接 → 全量写回
真正可靠的插入，本质是内存操作：把文件按目标位置切为两段，中间塞入新内容，再合并写入。适合中小文件（几十 MB 内），避免内存溢出。
示例：在第 120 字节处插入字符串 "// inserted\n"
立即学习“PHP免费学习笔记（深入）”；
$content = file_get_contents($file); $pos = 120; $new_content = substr($content, 0, $pos) . "// inserted\n" . substr($content, $pos); file_put_contents($file, $new_content);
-
substr()第二个参数是起始位置，第三个是长度；省略第三个则取到末尾 - 若按行插入（比如在第 5 行后加内容），先用
file($file)读为数组，array_splice()插入新元素，再file_put_contents($file, implode("", $lines)) - 大文件慎用
file_get_contents()，可改用流式读取+临时文件拼接（见下一条）
处理大文件：用临时文件 + fgets() 流式拼接
当文件超百 MB，一次性加载进内存可能 OOM。此时应边读边写，用临时文件暂存结果，最后原子替换原文件。
关键点在于：精确控制“写到哪一行/哪个字节后插入”。例如，在匹配到某行（如 "// END_CONFIG"）之后插入：
$tmp = tmpfile();
$fp = fopen($file, 'r');
while (($line = fgets($fp)) !== false) {
fwrite($tmp, $line);
if (str_contains($line, '// END_CONFIG')) {
fwrite($tmp, "new_config = true;\n");
}
}
fclose($fp);
rewind($tmp);
file_put_contents($file, stream_get_contents($tmp));
fclose($tmp);
- 用
tmpfile()创建临时文件更安全，无需手动管理路径和清理 -
str_contains()是 PHP 8.0+ 函数；低版本可用strpos($line, '// END_CONFIG') !== false - 务必在
file_put_contents()前调用rewind($tmp)，否则读不到内容
用 splFileObject 实现面向行的精准插入（推荐用于配置类文件）
如果插入逻辑依赖行号或特定标记行（如 ini、php config 文件），splFileObject 比裸 fgets() 更可控，支持 seekLine、key()、current() 等方法。
示例：在第 7 行后插入一行
$f = new SplFileObject($file, 'r+');
$f->setFlags(SplFileObject::READ_AHEAD | SplFileObject::SKIP_EMPTY);
while ($f->valid()) {
if ($f->key() == 6) { // 行号从 0 开始，第 7 行是 key()==6
$lines[] = $f->current();
$lines[] = "inserted_line = 1;\n";
} else {
$lines[] = $f->current();
}
$f->next();
}
file_put_contents($file, implode('', $lines));
-
SplFileObject::READ_AHEAD提升逐行读取效率；SKIP_EMPTY跳过空行（按需启用） - 注意：不能直接在
SplFileObject上写入，仍需收集后全量写回 - 行号判断比字节偏移更符合人类直觉，也更抗编码/换行符差异影响
真正难的不是“怎么插”，而是“插完是否保持文件一致性”——比如 XML/JSON 文件要保证结构合法，INI 文件要避开注释行误插，多进程场景还要考虑文件锁。这些都得在拆分逻辑里显式处理，没法靠一个函数自动兜底。
