PHPでデバッグログを出力する方法を現役エンジニアが解説【初心者向け】

今回は、PHPでデバッグログを出力する方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。

PHPでデバッグログを出力することで、PHPのデバッグで何を行ったか確認できます。

実務でも、PHPでデバッグログを出力して、動作検証を行いますので、ぜひ学習してみてください。

目次

• デバッグ
• var_dump関数の概要と使い方
• var_export関数の概要と使い方
• print_r関数の概要と使い方
• 実際に書いてみよう
• まとめ
• PHPを学習中の方へ

そもそもPHPについてよく分からないという方は、PHPとは何なのか解説した記事を読むとさらに理解が深まります。

今回は、PHPに関する内容だね！

どういう内容でしょうか？

PHPでデバッグログを出力する方法について詳しく説明していくね！

お願いします！

デバッグ

デバッグとは、作成したプログラムを実際に利用しながら、処理の詳しい流れを確認することです。

デバッグを行うことで、プログラムをリリースする前に不具合を検証することが可能です。

PHPで、デバッグを行う代表的な関数には次の3つがあります。

1. var_dump関数
2. var_export関数
3. print_r関数

var_dump関数の概要と使い方

PHPのvar_dump関数は、引数として渡した変数の中身を詳細にダンプする関数です。

ダンプとは表示するという様な意味です。

主に、コーディングした処理内容が、正しいか検証する「デバッグ」を行う際に使用します。

var_dump関数の使い方

サンプルコード

var_dump($ダンプしたい変数)

解説

var_dump関数に、引数として「ダンプしたい変数」を指定します。

var_dump関数を実行した結果、返り値として値を何も返しません。

返り値とは、戻り値とも呼ばれ、関数を実行した結果得られる値を意味します。

[PR] PHPプログラミングで挫折しない学習方法を動画で公開中

var_export関数の概要と使い方

PHPのvar_export関数も、var_dump関数と同じく引数として渡した変数の中身を表示するための関数です。

var_export関数も、主にデバッグ時に使用する関数で、var_dump関数と非常によく似ています。

var_dump関数は、返り値を返却しないのに対し、var_export関数は、返り値として「ダンプした結果」が返却される違いがあります。

つまり、var_export関数でダンプした変数の内容を変数に代入し、その後のPHPスクリプト内で使用できるということです。

サンプルコード

var_export($ダンプしたい変数[, $返却フラグ])

解説

var_export関数の第1引数に「ダンプしたい変数」を渡します。

引数とは、関数を利用する際に関数側で処理するための値です。

また、第2引数にboolean型で「true」を引数として渡した場合、var_export関数はダンプした変数の内容を返却します。

第2引数はオプションのため、引数を渡すかは任意です。

引数を渡さない場合は、デフォルトでboolean型で「false」に設定されているため何も返却しません。

boolean型というのは、真か偽かを表す変数の型です。

真の場合は「true」、偽の場合は「false」という結果になります。

コラム

実は私も！？独学で損する人の特徴

「スクールは高いから独学で成功する」という気持ちの方は多いと思います。
もちろんその方が金額は低く抑えられるでしょう。
ただ 独学には向き不向きがあり、実はスクールが向いている人も大勢います。

そんな方のために参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

• ・困って挫折しそうなときに、質問や相談できる相手がいる環境で学んでいきたいなと思った
• ・わかった気になっているだけだったので、自分を追い込む環境に置いた方がいいと感じた
• ・スクールのカリキュラムで市場に求められるスキルを学ぶべきと思った

少しでも当てはまる部分があれば、 スクールが向いているかもしれません。
お試しのつもりで、まずは一度 無料相談 に参加してみませんか？

現役エンジニア・デザイナーに何でも気軽に相談できる30分 を すべて無料で できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き！ 無料相談はこちら

print_r関数の概要と使い方

PHPのprint_r関数も、var_dump関数やvar_export関数と同じく、引数として渡した変数の中身を表示するためのデバッグ用の関数です。

print_r関数は、var_export関数と同じく、返り値として「ダンプした結果」を返却できます。

var_dump関数とvar_export関数と比べ、print_r関数は値だけを確認したいというような、簡易的なデバッグを行う際に使用するとよいでしょう。

サンプルコード

print_r($ダンプする変数 [, $返却フラグ])

解説

print_r関数の第1引数に「ダンプしたい変数」を渡します。

また、第2引数にboolean型で「true」を引数として渡した場合、print_r関数はダンプした変数の内容を返却します。

第2引数はオプションのため、引数を渡すかは任意です。

引数を渡さない場合は、デフォルトでboolean型で「false」に設定されているため、何も返却しません。

実際に書いてみよう

