本文介绍一种安全、高效的方法，使用 php 读取整个文件、逐行匹配并替换目标行，最后一次性写回磁盘，避免追加写入或破坏原有结构。适用于配置文件、键值对文本等场景。
在 PHP 中直接“原地覆盖”文件某一行是不可行的——因为文件系统不支持随机长度的行级覆写（字节偏移固定，而替换后行长度可能变化）。你遇到的问题（内容被追加到末尾）正是由于使用了 'a+' 模式：该模式将文件指针始终置于末尾，fwrite() 必然追加。即使切换为 'r+'，手动定位并精确覆盖仍极易出错（如长度不一致导致残留或截断）。
✅ 正确做法是：读取 → 修改 → 全量写入。这是一种原子性更强、逻辑更清晰、容错性更高的方案。
以下是推荐实现（兼容 PHP 8.0+，含健壮性增强）：
<?php
$filename = 'test.txt';
// 1. 安全读取文件内容（自动处理换行符差异）
if (!file_exists($filename)) {
die("Error: File '$filename' does not exist.");
}
$contents = file_get_contents($filename);
if ($contents === false) {
die("Error: Failed to read file '$filename'.");
}
// 2. 按行分割（保留原始换行符风格：\n 或 \r\n）
$lines = file($filename, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
// 3. 遍历并替换匹配行（使用严格前缀匹配，防误触）
foreach ($lines as &$line) {
if (str_starts_with($line, 'mode1Hello=')) {
$line = 'mode1Hello= 900';
} elseif (str_starts_with($line, 'mode1Goodbye=')) {
$line = 'mode1Goodbye= 800';
} elseif (str_starts_with($line, 'mode1Neutral=')) {
$line = 'mode1Neutral= 700';
}
}
unset($line); // 解除引用，避免意外修改
// 4. 用原始文件的换行符拼接（保持格式一致）
$originalNewline = "\n";
if (strpos($contents, "\r\n") !== false) {
$originalNewline = "\r\n";
}
$result = implode($originalNewline, $lines) . $originalNewline; // 末尾补换行（可选）
// 5. 原子写入：先写临时文件，再重命名（防写入中断导致数据丢失）
$tempFile = $filename . '.tmp';
if (file_put_contents($tempFile, $result) === false) {
die("Error: Failed to write temporary file.");
}
if (!rename($tempFile, $filename)) {
unlink($tempFile);
die("Error: Failed to replace original file.");
}
echo "✅ Successfully updated lines starting with 'mode1'.";
?>? 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 勿用 fopen('a+') + fseek() 尝试“就地修改”：行长度变化会导致后续内容错位，极易损坏文件；
- 优先使用 file() 而非 explode("\n", ...)：file() 自动处理跨平台换行符（\r\n/\n），且跳过空行更可靠；
- str_starts_with() 比 strpos() 更语义清晰且安全（避免 0 === false 类型混淆）；
- 生产环境务必添加原子写入逻辑（临时文件 + rename()），防止程序崩溃时原文件丢失；
- 若需频繁更新，建议将此类配置转为 JSON/INI 格式，利用 parse_ini_file() 或 json_decode() 管理，提升可维护性。
该方法简洁、可读性强，兼顾正确性与健壮性，是处理文本行级替换的标准实践。
