PHP 正则表达式(PCRE)

正则表达式(regular expression)描述了一种字符串匹配的模式，可以用来检查一个串是否含有某种子串、将匹配的子串做替换或者从某个串中取出符合某个条件的子串等。

更多正则表达式的内容可参考我们的：正则表达式 - 教程。

PHP 中使用正则表达式主要通过一组内置的函数，其中最常用的是:

preg_match(): 在字符串中搜索匹配的模式，只返回第一个匹配项。
preg_match_all(): 在字符串中搜索匹配的模式，返回所有匹配项。
preg_replace(): 在字符串中搜索匹配的模式，然后进行替换。

preg_match() 函数

preg_match() 函数用于在字符串中搜索匹配的模式，只返回第一个匹配项。

preg_match(pattern, subject, matches)

参数说明：

pattern：正则表达式模式。
subject：要搜索的字符串。
matches：可选参数，用于存储匹配的结果。

实例

<?php
$str = "Hello, World!";
$pattern = "/Hello/";
if (preg_match($pattern, $str, $matches)) {
echo "匹配成功!" . PHP_EOL;
print_r($matches);
} else {
echo "没有匹配到!";
}
?>

以上代码输出结果为：

匹配成功!
Array
(
    [0] => Hello
)

preg_match_all() 函数

preg_match_all() 函数用于在字符串中搜索匹配的模式，返回所有匹配项。

preg_match_all(pattern, subject, matches)

参数说明：

用于在字符串中搜索匹配的模式，返回所有匹配项。
pattern：正则表达式模式。
subject：要搜索的字符串。
matches：用于存储所有匹配结果的数组。

实例

<?php
$str = "The cat and the hat";
$pattern = "/[aeiou]/";
if (preg_match_all($pattern, $str, $matches)) {
echo "匹配的元音字母: " . implode(", ", $matches[0]);
} else {
echo "没有匹配到!";
}
?>

以上代码输出结果为：

匹配的元音字母: e, a, a, e, a

preg_replace() 函数

preg_replace() 函数用于在字符串中搜索匹配的模式，然后进行替换。

preg_replace(pattern, replacement, subject)

参数说明：

pattern：正则表达式模式。
replacement：替换的字符串。
subject：要搜索的字符串。

实例

<?php
$str = "I love PHP";
$pattern = "/PHP/";
$replacement = "RUNOOB";
$new_str = preg_replace($pattern, $replacement, $str);
echo "替换后的字符串: " . $new_str;
?>

以上代码输出结果为：

替换后的字符串: I love RUNOOB

PCRE 函数

PHP 中我们可以使用 PCRE 扩展来匹配字符串的模式。

函数	描述
preg_filter	执行一个正则表达式搜索和替换
preg_grep	返回匹配模式的数组条目
preg_last_error	返回最后一个PCRE正则执行产生的错误代码
preg_match_all	执行一个全局正则表达式匹配
preg_match	执行一个正则表达式匹配
preg_quote	转义正则表达式字符
preg_replace_callback_array	执行一个正则表达式搜索并且使用一个回调进行替换
preg_replace_callback	执行一个正则表达式搜索并且使用一个回调进行替换
preg_replace	执行一个正则表达式的搜索和替换
preg_split	通过一个正则表达式分隔字符串

PREG 常量

常量	描述	自哪个版本起
`PREG_PATTERN_ORDER`	结果按照"规则"排序，仅用于preg_match_all()，即$matches[0]是完整规则的匹配结果， $matches[1]是第一个子组匹配的结果，等等。	since
`PREG_SET_ORDER`	结果按照"集合"排序，仅用于preg_match_all()，即$matches[0]保存第一次匹配结果的所有结果(包含子组)信息, $matches[1]保存第二次的结果信息，等等。
`PREG_OFFSET_CAPTURE`	查看`PREG_SPLIT_OFFSET_CAPTURE`的描述。	4.3.0
`PREG_SPLIT_NO_EMPTY`	这个标记告诉 preg_split() 进返回非空部分。
`PREG_SPLIT_DELIM_CAPTURE`	这个标记告诉 preg_split() 同时捕获括号表达式匹配到的内容。	4.0.5
`PREG_SPLIT_OFFSET_CAPTURE`	如果设置了这个标记，每次出现的匹配子串的偏移量也会被返回。注意，这会改变返回数组中的值，每个元素都是由匹配子串作为第0个元素，它相对目标字符串的偏移量作为第1个元素的数组。这个标记只能用于 preg_split()。	4.3.0
`PREG_NO_ERROR`	没有匹配错误时调用 preg_last_error() 返回。	5.2.0
`PREG_INTERNAL_ERROR`	如果有PCRE内部错误时调用 preg_last_error() 返回。	5.2.0
`PREG_BACKTRACK_LIMIT_ERROR`	如果调用回溯限制超出，调用preg_last_error()时返回。	5.2.0
`PREG_RECURSION_LIMIT_ERROR`	如果递归限制超出，调用preg_last_error()时返回。	5.2.0
`PREG_BAD_UTF8_ERROR`	如果最后一个错误时由于异常的utf-8数据(仅在运行在 UTF-8 模式正则表达式下可用)。导致的，调用preg_last_error()返回。	5.2.0
`PREG_BAD_UTF8_OFFSET_ERROR`	如果偏移量与合法的urf-8代码不匹配(仅在运行在 UTF-8 模式正则表达式下可用)。调用preg_last_error()返回。	5.3.0
`PCRE_VERSION`	PCRE版本号和发布日期(比如： "7.0 18-Dec-2006")。	5.2.4

返回顶部

菜鸟教程

PHP 正则表达式(PCRE)

preg_match() 函数

实例

preg_match_all() 函数

实例

preg_replace() 函数

实例

PCRE 函数

PREG 常量