本教程旨在解决 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 数组为空。
解决方案：使用 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 的返回值，以避免因文件读取失败而导致的后续错误。理解并合理运用正则表达式修饰符，将大大提升文本处理的效率和准确性。
