PHP preg_match_all() 函数 - PHP 5 函数参考手册

PHP preg_last_error() 函数用于执行一个全局正则表达式匹配

函数原型

int preg_match_all ( string $pattern , string $subject [, array &$matches [, int $flags = PREG_PATTERN_ORDER [, int $offset = 0 ]]] )

搜索 subject 中所有匹配 pattern 给定正则表达式的匹配结果并且将它们以 flag 指定顺序输出到 matches 中

在第一个匹配找到后, 子序列继续从最后一次匹配位置搜索

参数

参数	说明
$pattern	要搜索的模式，字符串形式
$subject	输入字符串
$matches	多维数组，作为输出参数输出所有匹配结果, 数组排序通过 flags 指定
$flags	标记，见下面的列表
$offset	通常，查找时从目标字符串的开始位置开始可选参数offset用于从目标字符串中指定位置开始搜索(单位是字节)

$flags 可用标记如下

可以结合下面标记使用

注意不能同时使用 PREG_PATTERN_ORDER 和 PREG_SET_ORDER

标记	说明
PREG_PATTERN_ORDER	结果排序为 $matches[0] 保存完整模式的所有匹配, $matches[1] 保存第一个子组的所有匹配，以此类推
PREG_SET_ORDER	结果排序为 $matches[0] 包含第一次匹配得到的所有匹配(包含子组)， $matches[1]是包含第二次匹配到的所有匹配(包含子组)的数组，以此类推
PREG_OFFSET_CAPTURE	如果这个标记被传递，每个发现的匹配返回时会增加它相对目标字符串的偏移量

返回值

返回完整匹配次数（可能是0），或者如果发生错误返回 FALSE

范例

下面的范例查找匹配 <b> 与 </b> 标签的内容

<?php
$userinfo = "Name: <b>PHP</b> <br> Title: <b>Programming Language</b>";
preg_match_all ("/<b>(.*)<\/b>/U", $userinfo, $pat_array);
print_r($pat_array[0]);

运行以上 PHP 范例，输出结果如下

array
(
    [0] => <b>PHP</b>
    [1] => <b>Programming Language</b>
)

范例 2

查找匹配的 HTML 标签（贪婪）

<?php
// \\2是一个后向引用的示例
// 这会告诉 pcre 它必须匹配正则表达式中第二个圆括号(这里是([\w]+))
// 
// 匹配到的结果. 这里使用两个反斜线是因为这里使用了双引号


$html = "<b>bold text</b><a href=howdy.html>click me</a>";

preg_match_all("/(<([\w]+)[^>]*>)(.*?)(<\/\\2>)/", $html, $matches, PREG_SET_ORDER);

foreach ($matches as $val) 
{
    echo "matched: " . $val[0] . "\n";
    echo "part 1: " . $val[1] . "\n";
    echo "part 2: " . $val[2] . "\n";
    echo "part 3: " . $val[3] . "\n";
    echo "part 4: " . $val[4] . "\n\n";
}

运行以上 PHP 范例，输出结果如下

matched: <b>bold text</b>
part 1: <b>
part 2: b
part 3: bold text
part 4: </b>

matched: <a href=howdy.html>click me</a>
part 1: <a href=howdy.html>
part 2: a
part 3: click me
part 4: </a>