HOWTO · PHP

如何在 PHP 中创建新行

本文介绍了如何在 PHP 中使用 新行字符和 新行来创建新行字符。

本页内容

在 PHP 中创建换行时,应根据输出的阅读方式选择相应表示法。在双引号字符串中使用 \n,可在文本中插入换行;如果文本应采用当前平台的原生行结束符,则使用 PHP_EOL。若要在浏览器中显示换行,应输出 <br> 等 HTML;仅在 HTML 源码中加入换行符,通常不会形成可见换行。这些方式不能互换:浏览器解析 HTML,而终端或文本文件阅读程序读取的是字符。

根据输出格式选择换行方式

对于 CLI 消息、日志和纯文本文件,可以在字符串中加入换行字符;如果文件应遵循平台惯例,则可使用 PHP_EOL。对于 HTML 响应,应使用浏览器能够识别的标记。选择时应考虑输出的接收方,而不只是运行 PHP 的操作系统。如果输出可能同时作为文本和 HTML 阅读,应分别生成适合这两种用途的格式,不要把标记和文本行结束符混在同一个字符串中。

在 PHP 字符串中使用 \n

在 PHP 的双引号字符串中,\n 表示换行符。单引号字符串不会把 \n 解释为换行;它会保留反斜杠序列(但 PHP 对单引号字符串有少数特定的转义规则)。如果希望 PHP 解析这个转义序列,请使用双引号。连续两个换行符会在两行文本之间留出一个空行。

运行下面的示例。代码和输出中的英文问候语保持原样:

本节中的代码以及显示的标签或输出仍为英文。

<?php
$message = "Hello, PHP!\nWelcome back.";
echo $message, "\n";
?>

预期输出:

Hello, PHP!
Welcome back.

这种方法适用于终端输出和文本内容。写入文件时,字符串中的字节会原样写入,因此应选择读取该文件的程序所要求的行结束符。

使用 PHP_EOL 输出平台原生文本

PHP_EOL 包含 PHP 运行平台对应的行结束符序列。例如,可以用 "First" . PHP_EOL . "Second" 将它连接在两行文本之间。它适用于 CLI 输出,以及供当前环境使用的文本文件。它不会生成可见的 HTML 换行:浏览器渲染段落时可能会折叠源码中的空白。此外,特定交换格式可能要求固定的行结束符;此时应使用该格式规定的字符,不要默认当前平台的行结束符就是正确选择。

使用 <br> 实现 HTML 换行

生成 HTML 时,<br> 是表示换行的 HTML 元素。例如,PHP 可以输出 "First line<br>Second line",HTML 渲染器会将文本显示为两行。HTML 源码中的换行字符通常会被视为空白,不能保证显示出换行。反过来,在终端打印 <br> 时,它会作为字面标记显示,不会让光标移到下一行。将不可信值插入 HTML 前,应先对其进行转义;换行元素不会让周围的内容自动变得安全。

了解 \r\n 和空行

\r\n 由回车符和紧随其后的换行符组成,是许多 Windows 文本文件的常见行结束符。在 PHP 双引号字符串中,这两个转义序列会生成对应的两个控制字符。当接收格式明确要求 CRLF 时,应使用这一序列;否则,平台原生文本可使用 PHP_EOL,而规定使用换行符的格式通常使用 \n。要创建空行,可以再添加一个完整的行结束符序列,例如 "First\n\nSecond"。回车符不是让 PHP 重置输出指针的指令;它是一个字符,其显示效果取决于输出设备。

常见错误与快速检查

  • 如果 \n 被原样显示,请检查字符串是否使用了单引号。可以改用双引号,或通过其他方式构造换行。
  • 如果浏览器把文本显示在同一视觉行上,请检查最终渲染的 HTML。应使用 <br> 或合适的 CSS,而不要依赖源码中的空白。
  • 如果 <br> 出现在终端或保存的纯文本文件中,说明输出正作为文本处理。此时应改用 \n 或 PHP_EOL。
  • 如果其他程序拒绝读取文本文件,请检查它要求的行结束符。\n、\r\n 和 PHP_EOL 可能生成不同的字节序列。

应根据输出的下一位读取者选择表示法:文本换行可使用 PHP 字符串语法,平台原生文本文件可使用 PHP_EOL,固定文件格式应使用其指定的序列,而浏览器渲染的 HTML 应使用 <br>。