thinkphp8中正则替换必须使用str::replace()封装方法，不可直接调用preg_replace；需传入带分隔符的完整正则字符串，支持反向引用但不支持数组批量处理，且受全局过滤影响导致输出差异。
ThinkPHP8中正则替换的封装调用方式
在ThinkPHP8项目里做字符串清洗、URL重写或日志脱敏时，不能直接套用PHP原生preg_replace，必须走框架封装的字符串工具类或助手函数，否则会绕过全局过滤钩子、丢失上下文配置。
第一步：引入think\helper\Str类 → 第二步：调用静态方法replace()
例如将所有手机号中间四位替换成星号：Str::replace('/1[3-9]\d{9}/', '1****5678', $content)。注意这里第一个参数是正则表达式字符串，不是数组；第二个参数是替换内容，支持$1这类反向引用；第三个参数才是原始字符串。
【必须传入完整正则字符串，不能省略分隔符】比如写'/1[3-9]\d{9}/'是对的，写'1[3-9]\d{9}'会触发InvalidArgumentException异常，因为框架内部未自动补充分隔符。
PHP原生preg_replace的底层行为差异
PHP8.5.5中preg_replace默认启用JIT编译加速，对重复使用的正则模式自动缓存PCRE2字节码；但ThinkPHP8的Str::replace不共享该缓存，每次调用都重新编译正则——这意味着高频替换场景下，原生函数性能比框架封装高12%~18%。
直接使用preg_replace('/\s+/', ' ', $str)时，若正则含语法错误（如未闭合括号），PHP会抛出Error异常；而Str::replace捕获后转为LogicException并附带模板路径信息，便于定位到具体控制器行号。
preg_replace第三个参数支持数组批量处理，一次替换多个字符串；Str::replace不支持该特性，传入数组会静默转为字符串"Array"再执行替换，结果完全错误。
安全策略导致的替换结果分歧
ThinkPHP8默认开启全局内容过滤，当替换结果中出现<script></script>等危险标签时，Str::replace会自动触发output过滤器二次处理，把尖括号转义为<；而preg_replace输出原样返回，不做任何干预。
方法一：关闭框架自动过滤（仅限可信数据）
在config/app.php中设置'default_filter' => ''，此时Str::replace输出与preg_replace一致。
方法二：保留过滤但手动还原
用htmlspecialchars_decode(Str::replace(...), ENT_QUOTES)逆转转义，但【这会重新暴露XSS风险，仅限已确认内容安全的场景】。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
