PHPで複数行文字列を表示するテクニックまとめ

PHPで長くて改行のある文字列を表示するには色々なテクニックが使えます。

そのテクニックについてまとめました。

このページの目次

長い文字列を表示するには
ここまでのまとめ

長い文字列を表示するには

画面上に長い文字列を表示する方法は次の４つ

echo で１行ずつ出力
クォートで囲んで出力
ヒアドキュメントで出力
PHP閉じタグで出力

この４つについてコード例を踏まえて説明していきます。

echoで１行ずつ出力

一番最初はechoで１行ずつ文字列を出力する方法です。

例えば次のような感じで

echo "I have a pen.<br>";
echo "I have an apple.<br>";
echo "I have a pineapple.<br>";

echo "I have a pen. ";

echo "I have an apple. ";

echo "I have a pineapple. ";

このコードで注意しなくてはならないのは各行の最後に改行(brタグ)が入っていることです。

他の言語と同じ感覚で \n は使えません。

例えば上のコードのbrタグを全て \n に変えたとしましょう。

echo "I have a pen.\n";
echo "I have an apple.\n";
echo "I have a pineapple.\n";

echo "I have a pen.\n";

echo "I have an apple.\n";

echo "I have a pineapple.\n";

こうすると次のように１行として画面上に表示されてしまいます。

I have a pen. I have an apple. I have a pineapple.

1	I have a pen. I have an apple. I have a pineapple.

このようにPHPでの改行コードはHTML上でも改行にはならないので要注意です。

HTMLとして改行するときは必ずbrタグを使う必要があります。

クォートで囲んで出力

PHPでは複数行文字列を一続きのクォートで囲むこともできます。

なので複数行文字列を次のように一気に表示することも可能

/** シングルクォーとの場合 */
echo '
I have a pen.<br>
I have an apple.<br>
I have a pineapple.<br>
';

/** ダブルクォートの場合 */
echo "
I have a pen.<br>
I have an apple.<br>
I have a pineapple.<br>
";

/** シングルクォーとの場合 */

echo '

I have a pen.

I have an apple.

I have a pineapple.

/** ダブルクォートの場合 */

echo "

I have a pen.

I have an apple.

I have a pineapple.

シングルクォートまたはダブルクォートのどちらかで囲んでechoするだけです。

ただこの方法は最後がクォートで終わって見づらいのであまり使わない方がいいかもですね。

あまり使われることはなさそうです。

ヒアドキュメントで出力

PHPで複数行の出力と言えばヒアドキュメントです。

これを使った複数行の表示が次のコード

echo <<< EOM
I have a pen.<br>
I have an apple.<br>
I have a pineapple.<br>
EOM;

echo <<< EOM

I have a pen.

I have an apple.

I have a pineapple.

EOM;

<<< の後にEOMとかの目印を置いて、次にその目印が出てくるまで表示し続けます。

ちなみにヒアドキュメントでもHTMLとして出力するにはbrタグが必要です。

そしてヒアドキュメントのいいところは途中で変数が使えることなんですよね。

例えば次のように変数名を {} で囲めばその変数が展開されます。

$ihavea = 'I have a';
echo <<< EOM
{$ihavea} pen.<br>
{$ihavea}n apple.<br>
{$ihavea} pineapple.<br>
EOM;

$ihavea = 'I have a';

echo <<< EOM

{$ihavea} pen.

{$ihavea}n apple.

{$ihavea} pineapple.

EOM;

このコードでいえば {$ihavea} の部分です。

{$ihavea} が実際に表示されるときは "I have a" に置き換わります。

ちなみに次記事で書いたように、クラス変数とか関数・式なども展開可能

PisukeCode - Web開発まとめ

ヒアドキュメント内でクラス変数・関数・式などを展開する方法

https://pisuke-code.com/here-document-expand-expression

PHPのヒアドキュメントは便利ですよね。ただ１つ問題があって、それはヒアドキュメント内では純粋な変数しか展開できないことです。普通の書き方ではクラス変数や関数あるいは式は書くことができません。ということでその対処法となるコードを紹介します。ヒアドキュメントのおさらい今さら説明するまでもないかもですが一応ヒアドキュメントについて少し説明します。まずヒアドキュメントというのは長～い文字列を表示したり代入したいときに使われる構文です。例えば次がヒアドキュメントの使用例/** 長い文字列を表示したり *...

こういう風にヒアドキュメントは変数も使えて便利なのでよく使います。

場合によっては echo で１行ずつ表示より使いやすいかもしれません。

PHP閉じタグで出力

PHPというのはHTMLを出力するためのものです。

そのコードはPHPの開始タグ( <?php)とPHPの閉じタグ( ?> )の間にかかれています・

なのでそれ以外の場所に何か書くとHTMLとかテキストとして出力することも可能です。

例えば次がPHPから直に出力している例

?>
I have a pen.<br>
I have an apple.<br>
I have a pineapple.<br>
<?php

I have a pen.

I have an apple.

I have a pineapple.

<?php

?> から <?php までの部分がHTMLとして出力されます。

ちなみにこの場合も改行にはbrタグが必要です。

またヒアドキュメントと同じように変数も使えます。

例えば次がそのコード例

$pen = 'a pen';
$apple = 'an apple';
$pineapple = 'a pineapple';
?>
I have <?php echo $pen; ?>.<br>
I have <?php echo $apple; ?>.<br>
I have <?php echo $pineapple; ?>.<br>
<?php