在 PHP 中，preg_replace() 函数可以用于执行多行文本的替换，这与单行文本替换的使用方式相同。不过，为了确保正则表达式能够正确匹配多行文本，你需要在正则表达式的开始 ^ 和结束 $ 使用多行修饰符 m。

以下是 preg_replace() 函数的基本语法：

$result = preg_replace($pattern, $replacement, $subject, $limit, $count);

• $pattern 是一个字符串，表示正则表达式模式，可以是一个模式或者模式数组。

• $replacement 是一个字符串或字符串数组，表示要替换成的文本。

• $subject 是一个字符串或字符串数组，表示要进行搜索和替换的原始字符串。

• $limit 是一个可选参数，表示每个模式在每个 $subject 上进行替换的最大次数。

• $count 是一个可选参数，如果提供，它将被填充为进行替换的次数。

多行替换示例

假设你有一个多行文本，你想要替换掉所有的 \"is\" 为 \"was\"：

$text = \"This is a test.\\nThis text is very important.\\nAlso, this is an example.\";

$pattern = \'/is/\'; // 注意，这里的模式不需要斜杠进行转义

$replacement = \'was\';

// 使用多行修饰符 \'m\'，它会影响 ^ 和 $ 的行为，使它们匹配每一行的开始和结束

$result = preg_replace($pattern, $replacement, $text, PREG_REPLACE_EVAL);

echo $result;

在这个例子中，PREG_REPLACE_EVAL 是一个可选的参数，它告诉 preg_replace() 对每个匹配项都进行一次 PHP 求值。这在你需要在替换中使用变量或函数时非常有用。不过，请注意，使用 PREG_REPLACE_EVAL 可能会带来安全风险，特别是当 $replacement 包含不可信的输入时。

输出结果将是：

This was a test.

This text was very important.

注意，如果你的正则表达式中使用了 ^ 或 $ 来匹配行的开始或结束，确保在模式中包含 m 修饰符。如果不使用 m 修饰符，^ 和 $ 只会匹配整个字符串的开始和结束。

注意

• 如果你的正则表达式中不包含 ^ 或 $，那么是否使用多行修饰符 m 并不会影响替换结果。

• 确保正确转义正则表达式中的任何特殊字符，除非它们在单行模式中使用（不包含 m 修饰符）。

• 使用 preg_replace() 进行多行替换时，考虑到性能和安全性，尽量避免使用 PREG_REPLACE_EVAL 标志，除非确实需要。