PHP preg_replace正则编译报错偏移量2处量词无匹配可重复项

问题原因 #

1. 正则语法错误：配置中的正则表达式 !/(+*?)/images/! 存在语法问题。+、*、? 都属于正则量词，作用是修饰前面匹配项的重复次数，不能单独作为匹配项使用。报错信息中提到的 offset 2 就是指正则字符串从0开始计数的第2位，也就是+字符，违反了正则语法规则。
2. 错误静默处理逻辑：__invoke 方法中，preg_replace 执行失败时会返回null，你代码中写了return $text ?? $html，所以正则报错时会直接返回原始HTML内容，不会执行替换逻辑，同时抛出PHP Warning，就是你看到的“代码能正常运行但替换不生效”的现象。

解决方案 #

• 修正正则表达式
  如果你是要匹配路径中第一个斜杠后、/images/前的任意非空内容，大概率是你写正则时漏了匹配任意字符的.，把正则修改为：
  'regex' => '!/(.+?)/images/!',
  如果你确实是要匹配+、*、?这三个特殊字符本身，需要给量词加转义符：
  'regex' => '!/(\+|\*|\?)/images/!',

• 可选优化：增加正则合法性校验
  可以在__invoke方法中增加前置校验逻辑，避免后续出现类似静默失败的问题，修改后代码参考：

public function __invoke(string $html, array $params = []) : string
{
    $regex = $params['regex'] ?? '';
    $replace = $params['replace'] ?? '';
    if (!empty($regex)) {
        // 先校验正则合法性
        $validateResult = @preg_match($regex, '');
        if ($validateResult === false) {
            // 正则非法时可根据业务需要打日志或者抛出异常，这里示例直接返回原内容
            error_log("正则语法错误：{$regex}，错误信息：" . preg_last_error_msg());
            return $html;
        }
        $text = preg_replace($regex, $replace, $html);
    } else {
        $text = $html;
    }
    return $text ?? $html;
}

内容的提问来源于stack exchange，提问作者dougB