HTML模板字符串占位符替换为变量/数组值的最佳实践

给定初始模板代码如下：

$htmlPattern = "User name is: #name# and user company is #company#";

针对#标识#格式的占位符替换需求，适配数组批量传参的最优实现是使用PHP原生strtr函数做键值对映射替换，没有二次替换bug，性能远高于正则和顺序替换方案。

通用可复用实现 #

直接封装成通用函数，后续任意同类场景都可以直接调用：

function fillTemplate(string $template, array $data): string
{
    $replaceMap = [];
    foreach ($data as $key => $val) {
        $replaceMap["#{$key}#"] = $val;
    }
    return strtr($template, $replaceMap);
}

使用示例 #

对应题目里的场景，调用方式非常简单：

// 定义替换值，零散变量或者直接写数组都可以
$name = "John";
$company = "Microsoft";

// 组装替换映射数组，键名就是占位符去掉前后#的部分
$replaceData = [
    'name' => $name,
    'company' => $company
];

echo fillTemplate($htmlPattern, $replaceData);
// 输出结果：User name is: John and user company is Microsoft

方案优势 #

• 不会出现误替换：strtr会一次性解析所有占位符，不会对已经替换完成的内容二次匹配，哪怕替换值里本身带#xxx#格式的内容，也不会被错误替换，比str_replace按顺序替换的逻辑安全很多。
• 性能足够好：作为PHP原生C实现的字符串函数，比正则替换类方案性能高3倍以上，模板越长、占位符越多，性能差距越明显。
• 扩展成本低：后续模板新增占位符不需要修改封装函数，只需要在传入的$data数组里增加对应键值对即可，天然适配批量替换场景。
• 容错性好：模板里存在没有传入对应值的占位符时，会原样保留，不会出现乱码、空值替换的问题，方便排查模板配置错误。

特殊场景可选方案 #

如果你的占位符规则更复杂，比如需要支持带默认值、带格式修饰的占位符，可以用正则回调的方式实现，但是普通固定占位符场景不推荐，性能较差：

// 正则实现（仅用于复杂规则场景）
function fillTemplateRegex(string $template, array $data): string
{
    return preg_replace_callback('/#([a-zA-Z0-9_]+)#/', function($match) use ($data) {
        return array_key_exists($match[1], $data) ? $data[$match[1]] : $match[0];
    }, $template);
}

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