PHP模板引擎变量替换：str_replace()批量注入保姆级教程-php教程-PHP中文网

str_replace()模板替换需防重复替换、大小写敏感、边界冲突和嵌套失效；应批量替换、加边界保护、扁平化点语法数据、转义值并检查未定义变量。

php模板引擎变量替换：str_replace()批量注入保姆级教程

直接用 str_replace() 做模板变量替换，简单快、不依赖扩展，适合轻量场景——但容易踩坑：重复替换、大小写敏感、边界冲突、嵌套失效。关键不是“能不能换”，而是“怎么换得安全又可控”。

一、基础用法：一对一批量替换（最常用）

把模板中形如 {{name}}、{{email}} 的占位符，替换成实际值。

推荐用 str_replace() 的数组批量模式，避免多次调用：

$template = '欢迎 {{name}}，您的邮箱是 {{email}}。';
$data = [
    'name'  => '张三',
    'email' => 'zhang@example.com'
];
$keys   = array_map(fn($k) => "{{{$k}}}", array_keys($data));
$result = str_replace($keys, array_values($data), $template);
// 输出：欢迎 张三，您的邮箱是 zhang@example.com。

二、防误替：加边界保护，避免子串污染

如果模板含 {{name}}，而数据里又有 name_short，直接替换会出错：

// ❌ 危险！
$data = ['name' => '李四', 'name_short' => '小李'];
str_replace(['{{name}}', '{{name_short}}'], [...], $tpl); // 若先替 name，{{name_short}} 可能被误切

解决办法：确保占位符是独立词元。用正则更稳妥，但若坚持用 str_replace()，可约定统一前缀+后缀（如 [[name]]），或人工保证键名无包含关系。更推荐升级为：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

用 preg_replace_callback() 精确匹配 {{\w+}}
或预处理键名，按长度倒序排序再替换（长键优先）

三、支持点语法：如 {{user.profile.avatar}}（需解析）

str_replace() 本身不解析结构，但你可以提前扁平化数据：

$data = [
    'user' => [
        'profile' => ['avatar' => '/img/1.png']
    ]
];
// 扁平成：
$flat = [
    'user.profile.avatar' => '/img/1.png',
    'user.profile.name'   => '王五'
];
$keys = array_map(fn($k) => "{{{$k}}}", array_keys($flat));
$result = str_replace($keys, array_values($flat), $template);

扁平化可用递归函数实现，注意控制嵌套深度防爆栈。