PHP 使用 wordwrap() 依固定寬度換行格式化文字

wordwrap() 可在字串達到指定寬度處插入換行符，適合郵件內容排版、報表固定欄寬、終端機輸出等場景。

語法

wordwrap(string $string, int $width = 75, string $break = "\n", bool $cut_long_words = false): string

參數說明

• $width：每行最大字元數
• $break：換行字串（預設 "\n"，HTML 可用 "<br>"）
• $cut_long_words：true 強制切斷長單字，false 保留長單字完整（預設）

範例：移除原有換行後重新排版

<?php
$string = "TRADING ON MARGIN POSES ADDITIONAL RISKS AND IS NOT SUITABLE FOR ALL INVESTORS. A COMPLETE LIST OF THE RISKS ASSOCIATED WITH MARGIN TRADING IS AVAILABLE IN THE MARGIN RISK DISCLOSURE DOCUMENT.";
$string = str_replace(["\n", "\r"], " ", $string); // 先壓成單行
echo wordwrap($string, 40);
?>

輸出（每行 40 字元）

TRADING ON MARGIN POSES ADDITIONAL RISKS
AND IS NOT SUITABLE FOR ALL INVESTORS. A
COMPLETE LIST OF THE RISKS ASSOCIATED WITH
MARGIN TRADING IS AVAILABLE IN THE MARGIN
RISK DISCLOSURE DOCUMENT.

HTML 環境換行

echo wordwrap($text, 80, "<br>\n");

注意事項

• 中文等多位元組字元會被視為單一字元，實際顯示寬度可能不一致
• 極長單字（如 URL）若不設 $cut_long_words = true 會超寬
• 效能：超大字串建議分塊處理

善用 wordwrap() 讓文字輸出整齊易讀。