本文详解如何在 Laravel 中利用 Str::replaceMatches() 配合闭包与 use 关键字，安全、灵活地将字符串中形如 {{ client_given_name }} 的占位符，精准替换为对应 Eloquent 模型的属性值。
本文详解如何在 laravel 中利用 `str::replacematches()` 配合闭包与 `use` 关键字，安全、灵活地将字符串中形如 `{{ client_given_name }}` 的占位符，精准替换为对应 eloquent 模型的属性值。
在 Laravel 应用中，常需将数据库中存储的模板化文案（如邮件正文、通知消息）动态渲染为个性化内容。例如，原始字符串为：
Hi my name is {{ client_given_name }} and I live in {{ client_city }}.
而目标是将其替换为：
Hi my name is John and I live in Paris.
关键在于：占位符命名（如 client_given_name）需映射到 Eloquent 模型的实际属性（如 $client->given_name），且需规避变量作用域问题。
✅ 正确实现方式
Laravel 的 IlluminateSupportStr 提供了链式方法 replaceMatches()，支持传入正则模式和回调函数。但回调函数默认无法访问外部变量（如 $client），必须显式通过 use 导入：
use IlluminateSupportStr;
$client = Client::find(1);
$content = 'Hi my name is {{ client_given_name }} and I live in {{ client_city }}.';
$replaced = Str::of($content)->replaceMatches('/{{([^}]+)}}/', function ($matches) use ($client) {
$placeholder = trim($matches[1]); // 如 "client_given_name"
// 将 client_前缀 + 下划线命名 转为驼峰属性名（可选，增强健壮性）
$attribute = preg_replace_callback('/_([a-z])/', function ($m) {
return strtoupper($m[1]);
}, str_replace('client_', '', $placeholder));
// 安全获取属性值：支持 null 合并与不存在属性兜底
return $client->{$attribute} ?? '';
});
// 输出：Hi my name is John and I live in Paris.
echo $replaced;
? 正则说明与注意事项
-
正则
/\{\{([^}]+)\}\}/：-
\{\{和\}\}匹配双大括号（注意 PHP 字符串中反斜杠需转义）； -
([^}]+)捕获内部非}字符，避免贪婪匹配跨占位符； - 更严谨可写为
/\{\{\s*([^}\s]+)\s*\}\}/支持空格容错。
-
属性映射建议：
若模板约定client_given_name→ 模型属性given_name，推荐封装转换逻辑（如上述preg_replace_callback），而非硬编码switch。这样更易维护、可扩展。-
安全性保障：
- 始终使用
?? ''或data_get($client, $attribute, '')防止未定义属性触发ErrorException； - 避免直接拼接用户输入占位符，防止属性注入（如
{{ id; phpinfo() }}），本例因占位符来自可信模板，风险可控。
- 始终使用
? 总结
核心要点有三：
1️⃣ 使用 use ($client) 将模型实例注入闭包作用域；
2️⃣ 正则捕获组 ([^}]+) 精准提取占位符名，避免误匹配；
3️⃣ 属性名转换与空值处理缺一不可，确保渲染鲁棒性。
此方案轻量、无额外依赖，完美契合 Laravel 生态，适用于邮件模板、动态页面文案、自定义通知等多场景。
