萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP nl2br() 函數詳解:換行符轉 <br> 輸出

函數定義

nl2br(string $string, bool $is_xhtml = true): string

在字串中的每個換行符(\n、\r\n、\r)之前插入 HTML 換行標籤。預設輸出 XHTML 風格 <br />,若 $is_xhtml = false 則輸出 <br>。

參數說明

參數型別說明
stringstring必需,待處理字串
is_xhtmlbool可選,預設 true(XHTML 風格 <br />),false 為 <br>

範例代碼

<?php
$str = "第一行\n第二行\r\n第三行\r第四行";

echo "原始輸出(HTML 會忽略換行):\n";
echo $str;
echo "<hr>";

echo "nl2br() 預設(XHTML):\n";
echo nl2br($str);
echo "<hr>";

echo "nl2br(false) HTML4 風格:\n";
echo nl2br($str, false);
?>

輸出結果

原始輸出(HTML 會忽略換行):
第一行 第二行 第三行 第四行
-----------------------------------
nl2br() 預設(XHTML):
第一行<br />
第二行<br />
第三行<br />
第四行
-----------------------------------
nl2br(false) HTML4 風格:
第一行<br>
第二行<br>
第三行<br>
第四行

常見應用場景

  1. 文字區域內容顯示:用戶在 <textarea> 輸入多行文本,資料庫存原始換行,前端顯示時用 nl2br()。
  2. 日誌/錯誤訊息格式化:保留換行結構,直接輸出至網頁。
  3. 簡易 Markdown 替代:不想引入完整 Markdown 解析器時,僅處理換行。

注意事項

  • 不會移除原有換行符,只是在其前插入 <br>。HTML 中連續空白仍會合併,若需保留縮排請搭配 white-space: pre-wrap CSS。
  • 若字串已含 HTML 標籤,nl2br() 會在標籤間的換行也插入 <br>,可能導致結構混亂。建議先 htmlspecialchars() 再 nl2br()。
  • 效能極佳,適合高頻呼叫。

反向操作:br2nl()(自訂)

function br2nl($string) {
    return preg_replace('/<br\s*\/?>/i', "\n", $string);
}
copyright © 萬盛學電腦網 all rights reserved