本文介绍如何将 json 格式的映射规则（原始词 → 替换词）解析为 php 数组，并利用 `str_ireplace()` 安全、高效地完成大小写不敏感的批量字符串替换。

在 PHP 开发中，常需根据动态配置（如 JSON 文件或 API 返回）对文本执行多组搜索与替换操作。但直接将 JSON 字符串当作数组使用会导致错误——例如 array_keys() 无法作用于字符串，json_decode() 也未被调用，这是原代码失效的根本原因。

正确做法是：先解码 JSON 字符串为关联数组，再提取 Original 和 Replacement 字段分别构成搜索与替换数组。以下是完整、健壮的实现：

';
echo 'Replace:  ' . htmlspecialchars($text2);
// 输出：Replace:  Hello test1a, let me see if test2a is also replaced...
?>

? 关键注意事项：

• json_decode($json, true) 的第二个参数必须为 true，否则返回对象而非数组，array_column() 将失败；
• 确保 JSON 格式严格合法（推荐用 json_last_error() 检查解码结果）；
• str_ireplace() 是顺序匹配、全局替换，且不支持正则；若需更精确控制（如单词边界、正则替换），应改用 preg_replace_callback() 配合 preg_quote() 转义关键词；
• 若 JSON 中存在重复 Original 值，后出现的会覆盖前者（因 array_column 生成索引数组时键名不唯一，但 str_ireplace 本身按数组顺序处理，故实际以输入顺序为准）；
• 对用户输入或不可信 JSON，务必做异常处理：

if (json_last_error() !== JSON_ERROR_NONE) {
    throw new InvalidArgumentException('Invalid JSON format: ' . json_last_error_msg());
}

掌握这一模式后，你可轻松扩展为从文件读取 JSON 配置、结合数据库动态生成替换规则，或封装为可复用的工具函数，大幅提升文本处理的灵活性与可维护性。