本文介绍如何将 json 格式的映射规则（原始词 → 替换词）解析为 php 数组，并利用 `str_ireplace()` 安全、高效地完成大小写不敏感的批量字符串替换。
在 PHP 开发中，常需根据动态配置（如 JSON 文件或 API 返回）对文本执行多组搜索与替换操作。但直接将 JSON 字符串当作数组使用会导致错误——例如 array_keys() 无法作用于字符串，json_decode() 也未被调用，这是原代码失效的根本原因。
正确做法是：先解码 JSON 字符串为关联数组，再提取 Original 和 Replacement 字段分别构成搜索与替换数组。以下是完整、健壮的实现：
<?php
$json = '[{"Original":"test1","Replacement":"test1a"},{"Original":"test2","Replacement":"test2a"}]';
// ✅ 步骤1：JSON 解析（注意：$json 已是合法 JSON 数组字符串，无需额外加括号）
$searchReplaceArray = json_decode($json, true);
// ❌ 错误示例（原问题中）：
// $searchReplaceArray = '['. $json .']'; // 重复包裹，导致语法错误
// ✅ 步骤2：提取键值列
$originals = array_column($searchReplaceArray, 'Original');
$replacements = array_column($searchReplaceArray, 'Replacement');
// ✅ 步骤3：执行批量替换（大小写不敏感）
$text1 = 'Hello test1, let me see if test2 is also replaced...';
$text2 = str_ireplace($originals, $replacements, $text1);
echo 'Original: ' . htmlspecialchars($text1) . '<br>';
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 配置、结合数据库动态生成替换规则，或封装为可复用的工具函数，大幅提升文本处理的灵活性与可维护性。
立即学习“PHP免费学习笔记（深入）”；
