PHP 移除字串換行符的三種最佳實踐

處理用戶輸入、文件讀取、API 回傳數據時，換行符（\n、\r\n、\r）常導致顯示錯亂、資料庫查詢失敗或 JSON 解析錯誤。本文整理三種去除換行符的方法，並推薦最健壯的跨平台寫法。

換行符基礎知識

注意：轉義序列僅在雙引號或 Heredoc 字串中生效，單引號字串視為字面字符。

方法對比

1. 針對性替換（不推薦）

<?php
// 僅處理單一換行格式，跨平台易遺漏
$str = str_replace("\n", '', $str);   // 僅 LF
$str = str_replace("\r\n", '', $str); // 僅 CRLF
$str = preg_replace('/\s/', '', $str); // 連空白字符一起刪除（過度）

2. 陣列替換覆蓋常見格式（可用）

<?php
$str = str_replace(["\r\n", "\r", "\n"], '', $str);

優點：直觀、效能好。缺點：需手動列舉所有變體，漏掉 \r 會殘留孤立 CR。

3. 正則替換所有 Unicode 空白（強力但過度）

<?php
$str = preg_replace('/\s+/u', '', $str); // 連空格、製表符一併移除

副作用：會刪除正常單詞間的空格，導致語義丟失。

4. 推薦：使用 PHP_EOL 常量（最佳跨平台實踐）

<?php
// 僅移除系統原生換行符，保留其他空白
$str = str_replace(PHP_EOL, '', $str);

優勢：

• PHP_EOL 自動對應當前運行環境的換行符（Windows: \r\n，Linux/Mac: \n）。
• 不影響字串內的正常空格、Tab，保留可讀性。
• 效能優於正則，語義明確。

進階場景：處理混合換行符的外部數據

讀取上傳文件、第三方 API 回傳時，可能同時包含 \r\n、\n、\r。建議統一標準化：

<?php
/**
 * 統一換行符為 LF (\n)，再按需移除或保留
 */
function normalize_line_endings($str, $remove = false) {
    // 1. 先將 CRLF、CR 統一轉為 LF
    $str = str_replace(["\r\n", "\r"], "\n", $str);

    // 2. 若需完全移除
    if ($remove) {
        $str = str_replace("\n", '', $str);
    }
    return $str;
}

// 使用範例
$content = file_get_contents('import.txt');
$clean   = normalize_line_endings($content, true); // 移除所有換行
$unified = normalize_line_endings($content, false); // 統一為 LF，保留段落

效能基準（百萬字串測試）

總結建議

1. 已知來源平台 → 直接用 str_replace(PHP_EOL, '', $str)。
2. 未知/混合來源 → 先 normalize_line_endings() 標準化，再決定是否移除。
3. 需保留段落結構 → 僅標準化不移除，前端用 nl2br() 或 CSS white-space: pre-line 渲染。
4. 避免濫用 preg_replace('/\s/')，除非確定要壓縮所有空白字符。