本文介绍如何在 PHP 中读取 JSON 格式的多语言文件，并安全、灵活地将占位符（如 {user}）替换为实际变量值，实现可复用的国际化消息模板系统。
本文介绍如何在 php 中读取 json 格式的多语言文件，并安全、灵活地将占位符（如 `{user}`）替换为实际变量值，实现可复用的国际化消息模板系统。
在 Web 开发中，将语言文本与业务逻辑分离是最佳实践之一。JSON 是一种轻量、易读且广泛支持的格式，常被用于存储多语言资源（如 lang/en.json）。但原生 JSON 不支持变量插值——它只保存静态字符串。要实现类似 "Hello {user}" → "Hello rawohah211" 的动态渲染，需在 PHP 层完成占位符解析，而非依赖 JSON 本身。
✅ 正确实现方式：解码 → 模板替换 → 输出
首先，确保 JSON 文件结构清晰、语义明确：
// lang/en.json
{
"user": {
"hello": "Hello {user}",
"welcome_back": "Welcome back, {user}! You have {unread} unread messages.",
"error_missing": "Required field '{field}' is missing."
}
}接着，在 PHP 中加载并安全替换占位符：
<?php
// 1. 读取并解析 JSON（推荐使用关联数组，更易操作）
$json = file_get_contents('lang/en.json');
$lang = json_decode($json, true); // 第二个参数 true → 返回 array 而非 stdClass
// 2. 定义安全的占位符替换函数
function msg(string $template, array $replacements = []): string {
$output = $template;
foreach ($replacements as $key => $value) {
// 使用花括号包裹键名，避免误替换（如 'user' 匹配到 'username'）
$placeholder = '{' . $key . '}';
$output = str_replace($placeholder, htmlspecialchars((string)$value, ENT_QUOTES, 'UTF-8'), $output);
}
return $output;
}
// 3. 使用示例
echo msg($lang['user']['hello'], ['user' => 'rawohah211']);
// 输出：Hello rawohah211
echo msg($lang['user']['welcome_back'], [
'user' => 'Alice',
'unread' => 3
]);
// 输出：Welcome back, Alice! You have 3 unread messages.
?>⚠️ 关键注意事项
- 安全性优先：所有用户输入或动态变量必须经 htmlspecialchars() 过滤，防止 XSS（尤其在输出到 HTML 页面时）；
- 占位符命名规范：统一使用 {key} 格式，避免与 JSON 键名冲突，也便于正则扩展（如后续支持 {user|ucfirst}）；
- 缺失占位符处理：可增强 msg() 函数，在检测未提供对应 key 时返回警告或保留原始占位符（如 "{user}"），便于调试；
- 性能考虑：语言文件建议一次性加载并缓存（如 APCu 或 $_SERVER['lang_cache']），避免重复 I/O；
- 不推荐直接 eval() 或 sprintf：sprintf 要求严格顺序与类型，缺乏可读性；eval 存在严重安全隐患，绝对禁用。
✅ 进阶建议（可选）
若需更强大能力（如嵌套表达式、条件渲染、复数规则），可引入轻量模板引擎（如 League/Plates）或升级至专业 i18n 方案（如 Symfony Translation 或 PHP-Gettext），它们原生支持占位符、上下文、域划分和 ICU 格式。
立即学习“PHP免费学习笔记（深入）”；
总之，JSON 本身不是模板语言，但它可以作为优质的数据载体；真正的“变量注入”逻辑应在 PHP 层稳健、安全地实现——这正是解耦设计与工程可控性的体现。
