PHPの基礎 - 入出力

概要

出力

echo文

print文

改行

echo文およびprint文は、自動改行されない。
改行を入れる場合は、以下に示すいずれかの方法を使用する必要がある。

 // 改行文字を明示的に指定
 
 echo "Hello\n";
 print "World\n";

 // HTMLの改行タグを使用
 
 echo "Hello<br>";
 print "World<br>";

 // PHP_EOLの使用 (推奨)
 
 echo "Hello" . PHP_EOL;
 print "World" . PHP_EOL;

PHP_EOLは、ログファイル・テキストファイルへの出力、データベースへの保存での使用で推奨される。
ただし、WebページとしてHTMLへ出力、メールテンプレート (HTML形式) へ出力する場合は、<br>を使用すべきである。

プラットフォーム独立性
PHP_EOLは、実行環境に応じて適切な改行コードを自動的に使用する。

Windows : \r\n

UNIX/Linux : \n
移植性の向上
異なるOS間でのファイル処理が容易になる。

基本的に、最終的な出力形式に合わせて使い分ける。
もし混在させる必要がある場合は、nl2br関数を使用してPHP_EOLを<br>に変換することもできる。

 $text = "1行目" . PHP_EOL . "2行目";
 echo nl2br($text);

変数の展開

変数の内容を展開して表示する場合、echo文とprint文にはいくつかの違いがある。

 // 基本的な変数展開 (どちらも同じように動作)
 
 $name = "田中";
 
 echo "こんにちは、$nameさん";   // こんにちは、田中さん
 print "こんにちは、$nameさん";  // こんにちは、田中さん

 // 複数の変数を表示する場合
 
 $first = "田中";
 $last = "太郎";
 
 // echo文は、カンマで区切って複数の引数を渡すことが可能
 echo $first, " ", $last;     // 田中 太郎
 
 // print文は1つの引数しか受け付けないため連結が必要
 print $first . " " . $last;  // 田中 太郎

 // 配列やオブジェクトのプロパティを展開する場合
 
 $person = ["name" => "田中"];
 
 // 波括弧を使用した複雑な展開（どちらも同じ）
 echo "こんにちは、{$person['name']}さん";
 print "こんにちは、{$person['name']}さん";

echo文とprint文の違い

print文の特徴

print文は、値を1つしか出力できない。
print文は、常に1を返す値を持つ。
print文は値を返すため、わずかにechoより遅い。
ただし、通常の使用では実用的な差はほとんどない。

echo文の特徴

echo文は、複数の値をカンマ区切りで出力できる。
echo文は値を返さない。
echo文は複数の引数を受け付けられるため、変数を多数表示する必要がある場合はecho文の方が記述しやすく、可読性も高くなる。

ヒアドキュメント

ヒアドキュメントを活用することにより、長い文字列やテンプレートを見やすく管理することができる。

ヒアドキュメントの特徴を以下に示す。

開始識別子 (EOT等) の後には改行以外の文字を入れてはならない。
終了識別子は行頭になければならない。
ただし、PHP 7.3以降は可能
識別子は任意の文字列を使用可能。(EOT, EOD, HTML等)
<<<'EOT' のように引用符で囲むとNowdocとなり、変数展開されない。
PHP 7.3以降では終了識別子のインデントが可能。
文字列結合や関数の引数としても使用可能である。

ヒアドキュメントが使用されるユースケースを以下に示す。

HTMLテンプレート
SQLクエリ
メールテンプレート
JSONデータ
設定ファイル

# ヒアドキュメントの構文

<<<(ID)
<複数行にまたがる文字列>
(ID);

 <?php
 // 基本的な使用方法 1
 
   echo <<<DATA
   <!DOCTYPE html>
   <html lang="ja">
   <head>
      <meta charset="utf-8">
      <title>ヒアドキュメントの基礎</title>
   </head>
   <body>
     <header></header>
     <main>
       <h1>PHPをHTMLの中に埋め込む</h1>
       <p>ヒアドキュメントで出力したHTMLファイル</p>
     </main>
     <footer></footer>
   </body>
   </html>
   DATA;
 ?>
 
 <?php
 // 基本的な使用方法 2
 
 $name = "太郎";
 $text = <<<EOT
 こんにちは、{$name}さん。
 これはヒアドキュメントのサンプルである。
 複数行の文字列を簡単に記述することができる。
 EOT;
 ?>
 
 <?php
 // Nowdocの例（変数展開されない）
 
 $text2 = <<<'EOD'
 こんにちは、{$name}さん。
 この中では変数は展開されない。
 そのまま {$name} と表示される。
 EOD;
 ?>
 
 <?php
 // インデントを保持する例 (PHP 7.3以降)
 
 $html = <<<HTML
    <div class="container">
       <h1>タイトル</h1>
       <p>これは段落である。</p>
    </div>
 HTML;
 ?>
 
 <?php
 // 関数の引数として直接使用
 // json_encodeは関数である
 
 echo json_encode([
    'description' => <<<JSON
    これは
    JSON形式の
    長い説明文である。
    JSON,
    'title' => 'サンプル'
 ]);
 ?>
 
 <?php
 // メソッドチェーンでの使用 (PHP 7.3以降)
 
 $message = (new EmailMessage())
    ->setBody(<<<EMAIL
    お問い合わせありがとうございます。
    以下の内容で承りました。
 
    件名: {$subject}
    EMAIL)
    ->setSubject('自動返信メール');
 ?>

PHPの基礎 - 入出力

目次

概要

出力

echo文

print文

改行

変数の展開

echo文とprint文の違い

print文の特徴

echo文の特徴

ヒアドキュメント

案内メニュー

PHPの基礎 - 入出力

概要

出力

echo文

print文

改行

変数の展開

echo文とprint文の違い

print文の特徴

echo文の特徴

ヒアドキュメント

案内メニュー

検索