Eclipse上でPHPのデバッグを実行したいと考えたのですが、設定に結構苦戦しました。
同じ悩みを抱える人も多いようなので、備忘録として公開してみます。ほぼ素人の考え方なので、見当違いな部分もあると思いますが、そこは勘弁してください。
OS: Windows7 64bit
PHP: 7.3.7
Apache: 2.4.39
※PHPをローカル環境で使う場合は、xamppを利用することが多いと思いますが、今回の例ではPHPとApacheを単独でインストールします。
PHPとApacheのインストール・設定
PHPのインストールはこちらを参照、
Apacheのインストールはこちらを参照しました。
PHP: 7.3.7
Apache: 2.4.39
phpinfo()を使って、設定内容を確認する画面を出します。こちらを参照。下図のようにブラウザに表示されるはず。このページはこのまま表示させておきます。
###xdebugの入手とphp.iniの設定
[link-4]:https://xdebug.org/wizard.php
[こちら][link-4]のページで、xdebugのdllをダウンロードします。さっき表示しておいたPHP設定内容を確認する画面で、内容を全部コピー(ctrl + a → ctrl + c で大丈夫)し、ダウンロードページのテキストエリアに貼り付けます。これで必要なxdebugのバージョンを調べてくれるので、「Analyse my phpinfo() output」ボタンを押してダウンロードへ。
自分の環境では、"php_xdebug-2.7.2-7.3-vc15-x86_64.dll"というファイルがダウンロードされました。このdllファイルを、php.iniと同階層にある"ext"フォルダに格納します。
次にphp.iniを開き、末尾に以下のように追加。
[XDebug]
zend_extension=C:\php-7.3.7\ext\php_xdebug-2.7.2-7.3-vc15-x86_64.dll
xdebug.remote_connect_back=On
xdebug.remote_enable = 1
xdebug.remote_host = "localhost"
xdebug.remote_port = 9000
zend_extension= には、xdebugのdllを格納したディレクトリを指定。
xdebug.remote_port は、9000にしておくのが一般的みたいです。
Apacheを再起動し、再びphpinfo()でPHPの設定を確認。下図のようにxdebug関連の情報が表示されていればOK。
eclipseのインストールと設定
※eclipseをインストールする前に、Apache、PHP、xdebugのダウンロードと設定、php.iniの設定をしておいたほうが無難なようです。
先にeclipseをインストールしたら、起動時にサーバー関連のエラーが出るようになってしまったので。自分の知識不足とは思いますが。
エラーの発生を止められなくなった時に、eclipseのworkspaceのフォルダを丸ごと削除したら発生しなくなりました。プロジェクト等を作成してからではできないことなので、先にデバッグができる環境を整えることを優先すべきかと思います。
こちらから、Eclipse IDE for PHP Developersをダウンロードし、インストール。
PHP開発用のプラグインもありますが、PHP専用のeclipseを別にインストールするほうが無難な気がします。動作がおかしくなっても、インストールし直せば済むことになるので。
Pleiadesで日本語化もしておきましょう。
eclipseをインストールしたら、「ウィンドウ」→「設定」→「PHP」→「インストール済みのPHP」で、新規のPHP実行可能ファイルを登録します。
「次へ」ボタンで、デバッガー設定へ。「デバッガー」はXdebug、ポートは9000を指定。この設定は不要かもしれませんが、やっておいたほうがいいとは思います。
###プロジェクト用のディレクトリとファイル作成
通常はeclipseのworkspaceにプロジェクトのディレクトリを作成しますが、今回はApacheのドキュメントルートの下に作成します。
Apacheをインストールしたディレクトリの、"htdocs"フォルダの下にプロジェクト用のディレクトリを作成。
eclipseから、このディレクトリをインポートします。
構成としては、下図のようになっています。
「実行」→「デバッグ構成」から、PHP Webアプリケーションで新規構成を選択。
最初に、PHPサーバーを新規登録します。
サーバー名は適当に。ベースURLはlocalhost指定で。ドキュメントルートは、Apacheのドキュメントルートを指定。
「次へ」でデバッグの設定へ。
デバッガーはXdebug。ポートは9000を指定。「完了」ボタンで終了。
次にデバッグ構成を登録します。PHPサーバーは、先程新規登録したサーバーを指定。ファイルは、プロジェクトのindex.phpでいいでしょう。他のファイルを指定もできます。
これでデバッグモードで実行できるようになりました。下図のように、ブレークポイントで止まります。変数の値も取得できます。
注意点として、デバッグで実行ではなく通常の実行でスタートしても、強制的にデバッグモードになってしまうようです。通常の実行をするなら、「実行の構成」でデバッグを"None"にしたPHPサーバーを指定しておくといいようです。
全般的に、こちらのページが非常に参考になりました。このページを見たほうが分かりやすい人も多いと思います。
今回参考にしたリンク。
PHP入門
Apache入門
phpinfo関数による設定内容の確認
[Xdebug Tailored Installation Instructions][link-4]
Eclipse Packages Download
Pleiades Plugin ダウンロード
【PHPへ xdebug導入】は簡単。実はEclipseで動かす設定が環境依存で若干ややっこい
Eclipse PHP(Pleiades All in One)でハマった件 起動でエラー