UbuntuとPhpStormでリモートデバッグする方法

2017/10/18

WordPressのプラグインを作っていたとき。
Ubuntu上のWordPressをPhpStormでステップ実行デバッグしたくなった。
UbuntuにXdebugをインストールしてPhpStormを設定した。

もくじ（クリックで各章に飛ぶ）

パッケージのインストール
Xdebug側の設定
1. 設定ファイル修正
2. Apacheの再起動
PhpStorm側の設定
1. リモートデバッグの有効化
2. リモートサーバーの指定
デバッグ実行のやり方
注意：デバッグONだと糞遅くなる
関連記事

パッケージのインストール

sudo apt install php-xdebug

を実行すると入る。

PHPのバージョンを確認するとXdebugのコピーライトが追加されている。

fuka@techo:/var/www/html/wordpress$ php -v
PHP 7.0.13-0ubuntu0.16.04.1 (cli) ( NTS )
Copyright (c) 1997-2016 The PHP Group
Zend Engine v3.0.0, Copyright (c) 1998-2016 Zend Technologies
    with Zend OPcache v7.0.13-0ubuntu0.16.04.1, Copyright (c) 1999-2016, by Zend Technologies
    with Xdebug v2.4.0, Copyright (c) 2002-2016, by Derick Rethans

Xdebug側の設定

設定ファイル修正

設定は /etc/php/7.0/apache2/conf.d/20-xdebug.ini にある。

sudo vi /etc/php/7.0/apache2/conf.d/20-xdebug.ini

最初は１行しか無い。

zend_extension=xdebug.so

これを

zend_extension=xdebug.so

xdebug.remote_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_port = 9000
xdebug.remote_host = 192.168.1.20
xdebug.profiler_enable = 1
xdebug.profiler_output_dir = "/tmp"
xdebug.max_nesting_level = 1000
xdebug.idekey = "PHPSTORM"

にする。

ミソは２箇所、xdebug.remote_hostにはPhpStormを実行するPCのアドレスを、xdebug.idekeyには"PHPSTORM"を指定する。

Apacheの再起動

sudo apachectl restart

を実行。

PhpStorm側の設定

【Windows10Pro】IIS＋PhpStormによるPHPアプリの開発準備

Windows10 Proに標準添付のIIS 10を使い、PHP 7.0を開発・デバッグできるようにするまでの手順。 php.iniも配布。

の応用になる。

プロジェクトを開いたら、File⇒Settignsで設定画面を開く。

リモートデバッグの有効化

Languages & Frameworks⇒PHP⇒Debugを辿る
Debug portをxdebug.iniと合わせる
また、Can accept external connectionsにチェックを入れる
設定が初めてなら以下の設定も行っておく
1. [Use debugger bookmarklets to initiate debugging from your favorite browser]をクリックしてブックマークレットを設定
2. デバッグプロファイルの作成