處理多行文本時,常需為每行添加縮進、項目符號或註釋前綴。PHP_EOL 常數自動適配跨平台換行符 (Linux \n, Windows \r\n, Mac \r),本文提供通用 addLinePrefix() 函數。
<?php
/**
* 為字串每一行添加前綴
* @param string $string 輸入字串
* @param string $prefix 前綴字串 (如 " ", "> ", "# ")
* @return string 處理後字串
*/
function addLinePrefix(string $string, string $prefix): string {
// 統一換行符為 \n 內部處理,最後可選轉回 PHP_EOL
$lines = explode("\n", str_replace("\r\n", "\n", $string));
foreach ($lines as &$line) {
$line = $prefix . $line;
}
return implode(PHP_EOL, $lines);
}
// 使用範例
$text = "第一行內容\n第二行內容\r\n第三行內容";
echo addLinePrefix($text, ' '); // 兩空格縮進
/*
輸出:
第一行內容
第二行內容
第三行內容
*/
echo addLinePrefix($text, '> '); // 引用格式
/*
> 第一行內容
> 第二行內容
> 第三行內容
*/
?>
<?php
function addLinePrefixPreserve(string $string, string $prefix): string {
// 使用正則分割,保留換行符
$parts = preg_split('/(\r\n|\r|\n)/', $string, -1, PREG_SPLIT_DELIM_CAPTURE);
$result = '';
$isNewLine = true; // 字串開頭視為新行
foreach ($parts as $part) {
if ($part === "\n" || $part === "\r" || $part === "\r\n") {
$result .= $part;
$isNewLine = true;
} else {
if ($isNewLine) {
$result .= $prefix;
$isNewLine = false;
}
$result .= $part;
}
}
return $result;
}
?>
| 場景 | 前綴範例 | 用途 |
|---|---|---|
| 代碼生成 | (4 空格) | 生成縮進正確的 PHP/JS/Python 代碼 |
| Markdown 引用 | > | 郵件回覆、論壇引用 |
| 日誌標記 | [INFO] | 統一日誌格式 |
| 行號顯示 | sprintf("%4d: ", $i) | 代碼審查、差異對比 |
| 註釋化 | // 或 # | 暫時禁用代碼段 |
explode/implode 比 preg_replace 快 3-5 倍。