preg_replace 返回 null 的根本原因是 $subject 参数为 null。PHP 要求该参数必须是字符串或数组，传入 null 时直接返回 null，不转换、不报错、不警告，且该行为在 PHP 5.6 至 8.x 中一致。
preg_replace 返回 null 的根本原因
preg_replace 返回 null 只有一种情况：传入的 $subject 参数是 null。PHP 官方文档明确要求该参数必须是字符串或数组，若为 null，函数直接返回 null 而非空字符串或原值。
这不是正则写错、模式无效或 PCRE 扩展未启用导致的——那些情况会返回原字符串、false（出错时）或正常替换结果。
- 常见错误现象：
var_dump(preg_replace('/\d+/', 'X', $str))输出NULL，但$str看似“空”，实则是null（比如数据库字段未设默认值、JSON 解析失败后赋值、函数未返回值被直接使用） - 检查方法：不用
empty()或== ''，改用is_null($str)或var_dump($str)确认类型 - 修复建议：在调用前兜底，例如
$subject = $str ?? ''或is_string($str) ? $str : ''
为什么不是 false 或警告？
PHP 的 preg_replace 对 null 输入不做类型转换，也不触发 E_WARNING。它把 null 当作非法类型直接短路返回 null，行为类似严格模式下的函数参数校验失败。
- 对比
preg_match：同样接收null时也返回null，不是false - 对比
str_replace：会把null转成空字符串再处理，所以不会返回null - 兼容性注意：PHP 7.4+ 和 8.x 行为一致；低版本（如 5.6）也是同样逻辑，无版本差异
容易混淆的其他“看似 null”的情况
实际返回的是空字符串 ''、false 或原始字符串，但开发者误判为 null：
立即学习“PHP免费学习笔记（深入）”；
-
false：正则语法错误（如括号不匹配）、PCRE 编译失败（Warning: preg_replace(): Compilation failed） - 空字符串
''：替换成功但结果为空，例如preg_replace('/.*/', '', 'hello') - 原字符串未变：模式完全不匹配，例如
preg_replace('/xyz/', 'a', 'abc')返回'abc' - 调试建议：别只看
echo或print_r，用var_dump($result)明确区分null、''、false
安全调用 preg_replace 的惯用写法
避免意外传入 null，同时兼顾可读性和健壮性：
if (!is_string($input) && !is_array($input)) {
$input = '';
}
$result = preg_replace($pattern, $replacement, $input);
- 不推荐
(string)$input强转：数组会变成'Array'，null变成''，但掩盖了数据来源问题 - 更推荐业务层提前校验：比如从
$_GET['q']取值时，用$_GET['q'] ?? ''；从数据库取值时，确认字段允许为空并设好默认值 - 如果必须支持数组输入，确保每个元素都是字符串，否则数组中混入
null仍会导致对应位置返回null
null 从哪来——它往往暴露了上游数据流没做类型约束或错误处理。盯住 var_dump 输出的类型，比反复调正则更容易定位问题。 
