本文讲解如何在 PHP 中读取 JSON 语言文件，并安全、灵活地将运行时变量（如用户名）注入其中的占位符（如 {user}），实现国际化文本的动态渲染。
本文讲解如何在 php 中读取 json 语言文件，并安全、灵活地将运行时变量（如用户名）注入其中的占位符（如 `{user}`），实现国际化文本的动态渲染。
在 Web 开发中，将语言文本与逻辑代码分离是最佳实践之一。JSON 是一种轻量、可读性强且广泛支持的格式，常被用作多语言资源文件（如 lang/en.json）。但 JSON 本身是纯数据格式，不支持直接嵌入 PHP 变量或执行表达式。因此，实现类似 "Hello {user}" → "Hello rawohah211" 的效果，需在 PHP 层完成「模板解析」，而非依赖 JSON 的语法能力。
✅ 正确实现思路：加载 + 占位符替换
核心流程如下：
- 使用 file_get_contents() 读取 JSON 文件；
- 用 json_decode() 解析为 PHP 对象或关联数组；
- 提取目标字符串；
- 通过 str_replace()（或更健壮的 preg_replace_callback()）替换占位符；
- 输出最终文本。
以下是一个完整、可复用的示例：
<?php
// 1. 加载并解析语言文件（推荐使用关联数组，便于键名访问）
$json = file_get_contents('lang/en.json');
$lang = json_decode($json, true); // 第二个参数 true → 返回 array 而非 object
// 2. 定义待注入的数据（可来自用户输入、数据库等）
$replacements = [
'{user}' => 'rawohah211',
'{count}' => '3',
'{action}' => 'deleted'
];
// 3. 提取原始消息并执行批量替换
$message = $lang['user']['hello'] ?? '';
$result = str_replace(array_keys($replacements), array_values($replacements), $message);
echo $result; // 输出：Hello rawohah211
?>对应 lang/en.json 内容示例：
立即学习“PHP免费学习笔记（深入）”；
{
"user": {
"hello": "Hello {user}",
"welcome": "Welcome back, {user}! You have {count} new notifications.",
"confirm": "Are you sure you want to {action} this item?"
}
}⚠️ 注意事项与进阶建议
- 安全性优先：若占位符内容来自用户输入（如 $replacements['{user}'] = $_GET['name']），务必对值进行过滤（如 htmlspecialchars()）以防止 XSS（尤其在 HTML 上下文中输出时）。
-
避免硬编码占位符：可封装为函数提升复用性：
function renderMessage($lang, $path, $replacements = []) { $message = array_key_exists($path, $lang) ? $lang[$path] : ''; return str_replace(array_keys($replacements), array_values($replacements), $message); } // 调用：echo renderMessage($lang, 'user.hello', ['{user}' => 'rawohah211']); - 支持嵌套路径与更强大语法：如需 {user.name} 或 {{ user }} 等高级模板语法，建议集成轻量模板引擎（如 Plates）或使用 preg_replace_callback() 实现自定义解析器。
- 性能考虑：对于高频调用场景，建议将 JSON 缓存至 APCu 或 OPcache，避免重复 I/O 和解析开销。
✅ 总结
JSON 不是模板语言，但它可以作为结构化语言资源的优秀载体。真正的「变量注入」必须由 PHP 在运行时完成——通过 json_decode() 获取数据，再借助字符串替换或正则匹配实现动态渲染。这种方式兼顾了可维护性、可读性与安全性，是构建国际化（i18n）应用的标准实践之一。
