タイトル: 改行出力
SEOタイトル: PHP 改行出力 (\n / PHP_EOL / nl2br) 完全ガイド
| この記事の要点 |
|
PHP の改行コード基礎
PHP で文字列に改行を含める方法は複数あります。エスケープシーケンス \n / \r\n / \r、定数 PHP_EOL、Heredoc/Nowdoc などです。
改行コード一覧
| 表記 | 名称 | 16進 | 主な OS |
|---|---|---|---|
\n | LF (Line Feed) | 0x0A | Unix / Linux / macOS (X 以降) |
\r\n | CRLF | 0x0D 0x0A | Windows / HTTP / SMTP プロトコル |
\r | CR (Carriage Return) | 0x0D | Mac OS 9 以前（現代では稀） |
PHP_EOL | 環境依存 | 環境次第 | OS に応じて自動切替 |
HTML 出力で改行を反映する: nl2br()
ブラウザは \n を空白として扱うため、フォーム入力の改行をそのまま echo しても見えません。nl2br() で
を挿入
echo nl2br($comment);
// → 1 行目
// 2 行目
// 3 行目
// XSS 対策とセットで使う
echo nl2br(htmlspecialchars($comment, ENT_QUOTES, 'UTF-8'));
// CRLF / LF / CR すべて対応
echo nl2br("a\r\nb\nc\rd");
// → a
// b
// c
// d改行コードの正規化
外部ファイル / フォーム入力 / API 受信などで混在する改行コードを統一する定番処理:
CSV / TSV / ログ出力での改行
Heredoc / Nowdoc での複数行
こんにちは、{$name}さん
本日の天気: 晴れ
$title
HTML; }PHP_EOL vs ハードコード
| シーン | 推奨 | 理由 |
|---|---|---|
| CLI ツールで標準出力 | PHP_EOL | Windows と Unix で適切に改行 |
| HTTP プロトコル ヘッダ | "\r\n" 固定 | RFC 7230 で CRLF 必須 |
| メール (SMTP) 送信 | "\r\n" 固定 | RFC 5322 で CRLF 必須 |
| JSON / SQL / 構造化文字列 | 固定 ("\n") | OS 依存にすると再現性低下 |
| HTML 出力 | nl2br() | ブラウザは改行を空白扱い |
| ファイル書き出し（社内のみ） | "\n" | テキストエディタは両対応 |
JavaScript / 他言語との対比
// JavaScript も同じ
console.log("abc\n"); // LF
console.log("abc\r\n"); // CRLF
console.log(`line1
line2`); // テンプレートリテラルは改行をそのまま含む
// Node.js の改行定数
const os = require('os');
console.log("abc" + os.EOL); // PHP_EOL 相当よくあるトラブル
| 症状 | 原因 | 対処 |
|---|---|---|
| シングルクォートで改行されない | '\n' はリテラル | ダブルクォートに変更 |
| ブラウザで改行が反映されない | HTML が改行を空白扱い | nl2br() 適用 |
| Windows で改行が変 | LF のみ出力 → メモ帳で 1 行に | CRLF にするか PHP_EOL を使う |
| CSV ファイル化けする | 改行コード不一致 | CRLF + BOM 付き UTF-8 |
| メール送信失敗 | ヘッダの改行が LF のみ | "\r\n" 固定で出力 |
FAQ
Q: echo "\n" と print("\n") はどちらが速い？
A: echo の方が微妙に速い（言語構造なので関数呼び出しオーバーヘッドが無い）。可読性で選んで問題なし。
Q: nl2br() は元の改行を消す？
A: 消しません。
\n
Q: ヒアドキュメント内で $var を展開させたくない
A: Nowdoc（識別子をシングルクォートで囲む <<<'TPL'）を使えば一切展開されません。