2023年だがVSCodeでPHP5.6でxdebugを使用できるようにする

背景

案件の関係でUbuntu20.04にphp5.6を入れているが、xdebugを使いたかったため入れてみる。

参考

こちらを参考にさせていただきましたが、自分の環境ではいろいろ足りなかったので、補足しながら記述していきます。

環境

Ubuntu20.04
PHP5.6

手順

autoconfのインストール

普通にxdebugをインストールしようとすると古すぎてpeclではインストールできず、ソースインストールもphpizeのautoconfで失敗するとのことでソースに必要なautoconfからインストールを始めます。
downloadsディレクトリを作成しautoconfをインストールし展開

cd /
mkdir downloads
curl -OL http://ftpmirror.gnu.org/autoconf/autoconf-latest.tar.gz
tar xzf autoconf-latest.tar.gz

展開したディレクトリに移動

cd autoconf-2.71

configureファイルを作成

./configure --prefix=/usr/local

次にmakeファイルを作成するがmakeコマンドが無いと怒られたのでインストール

apt install make

makeファイルを作成

make

インストール

sudo make install

Xdebug2.5.5をインストール

downloadsディレクトリに戻りXdebugをダウンロード

cd /downloads
curl -OL https://xdebug.org/files/xdebug-2.5.5.tgz
tar xzf xdebug-2.5.5.tgz
cd xdebug-2.5.5

次にconfigureファイルを作成するためにphpizeコマンドを使用しようとしたがないと怒られたのでインストール

apt install php5.6-dev

configureファイルを作成

phpize

configureを実行

./configure

makeファイルを作成

make

インストール

sudo make install

結果は下記となるがその時に/usr/lib/php/20131226/を記憶しておく。

Installing shared extensions:     /usr/lib/php/20131226/

  +----------------------------------------------------------------------+
  |                                                                      |
  |   INSTALLATION INSTRUCTIONS                                          |
  |   =========================                                          |
  |                                                                      |
  |   See http://xdebug.org/install.php#configure-php for instructions   |
  |   on how to enable Xdebug for PHP.                                   |
  |                                                                      |
  |   Documentation is available online as well:                         |
  |   - A list of all settings:  http://xdebug.org/docs-settings.php     |
  |   - A list of all functions: http://xdebug.org/docs-functions.php    |
  |   - Profiling instructions:  http://xdebug.org/docs-profiling2.php   |
  |   - Remote debugging:        http://xdebug.org/docs-debugger.php     |
  |                                                                      |
  |                                                                      |
  |   NOTE: Please disregard the message                                 |
  |       You should add "extension=xdebug.so" to php.ini                |
  |   that is emitted by the PECL installer. This does not work for      |
  |   Xdebug.                                                            |
  |                                                                      |
  +----------------------------------------------------------------------+

Xdebugの設定

XdebugをPHP5.6で使用できるように設定していきます。
php.iniを編集

sudo vim /etc/php/5.6/apache2/php.ini

zend_extensionに先ほどインストールしたxdebugのパスを設定（パスは先ほど記憶したパス）

zend_extension=/usr/lib/php/20131226/xdebug.so

その他の設定も行う
※xdebug3と設定が違うので注意

zend_extension=/usr/lib/php/20131226/xdebug.so

[xdebug]
; Xdebugの機能を有効化
xdebug.remote_enable=1
; PHPの実行時にデバッグを自動的に開始する
xdebug.remote_autostart=1
; 接続先ホスト
xdebug.remote_host=localhost
; 接続先ポート
xdebug.remote_port=9003

apacheの再起動

sudo service apache2 stop
sudo service apache2 start

年のためphpinfoを確認すると設定できている

VSCodeのlaunch.jsonを設定

"configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/var/www/html/対象ディレクトリ名": "${workspaceRoot}"
            },
        },