ヒアドキュメントを使った文字列リテラルの作成

文字列を作成する場合はヒアドキュメントと呼ばれる形式を利用することができます。ここでは PHP でヒアドキュメントを使った文字列リテラルの作成方法について解説します。

文字列を作成するにはヒアドキュメントを使用することもできます。ヒアドキュメントを記述するには <<< のあとに任意の文字列を記述した ID を記述し、改行してください。最後に先ほど書いた同じ ID の文字列を記述します。

<<<ID
文字列1
文字列2
文字列3
ID

※ ID として指定できる文字列は英数字またはアンダーバーの組み合わせで指定し、数字からは開始できません。

ID の部分は任意の文字列が指定できます。例えば LABEL という値を使用した場合は次のようになります。

echo <<<LABEL
こんにちは。
お元気ですか？
LABEL;

DOC という値を使用した場合は次のようになります。

echo <<<DOC
こんにちは。
お元気ですか？
DOC;

複数行にわたる文字列を記述する場合に便利です。また改行がそのまま改行として出力されるため、先ほどの例を実際に出力すると次のようになります。

こんにちは。
お元気ですか？

ヒアドキュメントを使った文字列の中ではシングルクオーテーション( ' )やダブルクオーテーション( " )も単なる文字として扱われます。エスケープする必要がありません。

echo <<<END
I'm a student.
I go to "school" by bus.
END;

ただし( ' )や( " )以外のエスケープシーケンスは有効です。例えば「\n」と記述すると改行されるので、単なる文字として「\n」と記述したい場合はエスケープして「\\n」と記述する必要があります。

また ID として指定した文字列が、ヒアドキュメントの文字列の中に現れるとエラーとなるため、文字列の中で使用する文字列は ID に使用しないでください。

エスケープシーケンスと変数展開

ヒアドキュメントで文字列を作成した場合は、ダブルクオーテーション( " )で囲んだ文字列と扱いは同じになります。そのため、エスケープシーケンスや変数展開も利用できます。

次の例を見てください。

<?php
$name = "本田";
echo <<<LABEL
こんにちは。\n私の名前は{$name}です。
LABEL;

エスケープシーケンスで改行を行った上に変数展開を行っています。この場合は次のように表示されます。

こんにちは。
私の名前は本田です。

ヒアドキュメントの ID の部分をシングルクオーテーション( ' )で囲んだものを Nowdoc と呼びます。(終端 ID の方は囲みません)。

<<<'ID'
文字列1
文字列2
文字列3
ID

Nowdoc で文字列を作成した場合は、シングルクオーテーション( ' )で囲んだ文字列と扱いは同じになります。そのため、エスケープシーケンスや変数展開は行われません。

次の例を見てください。

<?php
$name = "本田";
echo <<<'LABEL'
こんにちは。\n私の名前は{$name}です。
LABEL;

エスケープシーケンスや変数展開は行われないため、次のように表示されます。

こんにちは。\n私の名前は{$name}です。

ヒアドキュメントの終端 ID は通常は行の先頭に記述しますが、終端 ID の前にスペースやタブでインデントを追加した場合は、終端 ID の位置がヒアドキュメント全体の先頭位置となります。

次の例を見てください。

<?php
echo <<<LABEL
     こんにちは。
       私の名前は本田です。
LABEL;

これは次のように表示されます。

     こんにちは。
       私の名前は本田です。

では終端 ID の前にスペースを 4 つ追加してみます。

<?php
echo <<<LABEL
     こんにちは。
       私の名前は本田です。
    LABEL;

終端 ID の位置がヒアドキュメントの先頭として扱われるので、次のように表示されます。

 こんにちは。
   私の名前は本田です。

このように終端 ID の前にスペースやタブを追加することで、ヒアドキュメント全体のインデントを設定することができます。なお終端 ID の位置よりも前に文字列が表示されている場合はエラーとなります。

サンプルコード

では簡単なプログラムで試してみます。

<?php
echo <<<LABEL
こんにちは。
私の名前は"本田"です。
また会いましょう。
LABEL;

作成したプログラムを sample.php として保存しました。その後でコマンドプロンプトを起動し、次のように実行しました。

php sample.php

ヒアドキュメントを使った文字列リテラルの作成

ヒアドキュメントの形式で作成した文字列が画面に出力されました。

-- --

PHP でヒアドキュメントを使った文字列リテラルの作成方法について解説しました。

( Written by Tatsuo Ikura )

これから IT 関連の知識を学ばれる方を対象に、色々な言語でのプログラミング方法や関連する技術、開発環境構築などに関する解説サイトを運営しています。