nl2br()

1. 定义

该函数将指定字符串中所有的换行标记(\n\r)替换成有效的HTML换行标记<br />

注:

  • Windows 系统的换行符为\r\n,Unix 系统的换行符为\n,macOS 系统的换行符则为\r

2. 语法

nl2br ( string $str [, bool $is_xhtml = TRUE ] ) : string

3. 参数说明

参数 可选性 数据类型 描述
$str 必需 字符串 将被去除 HTML、PHP 标记的字符串
$is_xhtml 可选 布尔值 替换后的换行标记是否被 XHML 兼容,默认为 TRUE ,替换为<br />

4. 示例

<?php

// nl2br()
// 将指定字符串中所有的换行标记(`\n`、`\r`)替换成有效的HTML换行标记`<br />`

$str1 = 'hello,world';
var_dump(nl2br($str1));// 输出:string(11) "hello,world"

$str2 = "hello,world\n";
var_dump(nl2br($str2));
/* 输出:
string(18) "hello,world<br />
"
*/

var_dump(nl2br($str2, false));
/* 输出:
string(16) "hello,world<br>
"
*/

$str3 = "hello,world\r\n";
var_dump(nl2br($str3));
/* 输出:
string(19) "hello,world<br />
"
*/

5. 延展阅读

  • htmlspecialchars():将部分特殊字符转换为 HTML 实体
  • htmlentities():将字符串中的 HTML 字符转换为 HTML 实体
  • wordwrap():使用特定字符串将指定字符串打断为指定宽度的子字符串
  • str_replace():将指定字符串中特定的部分,替换成另一个字符串