用wordwrap 限制每行字符數到底怎麼設置？ PHP 實戰講解

gitbox 2025-06-08

用wordwrap 限制每行字符數到底怎麼設置？ PHP 實戰講解

在PHP 中， wordwrap()是一個非常實用的函數，它可以將字符串按指定的寬度進行自動換行。這個函數特別適用於處理長字符串，確保它們在輸出時不會超出預期的列寬。本文將通過一些實例，講解如何使用wordwrap()函數，並展示如何在實際應用中靈活設置每行的字符數。

1. wordwrap()函數的基本用法

wordwrap()的基本語法如下：

 wordwrap($string, $width, $break, $cut);

$string ：要處理的輸入字符串。
$width ：每行字符的最大寬度。如果行的字符數超過這個寬度， wordwrap()會在此位置插入換行符。
$break ：用於換行的符號，默認為換行符\n ，你可以設置為任何字符串（如<br> ）。
$cut ：是否強制在$width限制的位置切斷單詞。如果設置為TRUE ，即使單詞沒有完全結束，也會在該位置切斷；如果是FALSE （默認值），則wordwrap()會在單詞邊界自動換行。

2. 示例：基本的wordwrap()使用

讓我們通過一個簡單的例子來演示如何使用wordwrap() ：

 <?php
$text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.";
$wrapped_text = wordwrap($text, 30, "\n");
echo $wrapped_text;
?>

輸出：

 Lorem ipsum dolor sit amet,
consectetur adipiscing elit. Sed
do eiusmod tempor incididunt ut
labore et dolore magna aliqua.

在這個例子中， wordwrap()函數將每行的字符數限制為30 個字符，並在每個換行處插入了換行符\n 。

3. 設置自定義換行符

在實際開發中，可能希望在HTML 輸出中使用<br>標籤來代替普通的換行符。此時，可以通過設置$break參數為<br>來實現：

 <?php
$text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit.";
$wrapped_text = wordwrap($text, 20, "<br>");
echo $wrapped_text;
?>

輸出：

 Lorem ipsum dolor<br>sit amet,<br>consectetur<br>adipiscing elit.

這樣，輸出的內容就可以在網頁中正確顯示換行。

4. 強制斷詞（切割單詞）

如果我們希望在每行的限制寬度內強制切割單詞，可以使用$cut參數。默認情況下， wordwrap()會避免在單詞中間換行，但當$cut設置為TRUE時，它會在寬度限制處直接切斷單詞：

 <?php
$text = "Lorem ipsum dolor sit amet";
$wrapped_text = wordwrap($text, 10, "-", true);
echo $wrapped_text;
?>

輸出：

 Lorem-ipsum-
dolor-sit-
amet

如上所示， wordwrap()函數會強制在每行的寬度限制處切割單詞。

5. 如何處理URL

在輸出中，如果有URL，通常我們希望URL 不會被分割。為了實現這一點，我們可以在處理字符串之前將URL 替換為佔位符，使用wordwrap()完成換行後，再將佔位符替換回原來的URL。以下是一個示例：

 <?php
$text = "Visit my website at http://gitbox.net for more information.";
$text_with_placeholder = preg_replace('/http[s]?:\/\/[a-zA-Z0-9\-\.]+\.[a-zA-Z]{2,3}(\/\S*)?/', 'URL_PLACEHOLDER', $text);
$wrapped_text = wordwrap($text_with_placeholder, 20, "\n");
$final_text = str_replace('URL_PLACEHOLDER', 'http://gitbox.net', $wrapped_text);
echo $final_text;
?>

輸出：

 Visit my website at
http://gitbox.net
for more information.

在這個示例中，我們通過正則表達式找到文本中的URL，並將其替換為一個佔位符URL_PLACEHOLDER 。然後使用wordwrap()對文本進行換行。最後，我們將佔位符恢復為原來的URL，從而保證URL 不會被斷開。

6. 小結

wordwrap()是一個非常實用的函數，能夠幫助開發者將長字符串按指定寬度自動換行。在實際應用中，我們可以根據需要自定義換行符和強制換行規則。如果遇到URL 等特殊字符，使用正則表達式來避免它們被切斷也是一種常見的做法。

通過合理的使用wordwrap() ，我們可以更好地控制輸出格式，提升程序的可讀性和用戶體驗。

wordwrap