萬盛學電腦網

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

PHP 換行符號深度解析:\\r\\n、\\n、\\r 跨平台差異、ASCII 碼與實際處理策略

前言

換行符號(\r\n、\n、\r)是跨平台文字處理的經典痛點。Windows (CRLF)、Unix/Linux (LF)、舊 Mac OS (CR) 三種標準並存,導致檔案讀寫、字串處理、資料庫儲存、網路傳輸頻發編碼錯誤。本文深度解析 ASCII 定義、PHP 處理機制、跨平台正規化策略與實戰最佳實踐。

一、ASCII 定義與歷史由來

符號名稱ASCII 碼十進位歷史用途
LF / \nLine Feed(換行)0x0A10Unix/Linux/macOS/現代 Web:單字元換行
CR / \rCarriage Return(歸位/回車)0x0D13舊 Mac OS (9 及之前):單字元換行
CRLF / \r\nCarriage Return + Line Feed0x0D 0x0A13 10Windows、DOS、HTTP 標頭、SMTP、FTP:雙字元換行

1.1 類比:打字機機械動作

  • CR (Carriage Return):滾筒歸位至行首。
  • LF (Line Feed):滾筒上卷一行。
  • Windows 保留雙動作;Unix 簡化為單一 LF。

二、PHP 中的換行處理機制

2.1 雙引號/Heredoc 解析 vs 單引號/Nowdoc 字面

<?php
echo "Line1\nLine2";    // 解析 \n 為 LF (0x0A)
echo 'Line1\nLine2';   // 字面輸出 \n 兩字元

echo "Line1\r\nLine2"; // 解析 \r\n 為 CRLF
echo 'Line1\r\nLine2'; // 字面輸出

// Heredoc 解析逸出序列
echo <<

2.2 PHP_EOL:跨平台換行常數

<?php
// PHP_EOL 根據執行平台自動決定
// Windows: \r\n
// Linux/macOS: \n

$log = "User login" . PHP_EOL;
$log .= "Action: purchase" . PHP_EOL;
file_put_contents('app.log', $log, FILE_APPEND);

// 注意:HTTP 回應標頭必須用 \r\n(協定規範),不可用 PHP_EOL
header("Content-Type: text/plain\r\n"); // 正確
// header("Content-Type: text/plain" . PHP_EOL); // 錯誤(Unix 上只送 LF)
?>

2.3 字串函式與換行

<?php
$str = "Line1\nLine2\r\nLine3\rLine4";

// nl2br:將 \n/\r\n/\r 轉為 
(HTML 顯示用) echo nl2br($str); // explode 分割行:需處理三種格式 $lines = preg_split('/\r\n|\r|\n/', $str); // 正則最稳健 // 或 PHP 8.2+ mb_split $lines = mb_split('\r\n|\r|\n', $str); // file() 讀檔:自動處理各種換行,保留換行符 $lines = file('data.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); ?>

三、跨平台檔案處理實戰

3.1 讀取:統一正規化為 LF

<?php
function readLines(string $path): array {
    $content = file_get_contents($path);
    // 統一轉換為 LF
    $content = str_replace("\r\n", "\n", $content); // Windows → Unix
    $content = str_replace("\r", "\n", $content);   // Old Mac → Unix
    return explode("\n", $content);
}

// 或使用 SplFileObject(自動處理)
$file = new SplFileObject($path);
$file->setFlags(SplFileObject::DROP_NEW_LINE | SplFileObject::SKIP_EMPTY);
foreach ($file as $line) { /* ... */ }
?>

3.2 寫入:根據目標平台決定

<?php
function writeLines(string $path, array $lines, string $targetOs = 'unix'): void {
    $eol = $targetOs === 'windows' ? "\r\n" : "\n";
    $content = implode($eol, $lines) . $eol; // 結尾換行
    file_put_contents($path, $content);
}

// 內建常數(PHP 8.1+)
// PHP_OS_FAMILY: 'Windows', 'Linux', 'Darwin', 'BSD', 'SunOS'
?>

