【PHP8.x】PHP_EOL定数の使い方

Copy
1<?php
2
3/**
4 * PHP_EOL が「期待通りに動作しない (not working)」と感じる主な理由と、
5 * その挙動の違いを理解するためのサンプルコードです。
6 *
7 * PHP_EOL は、現在PHPが実行されているOSに応じた改行コードを表す定数です。
8 * 例: Windowsでは "\r\n"、Linux/macOSでは "\n"
9 *
10 * この定数は、コンソール出力やファイル書き込みでは正しく改行として機能しますが、
11 * ウェブブラウザでHTMLとして表示される際には、ブラウザのHTMLレンダリング規則により
12 * そのままでは改行として認識されません。
13 */
14
15/**
16 * PHP_EOL の動作をコンソールとブラウザの両方の視点から示します。
17 */
18function demonstratePhpEolBehavior(): void
19{
20    // --- コンソールでの PHP_EOL の動作 ---
21    // コマンドライン（例: php your_script.php）で実行すると、
22    // PHP_EOL は期待通りに各行を改行します。
23    echo "--- コンソール出力の例 ---" . PHP_EOL;
24    echo "これはコンソールでの最初の行です。" . PHP_EOL;
25    echo "これはコンソールでの2番目の行です。" . PHP_EOL;
26    echo "コンソールでは、PHP_EOLは正しく改行として機能します。" . PHP_EOL . PHP_EOL;
27
28    // --- ウェブブラウザでの PHP_EOL の動作 ---
29    // このスクリプトをウェブサーバー経由でブラウザからアクセスすると、
30    // PHP_EOL はHTMLとして解釈されないため、改行として表示されません。
31    // 全てのテキストが一行で連結されて表示されるはずです。
32    echo "--- ウェブブラウザ出力の例 (PHP_EOLのみ) ---" . PHP_EOL;
33    echo "ウェブブラウザでこのテキストにアクセスすると、" . PHP_EOL;
34    echo "PHP_EOLはHTMLの改行として認識されないため、" . PHP_EOL;
35    echo "このブロックのテキストは全てつながって一行で表示されます。" . PHP_EOL . PHP_EOL;
36
37    // --- ウェブブラウザで改行を表示する代替手段 ---
38    // HTMLで明示的に改行を表示するには、<br>タグを使用する必要があります。
39    // または、<pre>タグで囲むことで、空白や改行をそのまま表示させることもできます。
40    echo "--- ウェブブラウザで改行を表示する代替手段 ---" . PHP_EOL;
41    echo "ブラウザで改行を表示するには、HTMLの<br>タグを使います。<br>" . PHP_EOL;
42    echo "このようにすることで、ブラウザでも<br>タグの箇所で改行されます。<br>" . PHP_EOL;
43    echo PHP_EOL; // 空行を追加し、出力の区切りを明確にする
44    echo "また、<pre>タグで囲むと、PHP_EOLのような改行がそのまま表示されます。" . PHP_EOL;
45    echo "<pre>これは<br>事前フォーマットされた<br>テキストです。<br>" . PHP_EOL;
46    echo "PHP_EOLもこの中で改行として機能します。" . PHP_EOL;
47    echo "</pre>" . PHP_EOL;
48}
49
50// 関数を実行して、PHP_EOL の挙動を確認します。
51demonstratePhpEolBehavior();

PHP_EOLは、PHP8で利用できる内部定数で、PHPが実行されているOSに応じた改行コードを提供します。この定数には引数はなく、戻り値も持ちません。例えばWindows環境では\r\n、LinuxやmacOS環境では\nとして機能します。

この定数が「期待通りに動作しない」と感じられる主な理由は、出力先での解釈の違いにあります。コンソールやファイルへの出力では、PHP_EOLはOSに合わせた正しい改行として認識され、テキストを改行します。しかし、ウェブブラウザでHTMLとして表示される場合、PHP_EOLはHTMLのレンダリング規則の対象外であるため、単なる空白文字として扱われ、改行としては表示されません。そのため、ブラウザ上ではテキストがすべてつながって表示されることになります。

ウェブブラウザで改行を表示するには、HTMLの<br>タグを使うか、<pre>タグで囲んで整形済みテキストとして扱う方法があります。PHP_EOLは、ウェブ用途ではなく、コンソール出力やファイル書き込みなど、純粋なテキスト形式で改行を挿入する場合に特に有効な定数です。