preg_match_all

参数

pattern

要搜索的模式，以字符串形式。

subject

输入字符串。

matches

根据 flags 对所有匹配项进行排序的多维数组。

flags

可以是以下标志的组合（请注意，将 PREG_PATTERN_ORDER 与 PREG_SET_ORDER 结合使用没有意义）

PREG_PATTERN_ORDER

对结果进行排序，以便 $matches[0] 是一个包含完整模式匹配的数组，$matches[1] 是一个包含第一个带括号的子模式匹配的字符串的数组，依此类推。

<?php
preg_match_all("|<[^>]+>(.*)</[^>]+>|U",
"<b>example: </b><div align=left>this is a test</div>",
$out, PREG_PATTERN_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>

上面的例子将输出

<b>example: </b>, <div align=left>this is a test</div>
example: , this is a test

所以，$out[0] 包含一个包含与完整模式匹配的字符串的数组，而 $out[1] 包含一个包含由标签包围的字符串的数组。

如果模式包含命名子模式，则 $matches 还会包含具有子模式名称的键的条目。

如果模式包含重复的命名子模式，则只有最右边的子模式存储在 $matches[NAME] 中。

<?php
preg_match_all(
'/(?J)(?<match>foo)|(?<match>bar)/',
'foo bar',
$matches,
PREG_PATTERN_ORDER
);
print_r($matches['match']);
?>

上面的例子将输出

Array
(
    [0] => 
    [1] => bar
)

PREG_SET_ORDER

对结果进行排序，以便 $matches[0] 是一个包含第一组匹配项的数组，$matches[1] 是一个包含第二组匹配项的数组，依此类推。

<?php
preg_match_all("|<[^>]+>(.*)</[^>]+>|U",
"<b>example: </b><div align=\"left\">this is a test</div>",
$out, PREG_SET_ORDER);
echo $out[0][0] . ", " . $out[0][1] . "\n";
echo $out[1][0] . ", " . $out[1][1] . "\n";
?>

上面的例子将输出

<b>example: </b>, example:
<div align="left">this is a test</div>, this is a test

PREG_OFFSET_CAPTURE

如果传递了此标志，则对于每个出现的匹配项，还将返回附加的字符串偏移量（以字节为单位）。请注意，这会将 matches 的值更改为一个数组的数组，其中每个元素都是一个数组，包含在偏移量 0 处的匹配字符串，以及它在 subject 中的字符串偏移量，在偏移量 1 处。

<?php
preg_match_all('/(foo)(bar)(baz)/', 'foobarbaz', $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>

上面的例子将输出

Array
(
    [0] => Array
        (
            [0] => Array
                (
                    [0] => foobarbaz
                    [1] => 0
                )

        )

    [1] => Array
        (
            [0] => Array
                (
                    [0] => foo
                    [1] => 0
                )

        )

    [2] => Array
        (
            [0] => Array
                (
                    [0] => bar
                    [1] => 3
                )

        )

    [3] => Array
        (
            [0] => Array
                (
                    [0] => baz
                    [1] => 6
                )

        )

)

PREG_UNMATCHED_AS_NULL

如果传递了此标志，则未匹配的子模式将被报告为 null；否则，它们将被报告为空 字符串。

如果没有给出顺序标志，则假定为 PREG_PATTERN_ORDER。

offset

通常，搜索从主题字符串的开头开始。可选参数 offset 可用于指定要开始搜索的替代位置（以字节为单位）。

注意:

使用 offset 不等同于将 substr($subject, $offset) 传递给 preg_match_all() 以代替主题字符串，因为 pattern 可以包含断言，例如 ^、$ 或 (?<=x)。有关示例，请参阅 preg_match()。