Help us understand the problem. What is going on with this article?

var_dumpからの卒業、PHP開発を加速するデバッグ手法を考える

More than 3 years have passed since last update.

PHPでデバッグ

PHPでのデバッグってみなさん何してます?って聞くと、半分くらいはvar_dump();echoって返ってくるんです。マジか、とか思うんですけど僕も数年前そうでした。情弱ですね。最近、RailsでWebアプリ作っていると、binding.pryが手放せない感じになってきてまして、なんでRails(Ruby)で書くんですか?と聞かれたら、binding.pryがあるからだと半分くらい本気で思っていて、そんなbinding.pry脳のままPHPの開発にスイッチすると、ちょっとしたことでウガーとなるわけです。JavaやObjective-Cでコード書いている人から見たら、そんなプログラミングのやり方あるのん?と驚かれるわけです。

var_dump();を書いてはブラウザ更新して変数の中身を確認したり、メソッドの挙動を確かめるために再度実行したり…そんな苦行からは卒業したい!というわけで、PHPでもRubyのbindig.pry的にデバッグするには…?と模索する趣旨の記事です。

binding.pryのなにがいいか

実際にbinding.pryをしかけて、デバッグをする様子をアニメーションGIFにしました。分かりにくいですが、Googleログイン後に、pryが起動しています。ブレークポイントをしかけた場所で動作が止まり、そこのスコープでRubyのコードが対話的に書けます。つまり、ブラウザを何回も更新しなくてもいいんです。

binding.pry.gif

  • ブレークポイントをしかけてブラウザでリクエストするとpryが立ち上がって対話的にデバッグ可能

どうも思った通りに動かないなーというところにbinding.pryと書いて、rails serverでローカルサーバを立ち上げ、ブラウザで叩くと、自動的に対話的なコンソールが立ち上がり、オブジェクトの中身や、メソッドの挙動などを細かくデバッグできます。なにも小難しい設定は必要ない。Gemfilepry-byebugと書いて突っ込むだけ。以上。

binding.pryそのものについて、もっと知りたい人は以下の記事がイカしてるのでどうぞ。

PsySHでREPLなデバッグ

PsySH.png

で、PHPにもpryのようなPsySHというREPL対話式コンソールがあります。導入も簡単で、wgetで直接もってくるか、composerでインストールするだけ。pryみたいなノリでいけます。

じゃあ、そいつを今手元で動かしているCakePHPやらZendやらsymfony2やらLaravelで動かしたい!となるわけです。どうすればいいか。もう簡単です。requireしてeval()でブレークポイント仕掛けたい場所でPsySHを起動するだけ!コード見ろ!見て!

<?php
require('./psysh'); // 手動で配置した場合、 composerの場合はautoload使う

function hoge() {
    $name = "piyo";

    eval(\Psy\sh()); // ブレークポイント!

    return $name;
}

もうなんというか、これだけです。

後は、サーバを起動します。サーバに関してはphp-fpmmod_phpではなくビルトインのサーバを使用します。

$ php -S 192.168.33.100:9000

ブラウザでアクセスし、ブレークポイントを通過したらPsySHが起動します。そこでゴニョゴニョデバッグできます。ただし、ステップ実行はできません。デバッグしたらexitでリクエストが終了します。ここだけオシイ!それでも実行環境やエディタを問わずデバッグできるので気軽でおすすめです。

PHPStormでステップ実行

いや…でもステップ実行できないとか、それ本当にPHPの開発加速してやれんの?ってなるんです。というわけで、ステップ実行したいのであれば、IDE的なソフトウェアが必要になってきます。本当はPsySHだけで完結したいけど仕方がない。

Eclipseでもできるっぽいんですが、Eclipseはあんまり好きじゃないのでPHPStormを使います。有償ですが良い感じのソフトです。おすすめ。

PHP実行環境の設定

デバッグには、定番xdebugを使います。

$ sudo yum -y install php-pecl-xdebug
/etc/php.ini
xdebug.remote_enable = On
xdebug.remote_autostart = On
xdebug.remote_host = 192.168.33.1 ;デバッグする環境のIPを指定
xdebug.remote_port="9000"
xdebug.profiler_enable=1
xdebug.profiler_output_dir="/tmp"
xdebug.max_nesting_level=1000
xdebug.idekey = "PHPSTORM"

PHPStormのデバッグ設定

ちょっと、分かりにくいです。

PHPデバッグサーバ

PHPStorm→Preferences→Languages&Frameworks→PHP→Serversから、デバッグサーバの設定をします。今回はVagrant環境でやりますが、リモートのテストサーバでも同様なノリでいけます。

php1.png

項目
Host PHP実行環境のIPアドレス/ホスト名(今回はVagrantの環境)
Port 適宜
Debugger Xdebugを選択
Use path mappings チェックを付けて、PHPStorm側のパスとデバッグサーバ側のパスを合わせます。
今回の例だと /Users/zaru/hoge/htdocs と /vagrant/hoge/htdocs みたいな。

デバッグ設定

PHPStorm→Run→Edit configurationsからデバッグの設定をします。

php2.png

php3.png

項目
Configuration PHP Remote Debug
Name 適宜
Servers 先ほど作成したサーバを選択
Ide key PHPSTORM

ここはあまり小難しいことはなく、さっき作ったサーバを選択して「Ide key(session id)」に /etc/php.ini のxdebug.idekeyで指定したものを入力します。今回の例だと「PHPSTORM」です。

デバッガ起動

Run→Debugでデバッガが起動します。そして、Start Listening for PHP Debug Connectionsをクリックします。

php4.png

以上で準備が整いました。

ブレークポイントを設定

php5.png

設定したいコードの左端をクリックすると赤い丸がつきます。これがブレークポイントです。いざ、ブラウザでアクセス!すると、Debuggerのタブがピコット起動して、変数の中身を見たり、ステップ実行したりできます。非常に強力ですね。Rubyのbinding.pryに比べると、前準備がちょっと大変ですが、一度設定してしまえば気軽に使えるので、良い感じです。

php6.png

少なくともvar_dump();echo、ログ出力などの人力デバッグに比べると、だいぶ開発が加速するような環境になっているかと思います。もっとPHPの開発を加速できるような環境を探し求めて今日もまた旅に出ようと思います。

明日は@zaruです!

zaru
basicinc
マーケティングとテクノロジーで社会のあらゆる問題を解決する集団
https://tech.basicinc.jp/
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした