Debian上phpstorm如何遠程調試

Debian上PhpStorm遠程調試配置指南

1. 安裝Xdebug擴展

在Debian服務器上，通過APT包管理器安裝Xdebug（確保PHP版本與Xdebug兼容）：

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

安裝完成后，Xdebug會自動集成到PHP環境中，但需進一步配置才能啟用遠程調試。

2. 配置php.ini文件

編輯PHP的全局配置文件（路徑可通過php --ini命令查看，常見為/etc/php/8.2/cli/php.ini或/etc/php/8.2/apache2/php.ini），在文件末尾添加以下配置：

[xdebug]
zend_extension=/usr/lib/php/20220829/xdebug.so  # 根據實際Xdebug路徑調整（通過`php -i | grep extension_dir`查看）
xdebug.mode=debug
xdebug.client_host=127.0.0.1  # 若PhpStorm與服務器在同一機器，用127.0.0.1；否則填PhpStorm所在機器的IP
xdebug.client_port=9003       # 默認端口，可與PhpStorm設置保持一致
xdebug.start_with_request=yes # 自動觸發調試（可選：trigger/yes，trigger需通過瀏覽器擴展或GET參數啟動）
xdebug.idekey=PHPSTORM        # IDE標識，需與PhpStorm配置一致

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

sudo systemctl restart apache2  # Apache
# 或
sudo systemctl restart nginx    # Nginx

3. 配置PhpStorm遠程解釋器

1. 打開PhpStorm，進入File > Settings > PHP（或PhpStorm > Preferences > PHP）。
2. 點擊右上角齒輪圖標→Add，選擇SSH Interpreter。
3. 輸入Debian服務器的IP地址、SSH端口（默認22）、用戶名，選擇認證方式（密碼或密鑰）。
4. PHPStorm會自動檢測服務器上的PHP解釋器路徑（如/usr/bin/php），確認后點擊Finish。

4. 配置PHP Servers

1. 進入File > Settings > PHP > Servers，點擊+添加新服務器。
2. 輸入服務器名稱（如Debian-Remote），設置Host為服務器IP或域名，Port為Web服務端口（如80/443）。
3. 勾選Use path mappings，將本地項目目錄與遠程服務器目錄映射（例如：本地/home/user/project→遠程/var/www/html/project）。

5. 配置調試監聽

1. 進入Run > Edit Configurations，點擊+添加PHP Remote Debug配置。
2. 選擇之前創建的Debian-Remote服務器，確認Port與php.ini中的xdebug.client_port一致（如9003）。
3. 點擊OK保存配置。

6. 啟動調試會話

1. 在PhpStorm中打開項目，點擊頂部工具欄的電話圖標（或按Shift+F9）開始監聽調試連接。
2. 在代碼中設置斷點（點擊行號左側）。
3. 觸發調試：
   • 方式一：通過瀏覽器訪問項目URL（如http://your-server-ip/project），Xdebug會自動連接PhpStorm。
   • 方式二：安裝瀏覽器擴展（如Xdebug Helper），點擊擴展圖標并選擇Debug模式，再訪問頁面。
4. 當代碼執行到斷點時，PhpStorm會暫停并顯示調試面板（可查看變量、調用棧等信息）。

常見問題排查

• 端口沖突：若xdebug.client_port端口被占用，修改為其他端口（如9007），并同步更新php.ini和PhpStorm配置。
• 防火墻問題：確保服務器防火墻允許xdebug.client_port端口的入站連接（如sudo ufw allow 9003/tcp）。
• 路徑映射錯誤：檢查Servers配置中的本地與遠程目錄映射是否正確，否則無法準確定位代碼。
• Xdebug未加載：通過php -m | grep xdebug命令確認Xdebug擴展已加載，未加載則重啟PHP-FPM或Web服務器。

通過以上步驟，即可在Debian服務器上使用PhpStorm進行遠程調試，實現本地與遠程代碼的無縫調試體驗。