PHPStorm在Debian中的調試功能如何使用

在Debian系統中使用PHPStorm進行PHP調試的詳細步驟

1. 安裝Xdebug擴展

首先確保Debian系統已安裝PHP及Xdebug擴展。通過終端執行以下命令安裝：

sudo apt-get update
sudo apt-get install php-xdebug

安裝完成后，需確認Xdebug擴展的安裝路徑（可通過php -i | grep xdebug.so命令查看，通常為/usr/lib/php/<version>/xdebug.so）。

2. 配置Xdebug的php.ini文件

編輯PHP的配置文件（根據PHP運行模式選擇對應路徑，如CLI模式用/etc/php/<version>/cli/php.ini，Apache模式用/etc/php/<version>/apache2/php.ini），在文件末尾添加以下配置：

[xdebug]
zend_extension="xdebug.so"  # 替換為實際的xdebug.so路徑（如上一步查到的路徑）
xdebug.mode=debug           # 啟用調試模式
xdebug.client_host=127.0.0.1 # 調試客戶端地址（本地開發設為127.0.0.1）
xdebug.client_port=9003      # 調試端口（默認9003，需與PhpStorm配置一致）
xdebug.start_with_request=yes # 自動啟動調試（可選：yes/trigger/never）

保存文件后，重啟Web服務器（Apache/Nginx）使配置生效：

# Apache
sudo systemctl restart apache2
# Nginx（需重啟PHP-FPM）
sudo systemctl restart nginx
sudo systemctl restart php<version>-fpm

3. 配置PHPStorm

3.1 設置PHP解釋器

打開PHPStorm，進入File > Settings > Languages & Frameworks > PHP，點擊“Interpreter”右側的齒輪圖標，選擇“Add”。

• 若使用本地PHP，選擇“Local”并指定PHP可執行文件路徑（如/usr/bin/php）；
• 若使用遠程服務器，選擇“SSH Interpreter”，輸入服務器IP、用戶名及密碼，選擇PHP可執行文件路徑（如/usr/bin/php）。

3.2 配置Xdebug調試設置

在Languages & Frameworks > PHP > Debug標簽頁下：

• 勾選“Xdebug”復選框；
• 點擊“+”按鈕添加Xdebug配置，設置：
  • Name：自定義名稱（如“Debian Xdebug”）；
  • Host：localhost（與client_host一致）；
  • Port：9003（與client_port一致）；
  • IDE Key：PHPSTORM（默認值，需與瀏覽器插件一致）。
    點擊“OK”保存配置。

4. 配置瀏覽器（可選但推薦）

為方便觸發調試會話，建議安裝瀏覽器插件（如Chrome的“Xdebug Helper”或Firefox的“Xdebug Helper”）。安裝后：

• 打開插件設置，將“IDE Key”設置為PHPSTORM；
• 訪問PHP頁面時，點擊插件圖標啟用調試（通常為綠色）。

5. 設置斷點

在PHPStorm中打開需要調試的PHP文件，在代碼行號左側空白處單擊，設置斷點（紅色圓圈標識）。

6. 啟動調試會話

• 方式1：監聽調試連接
  點擊PHPStorm右上角的“電話圖標”（Start Listening for PHP Debug Connections），或按Shift+F9啟動調試模式。
• 方式2：直接啟動調試
  若未安裝瀏覽器插件，可直接點擊綠色三角形按鈕（Debug）啟動調試，然后在瀏覽器中訪問項目URL。

7. 調試操作

當代碼執行到斷點時，PhpStorm會暫停并顯示調試界面：

• Step Over（F8）：執行當前行，跳到下一行；
• Step Into（F7）：進入當前行的函數/方法內部；
• Step Out（Shift+F8）：跳出當前函數/方法；
• Resume Program（F9）：繼續執行，直到下一個斷點或程序結束；
• View Variables：查看當前作用域的變量值；
• Call Stack：查看函數調用堆棧。

注意事項

• 若使用遠程服務器調試，需確保PhpStorm能通過SSH訪問服務器，且client_host設置為服務器IP；
• 若調試不生效，檢查php.ini中的xdebug.mode是否為debug，client_host/client_port是否與PhpStorm配置一致；
• 可通過php -m命令確認Xdebug擴展是否加載，或phpinfo()頁面查看Xdebug配置是否正確。