PHP中保留JSON换行符的正确方法

PHP 的 `json_encode()` 将换行符 `\n` 转义为 `\\n` 并非缺陷，而是严格遵循 JSON 国际标准（ECMA-404）的必要行为——因为合法 JSON 字符串中绝不允许出现未转义的原始换行符（U+000A），否则将导致所有合规解析器（如 JavaScript、Python、PHP 自身）解析失败；所谓“显示为真实换行”的需求本质是展示层问题，正确做法是在前端用 `white-space: pre-line` 或 `.replace(/\n/g, '
')` 渲染，而非破坏 JSON 格式本身；滥用 `str_replace` 强行注入裸换行或误用 `JSON_UNESCAPED_LINE_TERMINATORS`（它仅影响结构缩进，不改变字符串转义）将制造不可解析的非法 JSON，是必须规避的高危反模式。

PHP 的 json_encode() 严格遵循 JSON 规范，而标准 JSON 不允许字符串内出现未转义的原始换行符（即字面量 LF/CR）；\n 总会被编码为转义序列 \\n，这是合法且必需的行为，无法“显示为真实换行”——你所期望的格式本身不符合 JSON 语法。

PHP 的 `json_encode()` 严格遵循 JSON 规范，而标准 JSON 不允许字符串内出现未转义的原始换行符（即字面量 LF/CR）；`\n` 总会被编码为转义序列 `\\n`，这是合法且必需的行为，无法“显示为真实换行”——你所期望的格式本身不符合 JSON 语法。

在开发中，常有人误以为 json_encode() 应该“渲染出带缩进换行的字符串内容”，例如希望以下代码：

$array = ["string" => "hello\ngood morning!!"];
echo json_encode($array, JSON_PRETTY_PRINT);

输出类似这样的人类可读格式：

{
  "string": "hello
good morning!!"
}

⚠️ 但请注意：这并非合法 JSON。JSON 标准（ECMA-404）明确规定：字符串内的换行符必须以转义形式 "\n" 出现，不可作为裸字符（U+000A）直接嵌入字符串字面量中。否则，任何合规的 JSON 解析器（如 JavaScript JSON.parse()、Python json.loads()、或 PHP 自身的 json_decode()）都会报错 SyntaxError: Unexpected token。

✅ 正确行为（符合标准）：

$array = ["string" => "hello\ngood morning!!"];
echo json_encode($array);
// 输出：{"string":"hello\ngood morning!!"}
// 注意：这里的 \n 是两个字符：反斜杠 + 字母 n，表示一个换行控制符

✅ 若需提升可读性（如调试、日志），可启用 JSON_PRETTY_PRINT，但字符串内部仍保持转义：

echo json_encode($array, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
/*
{
    "string": "hello\ngood morning!!"
}
*/

? 验证解析安全性（关键！）：

$encoded = json_encode($array);
$decoded = json_decode($encoded, true);
var_dump($decoded['string']); // string(19) "hello
                                // good morning!!"
// ✅ 换行语义完好保留：\n 在解码后还原为真实换行符

? 补充说明：

• JSON_UNESCAPED_LINE_TERMINATORS（PHP 7.1+）仅影响 JSON 结构自身的换行分隔符（如对象花括号间的换行），不改变字符串内容的转义规则；
• 若你真正需要“在前端显示为多行”，应在消费端（如 JavaScript）用

  、white-space: pre-line 或 .replace(/\n/g, '
  ') 处理，而非修改 JSON 序列化格式；

• 强制拼接非标准 JSON（如用 str_replace 将 \\n 替换为 \n）将导致数据不可解析，属于高危反模式。

? 总结：json_encode() 的行为完全正确且必要。\n 被转义为 \\n 是 JSON 合规性的基石，确保跨语言、跨平台的数据互操作性。追求“视觉换行”应交由展示层处理，而非破坏序列化协议本身。

到这里，我们也就讲完了《PHP中保留JSON换行符的正确方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！