var_dump関数とvar_export関数とprint_r関数を使用して実際に書いてみましょう。

デバッグ内容を表示する

ここでは、var_dump関数とvar_export関数とprint_r関数を使用して実際に変数の中身をダンプし、比較する実装を実際に書いてみましょう。

サンプルコード

<?php
$array = array(
  'apple' => 'りんご',
  'orange' => 'みかん',
  'banana' => 'ばなな'
);

var_dump($array);
var_export($array);
print_r($array);

実行結果

解説

<?phpでは、PHPプログラムを開始しています。

$array = array(では、配列を宣言して、変数$arrayに代入しています。

‘apple’ => ‘りんご’,が1つ目の配列データです。

‘orange’ => ‘みかん’,が2つ目の配列データです。

‘banana’ => ‘ばなな’が3つ目の配列データです。

);では配列の宣言を終了しています。

var_dump($array);では、var_dumpを利用して変数$arrayをデバッグしています。

var_export($array);では、var_exportを利用して変数$arrayをデバッグしています。

print_r($array);では、print_rを利用して変数$arrayをデバッグしています。

ログファイルに出力する

ここでは、var_export関数とprint_r関数は返り値を使用して、ログファイルにその内容を出力する方法を実際に書いてみましょう。

サンプルコード

<?php
$array = array(
  'apple' => 'りんご',
  'orange' => 'みかん',  
  'banana' => 'ばなな'
);
error_log(var_dump($array,true), 3, './debug1.txt');
error_log(var_export($array, true), 3, './debug2.txt');
error_log(print_r($array, true), 3, './debug3.txt');

下記の例では、error_log関数を使用して、第3引数に指定したログ出力用のファイルにダンプしています。

error_log関数の第1引数にvar_export関数かprint_r関数を使用することで、返り値のダンプ結果が引数として渡されます。
※error_log関数の第2引数に3を渡すことで、ファイル出力します。

<?php
$array = array(
　'apple' => 'りんご',
　'orange' => 'みかん',
　'banana' => 'ばなな'
);
error_log(var_export($array, true), 3, './debug.txt');
error_log(print_r($array, true), 3, './debug.txt');

実行結果

解説

<?phpでは、PHPプログラムを開始しています。

$array = array(では、配列を宣言して、変数$arrayに代入しています。

‘apple’ => ‘りんご’,が1つ目の配列データです。

‘orange’ => ‘みかん’,が2つ目の配列データです。

‘banana’ => ‘ばなな’が3つ目の配列データです。

);では配列の宣言を終了しています。

error_log(var_dump($array,true), 3, ‘./debug1.txt’);では、var_dumpを利用してデバッグしています。

var_dumpは戻り値がないため、debug1.txtには何も保存されません。

var_dumpの場合は、プレビュー画面にデバッグ結果が表示されます。

error_log(var_export($array, true), 3, ‘./debug2.txt’);では、var_exportを利用して、debug2.txtにデバッグ結果を次のように保存しています。

array (
  'apple' => 'りんご',
  'orange' => 'みかん',
  'banana' => 'ばなな',
)

error_log(print_r($array, true), 3, ‘./debug3.txt’);では、print_rを利用して、debug3.txtにデバッグ結果を次のように保存しています。

Array
(
    [apple] => りんご
    [orange] => みかん
    [banana] => ばなな
)

まとめ

以上、PHPでデバッグする時に使用する関数を紹介しました。

戻り値については、PHPで関数を自作して戻り値を返す方法も参考にしてみてください。

引数については、PHPで関数と引数を使う方法も参考にしてみてください。

boolean型については、PHPの論理演算子の使い方も参考にしてみてください。

var_dump関数とvar_export関数とprint_r関数の違いは、ダンプ結果の表示内容が異なる点にありました。

var_export関数とprint_r関数は返り値を返却するので、ログファイルに保存することができました。

内容が分かりやすくて良かったです！

ゆかりちゃんも分からないことがあったら質問してね！

分かりました。ありがとうございます！

PHPを学習中の方へ

これで解説は終了です、お疲れさまでした。

• つまずかず「効率的に」学びたい
• 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか？

テックアカデミーのPHP/Laravelコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、PHP/Laravelを使ったWebアプリケーション開発を学べます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！

プログラミングを独学していて、このように感じた経験はないでしょうか？

• ・調べてもほしい情報が見つからない
• ・独学のスキルが実際の業務で通用するのか不安
• ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、現役エンジニア講師とマンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう 厳しい試験を通過した講師 があなたの相談に真摯に向き合います。

「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」
こんな気持ちでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。（1週間限定）

今なら参加者限定の割引特典付き！ 無料相談を予約する