使用 PHP 创建换行符-php教程-PHP中文网

使用 PHP 创建换行符

聖光之護

发布： 2025-10-04 11:39:06

原创

260人浏览过

使用 PHP 创建换行符

本文旨在介绍如何在 PHP 中正确地创建和处理换行符，尤其是在字符串拼接和输出的场景下。我们将通过一个实际的 WooCommerce 示例，演示如何使用 nl2br() 函数以及避免重复输出的问题，确保文本格式的正确显示。

在 php 中，处理换行符是一个常见的任务，尤其是在处理文本输出、用户输入或者从数据库读取数据时。错误的换行符处理可能导致文本显示混乱，影响用户体验。本文将详细介绍如何在 php 中创建和使用换行符，并通过一个 woocommerce 示例来演示如何避免常见错误。

理解换行符

首先，我们需要理解不同操作系统和环境下的换行符表示方式：

Unix/Linux: 使用 \n (LF - Line Feed)
Windows: 使用 \r\n (CRLF - Carriage Return and Line Feed)
macOS (早期版本): 使用 \r (CR - Carriage Return)

在 HTML 中，换行符通常用 <br> 标签表示。

使用 nl2br() 函数

PHP 提供了 nl2br() 函数，它可以将字符串中的换行符 (\n) 替换为 HTML 的 <br> 标签。这在将文本输出到网页时非常有用。

示例：

立即学习“PHP免费学习笔记（深入）”；

$text = "第一行\n第二行\n第三行";
$htmlText = nl2br($text);
echo $htmlText;

登录后复制

这段代码的输出将会是：

启科网络PHP商城系统

启科网络商城系统由启科网络技术开发团队完全自主开发，使用国内最流行高效的PHP程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。

查看详情

第一行<br>
第二行<br>
第三行

登录后复制

WooCommerce 示例：修改订单接收文本

假设我们需要修改 WooCommerce 订单接收页面显示的文本，并添加自定义的换行符。以下是一个常见的错误示例：

add_filter('woocommerce_thankyou_order_received_text', 'woo_change_order_received_text', 10, 2 );
function woo_change_order_received_text( $str, $order ) {
    echo nl2br(   $new_str = $str .  " 

You will shortly receive a confirmation email. We will email you again once your order has been dispatched.

With best wishes – and happy styling,

Wendy & Emma x
");
    return $new_str;
}

登录后复制

这段代码的问题在于，它使用了 echo 来输出文本，同时又返回了原始的 $new_str 值。这导致文本被显示两次，一次带有换行符，一次没有。

正确的做法是：

add_filter('woocommerce_thankyou_order_received_text', 'woo_change_order_received_text', 10, 2 );
function woo_change_order_received_text( $str, $order ) {
    return nl2br( $str .  " 

You will shortly receive a confirmation email. We will email you again once your order has been dispatched.

With best wishes – and happy styling,

Wendy & Emma x
");
}

登录后复制

在这个修正后的代码中，我们移除了 echo 语句，直接返回经过 nl2br() 处理后的字符串。这样，文本只会显示一次，并且带有正确的换行符。

注意事项

避免重复输出： 在使用过滤器或钩子函数时，要特别注意不要同时输出和返回数据，这可能导致数据重复显示。
转义 HTML 实体： 如果你的文本包含 HTML 特殊字符（例如 <、>、&），请使用 htmlspecialchars() 函数进行转义，以防止 XSS 攻击。
根据环境选择换行符： 在处理跨平台文本时，可能需要根据目标环境选择合适的换行符。PHP_EOL 常量可以用来获取当前系统的换行符。