PHP使用str_replace替换HTML模板变量时字符串点自动转为横杠问题求助

str_replace()是PHP原生的严格字符串匹配替换函数，本身不存在自动将点转换为横杠的隐含逻辑，该问题一定是由替换流程前后的其他代码逻辑导致，常见原因如下：

• 输出前的全局过滤逻辑：多数PHP框架、自定义的输出处理组件会对最终输出内容做格式化或安全过滤，比如生成URL友好的slug时，会默认把非字母数字的符号替换为横杠，这类逻辑通常执行在你完成占位符替换之后、内容输出/落盘之前。
• 模板引擎的后置处理规则：如果你的项目使用了Twig、Smarty等模板引擎，或者自定义了模板读取、渲染的钩子，可能存在全局替换点为横杠的配置，会在占位符替换完成后自动触发。
• 变量被提前修改：你赋值给$var的内容可能在传递到替换逻辑前就已经被其他过滤代码处理过，并非你预期的example.example原始值。

• 先定位转换逻辑的触发位置：在替换逻辑执行前后分别打印变量和模板值，确认转换发生的阶段：

$var = "example.example";
$template = file_get_contents($templateFile);
// 打印变量原始值，确认是否已经被转换
var_dump($var);
$template = str_replace("{userName}", $var , $template);
// 替换后立即打印模板，终止后续逻辑，确认替换结果是否正常
var_dump($template);
exit;

如果此时打印的模板内容里点显示正常，说明转换逻辑在这段代码之后的流程中，只需排查后续的全局过滤、输出处理代码即可。

• 调整过滤规则：如果确认是全局过滤逻辑导致，可以将该变量加入过滤白名单，或者使用框架提供的跳过自动过滤的语法输出变量，比如Laravel中使用{!! $value !!}语法即可避免内容被自动转义处理。
• 迂回兼容方案：如果无法修改全局过滤规则，可以用临时占位符的方式规避转换：

// 替换前先把点替换为不会被过滤的特殊标识
$var = str_replace('.', '__TEMP_DOT__', "example.example");
$template = str_replace("{userName}", $var , $template);
// 所有全局处理逻辑执行完成后，再把特殊标识替换回点
$template = str_replace('__TEMP_DOT__', '.', $template);

内容的提问来源于stack exchange，提问作者D.JCode