換行符號(\r\n、\n、\r)是跨平台文字處理的經典痛點。Windows (CRLF)、Unix/Linux (LF)、舊 Mac OS (CR) 三種標準並存,導致檔案讀寫、字串處理、資料庫儲存、網路傳輸頻發編碼錯誤。本文深度解析 ASCII 定義、PHP 處理機制、跨平台正規化策略與實戰最佳實踐。
| 符號 | 名稱 | ASCII 碼 | 十進位 | 歷史用途 |
|---|---|---|---|---|
LF / \n | Line Feed(換行) | 0x0A | 10 | Unix/Linux/macOS/現代 Web:單字元換行 |
CR / \r | Carriage Return(歸位/回車) | 0x0D | 13 | 舊 Mac OS (9 及之前):單字元換行 |
CRLF / \r\n | Carriage Return + Line Feed | 0x0D 0x0A | 13 10 | Windows、DOS、HTTP 標頭、SMTP、FTP:雙字元換行 |
<?php
echo "Line1\nLine2"; // 解析 \n 為 LF (0x0A)
echo 'Line1\nLine2'; // 字面輸出 \n 兩字元
echo "Line1\r\nLine2"; // 解析 \r\n 為 CRLF
echo 'Line1\r\nLine2'; // 字面輸出
// Heredoc 解析逸出序列
echo <<
<?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)
?>
<?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);
?>
<?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) { /* ... */ }
?>
<?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'
?>
# .gitattributes
* text=auto eol=lf # 倉庫內統一 LF
*.bat text eol=crlf # Windows 批次檔保留 CRLF
*.sh text eol=lf # Shell 腳本強制 LF
<?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);
?>
<?php
// 標頭:強制 \r\n
header("Content-Type: text/plain; charset=utf-8\r\n");
// Body:文字內容通常用 LF 即可(瀏覽器容錯)
// 但郵件、HTTP 協定主體若為 multipart 等需遵循 RFC 規範
?>
<?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
?>
nl2br() 或 CSS white-space: pre-line。str_replace(["\r\n","\r"], "\n", $content) 或 preg_split('/\r\n|\r|\n/')。.gitattributes text=auto eol=lf。換行符號看似微不足道,實則關係資料完整性、跨平台相容性與安全性。建立「內部 LF、邊界轉換」的統一規範,配合 Git 屬性、編輯器設定、PHP 內建函式(file、SplFileObject、fgetcsv),即可徹底解決換行亂碼、多一行/少一行、標頭注入等經典問題。