在 Ubuntu 安裝 Xdebug

前言

Xdebug 是一個好用的除錯工具，
搭配 VSCode 可以下中斷點，可以監看變數。
讓開發的效率大幅提升。

本文適用的開發環境為 Ubuntu 20.04 與 Ubuntu 22.04。
不包含 Docker 或 Laravel Sail ，容器化的作法會在以後另開文章。

完了又挖坑了

想要在 Windows 環境使用請看這篇。

在古早時代寫 PHP 要怎麼除錯呢？
不外乎就是 echo 、 var_dump() 這類的方式。

然而這種方式會不斷刪改程式碼，
甚至許多義大利麵專案會看到滿滿的註解
就像下面那樣。

// var_dump($varA);
// var_dump($varB);
// 以下略.....

義大利麵好ㄘ

下載安裝

進入官網後找到自己的 Linux 發行版本，
照著安裝就可以了。

Installation

下載對應版本號

sudo apt-get install php7.4-xdebug
sudo apt-get install php8.1-xdebug

設定 php.ini

[XDebug]
; 7.4的預設路徑
zend_extension=/usr/lib/php/20190902/xdebug.so
; 8.1的預設路徑
zend_extension=/usr/lib/php/20210902/xdebug.so
; 開啟遠端除錯
xdebug.mode = debug
; 可同時啟用多種模式：xdebug.mode=develop,trace。
xdebug.mode = debug,develop
xdebug.start_with_request = yes

安裝外掛

要在 VSCode 使用 Xdebug 下中斷點或監看變數，
就要安裝PHP Debug。

要注意的是 Xdebug 有 v2 和 v3，基本上都是 v3 了。
除非還在用 PHP 5.6 這種老版本....

設定參考

all_settings

xdebug.mode

• off 停用 xdebug
• develop 啟用開發協助工具
• debug 啟用中斷點除錯