ローカルMacに、Laravelを入れた。

最近はphpでもデバッグできるらしい。
「printデバッグよりも、全然効率が違いますから」なんて書いてあると気になる。
VS Code上で、PHPのデバッグとコード補完が利用できるらしい。

今さら気が付いたのだが、本やブログなどを見ると、SailだのDockerだの、
環境を一まとめにしたツールを使っている。

解説もそれを前提としているので、環境が違うと動かなかったりする。
だから、最初は、面倒であっても、その本やブログで紹介されているツールと同じのを使うのがいいのかな。
※私の環境では、そういったものは使用していない。
他のブログや本で動かなかった時のヒントになればと思います。

インストールメモ。

環境：
・Mac OS 12.5.1 M1
・php 8.0
・Laravel 9
・VS CODE
・XDebug 3.1.5 （２系、３.２系と微妙に設定が違うようです）
・サーバは、php artisan serve

VS Codeは、インストーラーがあったので、それを利用。
私のバージョンでは、VS Codeを起動して、[Code]->[基本設定]->[機能拡張］と進み、
PHP Debugと、PHP IntelliSenseがセットになった、PHP Extension Packとかいうのをインストールした。

XDebugは、

pecl install xdebug

でできた。

そして、ローカルなphpファイルにブレークポイントを設定してデバッグ実行すると、
そのブレークポイントを設定した地点で実行が停止した。

ここまではよかったのだが、サーバー上で実行するとブレークポイントで止まってくれない。

ブログや本とはパスなどが違い、なかなか動いてくれない。
色々やってやっと動いた。数時間は掛かった。
XDebugとサーバを連動させることが肝であった。

以下は、私の環境でできたものである。

【重要かつ基本】
php -vやphpinfoなどの出力でXDebugが組み込まれているか調べること。
これが一番大事。つまりキングです。
設定ファイルが複数あるケースで、どれが反映しているかわからないときは、
実際に読み込まれている情報を確認すること。
そして、（あれば）ログファイルのエラーを見ること。

php.ini

先頭に

zend_extension="xdebug.so"

これでよかった。homebrewでインストールした先のパスを調べて書かなくても私の環境では問題ない。
コマンドで確認できた。

ファイル末尾に、

[xdebug]
xdebug.mode=debug
xdebug.start_with_request=yes

この２行追加。
これがないと、サーバーで実行した時にブレークポイントで停止してくれない。
Xdebug.client_hostや、xdebug.client_portを指定するとエラーになった。
これはバージョンにもよるのだろう。ちなみに私のはXDebug 3.1.5

ここが一番のハマリだった。
つまり、xdebug.modeとxdebug.start_with_requestだけ設定して、他のものは設定しない。大抵、remote_hostやclient_hostを設定する例が載っている。

今回、デフォルトで動くものがほとんどだった。逆に、値を設定してエラーになるケースが本当に多かった。
私の知識不足なんだろう。おそらく、ツールの配布元など、オーソリティーを詳しく調べると分かるものもあったのかも。

launch.json (VS CODE)

[...]
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003
        },
[...]

デフォルトでいい。ローカルなので"pathMappings"は必要ない。
下手に入れるとエラー（Class Not Found）になりがち。

デバッグ実行は、launch.jsonを開いたタブで実行。
ソースファイルだと階層違いでClass Not Foundエラーになった。

ファイルが見つからないときは、隠しフォルダの.vscodeを削除して、
もう一回、launch.jsonを作成する。（VS Codeのキャッシュエラー？）

次は、myPHPAdmin行ってみよう！

以上

【昔話】
そういえば、昔（２０年くらい前？）、Visual Studioのエディタに補完機能が付いていて、
それで色々と表示される候補を見て、クラスライブラリの使い方を覚えていったっけなぁ。

VCのエディタが便利で、Windowsが関係ないCのソースコードなんかにも、使っていた。
秀丸はその時あったのかな？先輩はMifesというエディタの方が多かったと記憶している。

なんでもvimでやるのが「通」だと思っていたのだが、結局マスターできず。
今回、VS CodeにVimプラグインがあったので、早速インストールして喜んでいる。