3.3 Git/版控:.gitattributes 強制正規化

# .gitattributes
* text=auto eol=lf        # 倉庫內統一 LF
*.bat text eol=crlf       # Windows 批次檔保留 CRLF
*.sh text eol=lf          # Shell 腳本強制 LF

四、常見場景與解決方案

4.1 CSV 匯入/匯出

<?php
// 匯出:RFC 4180 規範 CRLF
$fp = fopen('export.csv', 'w');
foreach ($rows as $row) {
    fputcsv($fp, $row, ',', '"', "\r\n"); // PHP 8.1+ 第 5 參數指定 EOL
}
fclose($fp);

// 匯入:fgetcsv 自動處理 CRLF/LF/CR
$fp = fopen('import.csv', 'r');
while (($row = fgetcsv($fp)) !== false) { /* ... */ }
fclose($fp);
?>

4.2 HTTP 回應:標頭必須 CRLF,Body 視內容型別

<?php
// 標頭:強制 \r\n
header("Content-Type: text/plain; charset=utf-8\r\n");

// Body:文字內容通常用 LF 即可(瀏覽器容錯)
// 但郵件、HTTP 協定主體若為 multipart 等需遵循 RFC 規範
?>

4.3 資料庫儲存:統一存 LF,顯示時轉換

<?php
// 存入前正規化
$content = str_replace(["\r\n", "\r"], "\n", $_POST['content']);

// 顯示時(HTML)
echo nl2br(htmlspecialchars($content));

// 顯示時(純文字下載)
header('Content-Type: text/plain; charset=utf-8');
echo str_replace("\n", "\r\n", $content); // Windows 用戶友善
?>

五、其他逸出序列速查

序列含義ASCII
\t水平定位 (Tab)0x09 (9)
\v垂直定位0x0B (11)
\f換頁0x0C (12)
\\反斜線0x5C (92)
\$美元符號0x24 (36)
\"雙引號0x22 (34)
\'單引號0x27 (39)
\[0-7]{1,3}八進位字元-
\x[0-9A-Fa-f]{1,2}十六進位字元-
\u{xxxxxx}Unicode 碼位 (PHP 7.0+)-

六、除錯技巧:可視化不可見字元

<?php
function visualizeLineEndings(string $str): string {
    return str_replace(
        ["\r\n", "\n", "\r", "\t"],
        ["␍␊", "␊", "␍", "␉"],
        $str
    );
}

$test = "Line1\nLine2\r\nLine3\rLine4\tTab";
echo visualizeLineEndings($test);
// Line1␊Line2␍␊Line3␍Line4␉Tab

// 十六進位檢視
echo bin2hex($test);
// 4c696e65310a4c696e65320d0a4c696e65330d4c696e653409546162
?>

七、總結:換行處理鐵律

  1. 內部統一用 LF (\n):記憶體、資料庫、邏輯處理全程 LF。
  2. 輸出時按目標轉換:Windows 檔案/HTTP 標頭/郵件 → CRLF;Web 顯示 → nl2br() 或 CSS white-space: pre-line。
  3. 讀取時正規化:str_replace(["\r\n","\r"], "\n", $content) 或 preg_split('/\r\n|\r|\n/')。
  4. Git 倉庫強制 LF:.gitattributes text=auto eol=lf。
  5. 編輯器設定:VS Code/PhpStorm 設定「End of Line Sequence: LF」。
  6. 勿在單引號中寫 \n:單引號不解析逸出序列。

結語

換行符號看似微不足道,實則關係資料完整性、跨平台相容性與安全性。建立「內部 LF、邊界轉換」的統一規範,配合 Git 屬性、編輯器設定、PHP 內建函式(file、SplFileObject、fgetcsv),即可徹底解決換行亂碼、多一行/少一行、標頭注入等經典問題。

copyright © 萬盛學電腦網 all rights reserved