使用json_encode配合JSON_UNESCAPED_LINE_TERMINATORS标志可保留换行符原始形态,HTML中需用标签包裹;或用print_r结合htmlspecialchars与输出数组结构并维持换行显示。

如果您在将 PHP 数组转换为字符串(如 JSON、HTML 输出或日志记录)时发现原始数组中包含的换行符(\n 或 \r\n)被忽略或显示为普通空格,则可能是由于序列化方式、输出上下文或转义处理不当所致。以下是保留换行符的多种处理方法:
一、使用 json_encode 并启用 JSON_UNESCAPED_UNICODE 和 JSON_UNESCAPED_LINE_TERMINATORS
默认情况下,json_encode 会将换行符转义为 \n 字符串形式,但该转义本身仍可被正确解析;若需在 HTML 中可视化解析换行,需配合 pre 标签或 CSS white-space 属性。启用 JSON_UNESCAPED_LINE_TERMINATORS 可避免对换行符做额外转义,保持其原始字节形态。
1、定义含换行符的数组,例如:$arr = ['name' => 'Alice', 'bio' => "Line one.\nLine two.\nLine three."];
2、调用 json_encode 并传入标志位:json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_LINE_TERMINATORS);
立即学习“PHP免费学习笔记(深入)”;
3、若用于 HTML 输出,将结果包裹在 标签中以保留格式。
二、使用 print_r 配合 htmlspecialchars 和 标签
print_r 默认以可读格式输出数组结构,天然保留换行;但直接输出到 HTML 会被浏览器折叠空白符,因此需结合 htmlspecialchars 转义特殊字符,并用
包裹维持排版。1、初始化目标数组,确保值中含 \n,如:$data = ['msg' => "First line.\nSecond line.\nThird line."];
2、捕获 print_r 输出:$output = print_r($data, true);
3、对输出内容执行 HTML 实体转义:$safe_output = htmlspecialchars($output, ENT_QUOTES, 'UTF-8');
4、在 HTML 中输出:
三、手动遍历拼接并显式保留 \n 字符
当需将数组扁平化为单字符串且严格保留所有原始换行符时,可避免使用自动序列化函数,改用 foreach 遍历并控制分隔逻辑,对每个值不做 trim 或 str_replace 处理。
1、声明数组变量,其中字符串值明确包含 \n,例如:$list = ["item1\nsub1", "item2\nsub2", "item3"];
2、初始化空字符串:$result = '';
3、使用 foreach 遍历并追加,不修改原值:foreach ($list as $v) { $result .= $v . "\n"; }
4、输出前确认未执行 nl2br() 或 str_replace("\n", "", ...) 类操作,否则换行符将被移除。
四、使用 var_export 并配合 str_replace 还原换行
var_export 默认将换行符表示为 '\\n' 字面量(即反斜杠加 n),而非真实换行字节;需在导出后对字符串执行一次解析替换,将 '\\n' 替换为实际的 \n 字符。
1、获取数组导出字符串:$exported = var_export($arr, true);
2、执行双重转义还原:$with_real_newlines = str_replace("'\\n'", "\n", $exported);
3、注意:此操作仅适用于单引号包围的字符串字面量,若数组含双引号字符串或复杂嵌套,可能误替换。
五、输出至文件时使用 fwrite 并指定二进制模式
当目标是将数组内容(含换行符)写入文本文件而非网页显示时,应避免经过 HTML 渲染流程,直接使用 fwrite 写入原始字节流,确保操作系统换行符(\n 或 \r\n)不被干扰。
1、打开文件句柄,使用 'wb' 模式:$fp = fopen('output.txt', 'wb');
2、对数组中每个元素调用 fwrite,例如:foreach ($arr as $k => $v) { fwrite($fp, $k . ': ' . $v . "\n"); }
3、关闭文件:fclose($fp);
4、验证文件内容时使用支持 Unix 行尾的编辑器,Windows 记事本可能无法正确显示 \n 换行。











