preg_match()只匹配首个结果,适合判断存在性或提取单个值;preg_match_all()匹配全部,返回总数并支持preg_set_order等排序模式;需注意分隔符配对、u修饰符处理utf-8、错误返回值区分(false为语法错,0为无匹配)。

preg_match() 是 PHP 里最常用的正则匹配函数
它只找第一个匹配项,适合判断“有没有”或提取单个结果。别用 ereg()(已废弃)或 mb_ereg()(不支持 PCRE),PHP 7.0+ 只认 preg_* 系列。
常见错误现象:Warning: preg_match(): Unknown modifier 'x' —— 多半是分隔符没配对,比如写成 preg_match('/abc/i', $str) 却漏了结尾斜杠;或者用了中文标点当分隔符。
- 必须用成对的分隔符包裹模式,常用
/、#、~,避免和模式内字符冲突(比如匹配路径时用#^/user/d+#比/^/user/d+//清爽) - 修饰符写在末尾分隔符后,如
i(忽略大小写)、m(多行模式)、s(点号匹配换行) - 第三个参数
$matches是可选数组,传了才会填充捕获组;不传就只返回 0(无匹配)、1(有匹配)或 false(正则语法错)
preg_match_all() 用来找全部匹配
当你需要提取所有邮箱、所有 URL、所有数字片段时,必须用它。它不会中途退出,会扫完整个字符串。
使用场景:日志解析、HTML 片段提取、批量替换前的预检。
立即学习“PHP免费学习笔记(深入)”;
10分钟内自己学会PHP其中,第1篇为入门篇,主要包括了解PHP、PHP开发环境搭建、PHP开发基础、PHP流程控制语句、函数、字符串操作、正则表达式、PHP数组、PHP与Web页面交互、日期和时间等内容;第2篇为提高篇,主要包括MySQL数据库设计、PHP操作MySQL数据库、Cookie和Session、图形图像处理技术、文件和目录处理技术、面向对象、PDO数据库抽象层、程序调试与错误处理、A
- 返回匹配总数(int),不是布尔值;匹配结果默认存在
$matches[0](全匹配)、$matches[1](第一个捕获组)…… - 注意
PREG_SET_ORDER和PREG_PATTERN_ORDER的区别:前者按“每次匹配为一行”,后者按“每个捕获组为一行”,日常提取字段推荐用PREG_SET_ORDER - 性能影响:如果字符串超长、模式又没限制(比如
.*开头),容易回溯爆炸,导致超时;加u修饰符处理 UTF-8 字符串,否则中文可能被截断
匹配失败但没报错?检查定界符和转义
preg_match() 返回 false 表示正则本身写错了(比如括号不配对、量词缺目标),返回 0 才是“没匹配到”。很多人混淆这两者,结果调试半天发现是模式语法问题。
常见错误现象:preg_match('/d{3,5}/', '12') === 0(正常) vs preg_match('/d{3,5/', '123') === false(少了个 })。
- Windows 路径里的反斜杠要双写:
'C:\\Program Files\\',不然会被 PHP 字符串解析吃掉一层 - 匹配美元符号
$时,要么用$,要么换分隔符(如#$#),否则它会被当成行尾锚点 - 用
var_dump(preg_last_error())查错误码,PREG_NO_ERROR以外的值说明模式非法
中文、emoji、生僻字匹配必须加 u 修饰符
不加 u,preg_match('/./u', '?') 能正确匹配一个 Unicode 字符;不加的话,可能只取前两个字节,导致乱码或空匹配。
兼容性影响:PHP 5.3.4+ 支持 u,老环境(如某些嵌入式 PHP)可能不支持,但现代项目基本不用考虑。
-
[u4e00-u9fa5]这种写法无效 —— PCRE 不识别u,得用x{4e00}-x{9fa5}并确保有u - emoji 如 ? 是四字节 UTF-8,没
u修饰符时会被切成两半,匹配失败 - 函数名带
mb_前缀的(如mb_eregi())都不处理 Unicode 正则,别混用
preg_last_error() 和实际返回值类型,比反复改模式更省时间。










