在PHP开发的实际场景中，经常需要对文件内容做定向修改，比如替换配置文件中包含特定标识的行，或者修正日志文件里的特定记录。要实现精准替换文件中包含指定字符串的行，核心思路是先逐行读取文件内容，判断每一行是否包含目标字符串，对符合条件的行做替换处理，最后将修改后的所有内容回写到文件中。
基础实现步骤
1. 读取文件所有内容
首先需要将目标文件的全部内容读取到内存中，方便后续逐行处理。这里使用file()函数，它会将文件内容按行分割成数组，每行作为数组的一个元素，保留行尾的换行符。
2. 逐行检查并替换
遍历读取到的行数组，对每一行使用strpos()函数判断是否包含目标字符串，如果包含则执行替换逻辑，替换后的内容可以自定义，比如替换为新的配置行或者空行。
3. 回写文件内容
处理完所有行之后，使用file_put_contents()函数将修改后的数组内容拼接成字符串，重新写入到原文件中，完成替换操作。
完整代码示例
以下是一个可直接使用的函数示例，实现了替换文件中包含指定字符串的行，替换为用户自定义的新行内容：
<?php
/**
* 替换文件中包含指定字符串的行
* @param string $filePath 文件路径
* @param string $targetStr 要查找的目标字符串
* @param string $newLine 替换后的新行内容，默认替换为空行
* @return bool 操作是否成功
*/
function replaceLineWithString($filePath, $targetStr, $newLine = '') {
// 检查文件是否存在且可读可写
if (!file_exists($filePath) || !is_readable($filePath) || !is_writable($filePath)) {
return false;
}
// 读取文件所有行，保留换行符
$lines = file($filePath);
if ($lines === false) {
return false;
}
// 遍历每一行进行处理
foreach ($lines as $key => $line) {
// 判断当前行是否包含目标字符串
if (strpos($line, $targetStr) !== false) {
// 替换当前行，保留原有的换行符规则，新行内容后添加换行符
$lines[$key] = $newLine . PHP_EOL;
}
}
// 将处理后的行数组拼接成字符串，回写到文件
$result = file_put_contents($filePath, implode('', $lines));
return $result !== false;
}
// 使用示例：替换test.txt中包含"old_config"的行，替换为新的配置行
$res = replaceLineWithString('test.txt', 'old_config', 'new_config = 123');
if ($res) {
echo '替换成功';
} else {
echo '替换失败';
}
?>
注意事项
- 如果处理的文件体积非常大，不建议一次性读取全部内容到内存，可以改用流式读取的方式，逐行读取、判断、写入临时文件，最后替换原文件，避免内存占用过高。
- 替换时要注意换行符的处理，不同操作系统的换行符可能不同，
PHP_EOL会自动适配当前系统的换行符，保证替换后的文件格式正常。 - 如果目标字符串可能出现在行的任意位置，使用
strpos()判断即可，如果需要精确匹配整行内容，可以改用trim($line) === $targetStr的方式判断。 - 操作文件前建议先备份原文件，避免替换逻辑出错导致原文件内容丢失。