PHP preg_match 匹配多行内容：解决 . 无法匹配换行符的问题

本教程旨在解决 php 中 `preg_match` 函数在使用 `file_get_contents` 读取多行文本时匹配失败的问题。核心在于正则表达式中的点号 `.` 默认不匹配换行符。我们将详细介绍如何通过添加 `s` (dotall) 修饰符来改变这一行为，确保正则表达式能够正确捕获跨越多行的内容，并提供实用的代码示例和注意事项。

理解 preg_match 与正则表达式中的点号 .

在 PHP 中，preg_match 函数用于执行正则表达式匹配。它的强大之处在于能够灵活地从字符串中提取所需的数据。然而，在使用过程中，开发者常会遇到一个常见但容易被忽视的问题：当目标字符串包含换行符时，正则表达式中的点号 .（匹配任意字符）默认情况下并不会匹配换行符。

考虑以下两种情况：

1. 单行字符串匹配（成功示例）

当目标字符串是单行时，preg_match 能够如预期般工作。

立即学习“PHP免费学习笔记（深入）”；

<?php
$HTML   = '#a#TEXT#a#';
$REGEX  = '/#a#(.*?)#a/';

preg_match($REGEX, $HTML, $MATCH);

print_r($MATCH);
// 输出：Array ( [0] => #a#TEXT#a# [1] => TEXT )
var_dump($MATCH);
// 输出：array(2) { [0]=> string(12) "#a#TEXT#a#" [1]=> string(4) "TEXT" }
?>

在这个例子中，$HTML 是一个不含换行符的字符串，.* 能够成功匹配 TEXT。

2. 多行文件内容匹配（失败示例）

当内容从文件中读取，并且文件包含多行（即包含换行符）时，问题就出现了。假设 file.php 文件内容如下：

#a#

TEXT

#a#

使用 file_get_contents 读取后，$HTML 变量将包含这些换行符。此时，相同的正则表达式将无法匹配。

<?php
// file.php 文件的内容：
// #a#
//
// TEXT
//
// #a#

$HTML   = file_get_contents("file.php"); // 假设文件内容如上所示
$REGEX  = '/#a#(.*?)#a/';

preg_match($REGEX, $HTML, $MATCH);

print_r($MATCH);
// 输出：Array ( )
var_dump($MATCH);
// 输出：array(0) { }
?>

由于 . 默认不匹配换行符，正则表达式 / #a#(.*?)#a#/ 无法跨越 #a# 和 TEXT 之间的换行符以及 TEXT 和 #a# 之间的换行符，导致匹配失败，$MATCH 数组为空。

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

解决方案：使用 s (DOTALL) 修饰符

解决此问题的关键在于使用正则表达式的 s (DOTALL) 修饰符。当 s 修饰符被添加到正则表达式的末尾时，它会改变点号 . 的默认行为，使其能够匹配包括换行符在内的所有字符（除了 null 字符）。

通过在正则表达式的结束分隔符后添加 s，我们可以确保 .* 能够正确匹配跨越多行的内容。

修正后的代码示例：

<?php
// file.php 文件的内容：
// #a#
//
// TEXT
//
// #a#

$HTML   = file_get_contents("file.php");
// 检查文件是否成功读取，这是良好的编程习惯
if ($HTML === false) {
    echo "错误：无法读取文件 'file.php'。\n";
    exit; // 或其他错误处理
}

$REGEX  = '/#a#(.*?)#a#/s'; // 注意这里添加了 's' 修饰符

preg_match($REGEX, $HTML, $MATCH);

print_r($MATCH);
// 预期输出：Array ( [0] => #a# TEXT #a# [1] => TEXT )
// 实际输出可能包含换行符：Array ( [0] => #a#\n\nTEXT\n\n#a# [1] => \n\nTEXT\n\n )
var_dump($MATCH);
// 预期输出：array(2) { [0]=> string(19) "#a#\n\nTEXT\n\n#a#" [1]=> string(8) "\n\nTEXT\n\n" }
?>

通过添加 s 修饰符，正则表达式 / #a#(.*?)#a#/s 现在能够将 #a# 和 TEXT 之间的换行符视为普通字符进行匹配，从而成功提取到完整的内容。

确保文件内容正确读取

虽然 s 修饰符是解决多行匹配问题的核心，但在进行文件操作时，始终建议检查 file_get_contents 的返回值。如果文件不存在、权限不足或路径错误，file_get_contents 会返回 false。

<?php
$HTML = file_get_contents("file.php");

// 调试文件读取：
var_dump($HTML); // 检查 $HTML 的内容，确认文件是否被正确读取，以及其内部是否包含换行符

if ($HTML === false) {
    echo "错误：无法读取文件 'file.php'。请检查文件路径和权限。\n";
    // 在实际应用中，这里应该有更健壮的错误处理机制
    exit;
}

// ... 之后再进行 preg_match 操作 ...
?>

通过 var_dump($HTML)，你可以直观地看到 file_get_contents 到底读取了什么内容，这对于调试文件读取问题非常有帮助。

其他常用正则表达式修饰符

除了 s (DOTALL) 修饰符，PHP 的 preg_match 还支持其他一些常用的修饰符，它们可以极大地增强正则表达式的灵活性：

• i (CASE-INSENSITIVE)：使匹配不区分大小写。例如，/text/i 会匹配 "text", "Text", "TEXT" 等。
• m (MULTILINE)：使 ^ 和 $ 锚点匹配行的开始和结束，而不仅仅是整个字符串的开始和结束。在没有 m 修饰符时，^ 只匹配字符串的开头，$ 只匹配字符串的结尾。有了 m，它们会匹配每一行的开头和结尾（由换行符定义）。
• U (UNGREEDY)：使量词（如 *, +, ?）默认变为非贪婪模式。通常，量词是贪婪的，会尽可能多地匹配字符。添加 U 后，它们会尽可能少地匹配。或者，你也可以在量词后直接加 ? 来使其变为非贪婪，例如 .*?。

总结

当在 PHP 中使用 preg_match 配合 file_get_contents 处理包含换行符的多行文本时，核心问题在于正则表达式中的点号 . 默认不匹配换行符。通过在正则表达式中添加 s (DOTALL) 修饰符，可以轻松解决这一问题，使 . 能够匹配所有字符，包括换行符。同时，为了确保程序的健壮性，始终建议在文件操作后检查 file_get_contents 的返回值，以避免因文件读取失败而导致的后续错误。理解并合理运用正则表达式修饰符，将大大提升文本处理的效率和准确性。

以上就是PHP preg_match 匹配多行内容：解决 . 无法匹配换行符的问题的详细内容，更多请关注php中文网其它相关文章！