【PHP】シングルクォート内で改行を出力する方法

PHPにおけるシングルクォートと改行の問題

PHPでは、ダブルクォート（"）で囲んだ文字列内では「\n」による改行が有効ですが、シングルクォート（'）で囲んだ文字列内では「\n」はエスケープシーケンスとして解釈されず、そのまま文字として出力されてしまいます。

そのため、シングルクォートを使用する場合には、改行を実現するために別の方法を選ぶ必要があります。主な選択肢は以下の2つです。

• コマンドラインインターフェース（CLI）で実行する場合：定数「PHP_EOL」を使用する
• ブラウザ上で表示する場合：「<br>」タグを使用する

両方の方法について、以下で具体的に解説します。

実行環境に応じた改行の出し分け

次のコードは、実行環境がCLIかどうかを判定し、それに応じて適切な改行を返す例です。

<?php
if (PHP_SAPI === 'cli') {
    return PHP_EOL;
}
else
{
    return "<BR/>";
}
?>

実行環境がCLIでない場合、elseブロックが処理され、ブラウザ向けに改行タグ「<BR/>」が出力されます。

使用例

続いて、ダブルクォートとシングルクォートでの改行の挙動の違いを確認できるサンプルコードを見てみましょう。

<?php
    $var_1 = 'hi';
    $var_2 = "\n";
    $var_3 = 'hello';
    echo $var_1 . $var_2 . $var_3;
    echo PHP_EOL;
    $var_2 = str_replace("\n", '\n', $var_2);
    echo $var_1 . $var_2 . $var_3;
    echo PHP_EOL;
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

hi hello hi\nhello

最初の出力では、ダブルクォート内の「\n」が正しく改行として機能していることがわかります。一方、str_replace関数によって「\n」をシングルクォートのリテラル「'\n'」に置き換えた後は、「hi\nhello」というように改行コードが文字列としてそのまま表示されます。

これは、シングルクォートで囲まれた文字列内ではエスケープシーケンスが解釈されないためです。この挙動の違いを理解しておくことで、意図しない出力を防ぎ、状況に応じてPHP_EOLや<br>タグを適切に使い分けることができます。