Ubuntu中phpstorm遠程調試設置

Ubuntu中PhpStorm遠程調試設置指南

1. 安裝Xdebug擴展

在Ubuntu遠程服務器上，通過終端安裝Xdebug擴展（以Ubuntu 22.04+、PHP 8.1為例）：

sudo apt update
sudo apt install php-xdebug

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

2. 配置Xdebug參數

編輯PHP配置文件（根據PHP運行模式選擇對應文件，如Apache使用/etc/php/8.1/apache2/php.ini，PHP-FPM使用/etc/php/8.1/fpm/php.ini），在文件末尾添加以下配置：

[xdebug]
zend_extension=xdebug.so  ; Xdebug擴展路徑（通常自動識別，無需手動指定）
xdebug.mode=debug         ; 啟用調試模式
xdebug.client_host=127.0.0.1  ; 本地機器IP（PhpStorm所在設備）
xdebug.client_port=9003   ; 調試端口（默認9003，需與PhpStorm一致）
xdebug.start_with_request=yes  ; 自動啟動調試（觸發請求時自動連接）
xdebug.idekey=PHPSTORM    ; IDE標識（需與PhpStorm設置一致）

注意：若服務器有多個IP或需允許遠程連接，可將client_host改為本地機器的實際IP（如192.168.1.100）。

3. 重啟Web服務器

配置生效后，重啟Apache或Nginx服務：

# Apache
sudo systemctl restart apache2

# Nginx + PHP-FPM
sudo systemctl restart nginx
sudo systemctl restart php8.1-fpm

4. 配置PhpStorm遠程解釋器

1. 打開PhpStorm，進入File > Settings > PHP（Windows/Linux）或PhpStorm > Preferences > PHP（macOS）。
2. 點擊右上角齒輪圖標→Add，選擇Remote（遠程解釋器）。
3. 在Interpreter欄選擇SSH Credentials，輸入遠程服務器的Host（IP/域名）、Port（默認22）、Username（登錄用戶名）。
4. 選擇認證方式（Password或Key pair），若用密鑰需指定私鑰文件路徑。
5. 點擊Test Connection驗證連接，成功后點擊OK保存。

5. 添加服務器配置

1. 進入File > Settings > PHP > Servers，點擊**+**添加新服務器。
2. 填寫Name（如Remote Server），Host（遠程服務器IP/域名），Port（HTTP端口，默認80；HTTPS為443）。
3. 勾選Use path mappings（路徑映射），將本地項目目錄與服務器項目目錄關聯（如本地/home/user/project→服務器/var/www/html/project）。
4. 點擊OK保存。

6. 配置調試監聽

1. 進入Run > Edit Configurations，點擊**+**添加PHP Remote Debug配置。
2. 選擇之前添加的Server（如Remote Server），Debugger mode保持Attach to remote host（默認）。
3. 確認IDE key為PHPSTORM（與Xdebug配置一致）。
4. 點擊OK保存配置。

7. 啟動調試會話

1. 在PhpStorm頂部工具欄點擊電話圖標（Start Listening for PHP Debug Connections），開啟調試監聽。
2. 在代碼中設置斷點（點擊行號左側，出現紅色圓點）。
3. 觸發調試請求：
   • 方式1：在瀏覽器中訪問遠程URL，添加XDEBUG_SESSION_START=PHPSTORM參數（如http://example.com/index.php?XDEBUG_SESSION_START=PHPSTORM）。
   • 方式2：安裝瀏覽器擴展（如Xdebug Helper），點擊擴展圖標并設置為Debug模式，訪問頁面即可觸發。

常見問題排查

• 端口沖突：若9003端口被占用，可修改php.ini中的client_port和PhpStorm中的Debug port為其他端口（如9007）。
• 路徑映射錯誤：確保本地與服務器目錄一一對應，否則無法正確顯示變量和調用棧。
• 防火墻限制：開放本地機器的9003端口（sudo ufw allow 9003），允許遠程連接。