preg_match()返回1/0/false而非匹配结果，真正结果存于引用参数$matches中；需初始化并严格比较===1来安全使用。
preg_match() 返回值不是匹配结果，而是匹配状态
很多人以为 preg_match() 返回的是匹配到的字符串或数组，其实它只返回 1（匹配成功）、0（未匹配）或 false（正则语法错误）。真正存放结果的是传入的第三个参数（引用变量），这点极易混淆。
常见错误现象：直接用 if (preg_match(...)) { echo $matches[0]; } —— 若未匹配，$matches 未定义，会触发 Notice；若正则出错，preg_match() 返回 false，但 $matches 可能还是旧值，造成误判。
- 必须显式初始化
$matches = []或用isset($matches)判断是否被赋值 - 检查
preg_match()返回值是否为1，而非真值（因为false == 0在松散比较下为 true） - 推荐写法：
if (preg_match($pattern, $subject, $matches) === 1) { /* 安全使用 $matches */ }
preg_match_all() 的返回值和 $matches 结构需区分单次/多次匹配
preg_match_all() 返回匹配到的次数（int），而 $matches 是二维数组：索引 0 存所有完整匹配，后续索引对应捕获组。若没匹配，$matches 不会被修改（仍为空或保持原值），且返回值为 0。
容易踩的坑是把 $matches[0] 当作“第一个匹配项”，却忽略它其实是“全部完整匹配组成的数组”——比如 preg_match_all('/\d+/', 'a1b22c333', $m) 后，$m[0] === ['1', '22', '333']，不是 '1'。
立即学习“PHP免费学习笔记（深入）”；
- 要取全部匹配字符串，用
$matches[0] - 要取第一个捕获组的所有匹配，用
$matches[1] - 单次匹配推荐用
preg_match()；需全部结果才用preg_match_all() - 若正则含命名捕获组（如
(?P<year>\d{4})</year>），$matches['year']也存在，但注意键名大小写敏感
如何安全判断变量是否为 preg_* 函数产生的匹配结果数组
PHP 没有内置函数判断一个变量是不是“正则匹配结果”，但可通过结构特征识别：is_array($var) && isset($var[0]) && is_string($var[0]) 是基本前提，但还不够——普通数组也可能满足。
更稳妥的方式是结合上下文和生成逻辑：只有你调用 preg_match() 或 preg_match_all() 并传入引用变量时，那个变量才可能是匹配结果。不要试图反向推断任意数组是否“来自正则”。
- 避免用
is_array($x) && array_keys($x) === [0]判定——preg_match()成功时$matches至少含[0]，但失败时不被赋值，所以空数组 ≠ 匹配失败 - 若需统一处理，建议封装函数，如
safe_preg_match($p, $s, &$out)，内部做返回值校验并清空$out以防残留 - 调试时可用
var_dump($matches)看结构：成功时是索引数组，首项为完整匹配字符串；失败时变量未变（注意作用域）
preg_replace() 和 preg_filter() 的返回值类型完全不同
preg_replace() 成功时返回替换后的字符串，失败（无匹配）时也返回原字符串；只有发生正则编译错误时才返回 null。它不产生类似 $matches 的结果数组。
preg_filter() 则不同：仅当有匹配时才返回替换结果，否则返回 null。这个 null 常被误认为“失败”，其实是设计行为——用来过滤掉不匹配的项。
- 别用
preg_replace()的返回值去判断是否匹配：它几乎总是返回字符串 - 需要“有匹配才处理”的逻辑，优先选
preg_filter()，再用is_null()判定 - 若同时需要匹配内容和替换结果，先用
preg_match_all()获取$matches，再用preg_replace()执行替换，避免重复解析
实际开发中，最常被忽略的是：$matches 变量在 preg_match() 调用前未初始化，且在条件分支外被读取——此时它的值取决于上一次调用或作用域初始值，导致偶发性 bug。
