Debian系統中PHPStorm如何進行遠程調試

Debian系統中PHPStorm遠程調試配置步驟

1. 安裝Xdebug擴展

在Debian服務器上，首先安裝PHP及Xdebug擴展（根據PHP版本調整包名，如php8.2-xdebug）：

sudo apt update
sudo apt install php php-cli php-fpm php-xdebug

安裝完成后，Xdebug會自動加載，但需通過配置文件確認其狀態。

2. 配置Xdebug參數

編輯PHP配置文件（根據PHP運行模式選擇路徑，如FPM用/etc/php/8.2/fpm/php.ini，CLI用/etc/php/8.2/cli/php.ini），在文件末尾添加以下配置：

[xdebug]
zend_extension=xdebug.so  ; Xdebug擴展路徑（通常自動檢測）
xdebug.mode=debug         ; 啟用調試模式
xdebug.client_host=192.168.1.100  ; PHPStorm所在主機的IP地址（本地可填127.0.0.1）
xdebug.client_port=9003   ; 調試端口（默認9003，需與PHPStorm一致）
xdebug.idekey=PHPSTORM    ; IDE標識，需與PHPStorm配置一致
xdebug.start_with_request=yes  ; 自動啟動調試（可選：trigger/yes）

注意：若使用xdebug.remote_*舊參數（如Xdebug 2.x），需替換為xdebug.*新參數（Xdebug 3.x+）。

3. 重啟PHP服務

保存配置后，重啟PHP-FPM（或Apache/Nginx）使更改生效：

sudo systemctl restart php8.2-fpm  ; 根據實際PHP版本調整

4. 配置PHPStorm

4.1 添加遠程服務器

1. 打開PHPStorm，進入File > Settings > Languages & Frameworks > PHP > Servers。
2. 點擊+號添加新服務器，填寫：
   • Name：自定義服務器名稱（如Debian-Remote）；
   • Host：遠程服務器的域名/IP（如192.168.1.100）；
   • Port：Web服務端口（如80/443）；
   • 勾選Use path mappings，將遠程項目路徑（如/var/www/html/myproject）映射到本地項目路徑（如/home/user/myproject）。

4.2 配置調試端口

1. 進入File > Settings > Languages & Frameworks > PHP > Debug。
2. 在Debug port中輸入9003（與php.ini中的xdebug.client_port一致）。
3. 勾選Can accept external connections（允許外部連接，遠程調試必需）。

5. 啟動調試會話

1. 在PHPStorm中打開項目，點擊頂部工具欄的綠色蟲子圖標（或按Shift+F9）啟動調試監聽。
2. 在代碼中設置斷點（點擊行號左側，出現紅色圓圈）。
3. 在瀏覽器中訪問遠程項目（如http://192.168.1.100/myproject/index.php），觸發斷點。
4. PHPStorm會自動暫停在斷點處，可通過調試工具欄（單步執行、查看變量、調用堆棧等）進行調試。

6. 常見問題解決

• 端口沖突：若9003端口被占用，修改php.ini和PHPStorm中的client_port為其他端口（如9004），并重啟服務。
• 防火墻攔截：允許Xdebug端口通過防火墻（Debian默認使用ufw）：

  sudo ufw allow 9003/tcp
  sudo ufw reload
  

• 路徑映射錯誤：確保Servers配置中的本地與遠程路徑一一對應，否則無法正確顯示變量和代碼。
• Xdebug未加載：運行php -m | grep xdebug檢查擴展是否加載，未加載則確認zend_extension路徑正確。

通過以上步驟，即可在Debian系統中使用PHPStorm完成遠程調試。調試過程中，PHPStorm會實時同步遠程代碼狀態，方便排查問題。