PHPStorm配置Xdebug官方文檔

1 配置Xdebug

下載Xdebug

• 下載與您的PHP版本兼容的Xdebug擴展，並將其保存在該php/文件夾中。

  • php/文件夾 的位置是在安裝PHP引擎期間定義的。

  • 若是您使用的是AMP軟件包，則可能已安裝Xdebug擴展。按照xdebug.txt中的說明進行操做。

將Xdebug與PHP解釋器集成

1. 在編輯器中打開活動的php.ini文件：

   1. 在「 設置/首選項」對話框（Ctrl+Alt+S）中，單擊「 語言和框架」下的「 PHP 」。

   2. 在打開的PHP頁面上，單擊CLI Interpreter字段旁邊的。

   3. 在打開的CLI解釋器對話框中，配置文件只讀字段顯示活動php.ini文件的路徑。單擊在編輯器中打開。

2. 要禁用阻止Xdebug 的Zend Debugger和Zend Optimizer工具，請刪除或註釋掉php.ini文件中的如下行：

   zend_extension=<path_to_zend_debugger> zend_extension=<path_to_zend_optimizer>

    

3. 要啓用Xdebug，請找到php.ini文件中的[Xdebug]部分並按以下所示進行更新： 

   [Xdebug] zend_extension="<path to php_xdebug.dll>" xdebug.remote_enable=1 xdebug.remote_port="<the port for Xdebug to listen to>" (the default port is 9000)

   要經過Xdebug代理啓用多用戶調試，請找到該xdebug.idekey設置併爲其指定一個您選擇的值。該值將用於在Xdebug代理服務器上註冊IDE。

4. 保存並關閉php.ini文件。

5. 經過執行如下任一操做驗證Xdebug安裝：

   • 在命令行中，運行如下命令：

     php --version

     輸出應在已安裝的擴展中列出Xdebug：

   • 建立一個包含如下代碼的php文件：

     phpinfo();

     在瀏覽器中打開文件。該phpinfo輸出應包含Xdebug的部分：

在PHP 5.3及更高版本，您只須要使用zend_extension，而不是zend_extension_ts，zend_extension_debug或extension

在PhpStorm中配置Xdebug

1. 在「 設置/首選項」對話框（Ctrl+Alt+S）中，選擇「 語言和框架」| PHP。

2. 檢查與所選PHP解釋器關聯的Xdebug安裝：

   1. 在PHP頁面上，從CLI解釋器列表中選擇相關的PHP安裝，而後單擊該字段旁邊的「 瀏覽  」。該列表顯示了PhpStorm中可用的全部PHP安裝，請參閱配置本地PHP解釋器 和配置遠程PHP解釋器。

   2. 打開 的CLI解釋器對話框顯示如下內容：

      • 所選PHP安裝的版本。

      • 與所選PHP安裝（Xdebug或Zend Debugger）關聯的調試引擎的名稱和版本。若是沒有配置調試器，PhpStorm會顯示Debugger: Not installed。

   或者，打開Xdebug檢查器，粘貼輸出phpinfo()，而後單擊Analyze my phpinfo（）輸出。瞭解有關在驗證調試引擎配置中檢查Xdebug安裝的詳細信息。

3. 定義Xdebug行爲。單擊PHP節點下的Debug。在打開的「 調試」頁面上，在Xdebug區域中指定如下設置：

   • 在「 調試端口」文本框中，指定工具與PhpStorm通訊的端口。這必須與php.ini文件中指定的端口號徹底相同：

     xdebug.remote_port = <port_number>
     默認狀況下，Xdebug偵聽端口9000。 

   • 要讓PhpStorm經過「 調試端口」文本框中指定的端口接受來自Xdebug引擎的任何傳入鏈接，請選中「 能夠接受外部鏈接」 複選框。

   • 若是未指定路徑映射，請選中第一行 的強制中斷複選框，以使調試器在到達時當即中止並打開未映射到「 服務器」頁面上項目中任何文件的文件。調試器停在此文件的第一行和調試工具窗口。變量顯示如下錯誤消息： 沒法在服務器上找到該文件的本地副本<服務器上文件的路徑>和連接單擊以設置映射。單擊該連接以打開「 解析路徑映射問題」對話框，並將問題文件映射到其本地副本。

     清除此複選框後，調試器在到達並打開未映射的文件時不會中止，文件剛剛處理完畢，而且不會顯示任何錯誤消息。

   • 當腳本在項目外部時， 選擇第一行的強制中斷 複選框，以使調試器在到達時當即停在第一行，並在當前項目以外打開文件。清除此複選框後，調試器將在打開當前項目外的文件時繼續。

4. 在「 外部鏈接」區域中，指定您但願PhpStorm如何處理從主機接收的鏈接以及未註冊爲部署服務器配置的端口。

• 經過未註冊的服務器配置忽略外部鏈接：選中此複選框可以讓PhpStorm忽略從主機接收的鏈接以及未註冊爲部署服務器配置的端口。選中此複選框後，PhpStorm不會嘗試自動建立部署服務器配置。

• 在PHP腳本的第一行中斷： 選中此複選框可在調試器與PhpStorm創建鏈接後當即中止（而不是自動運行直到達到第一個斷點）。或者打開Run | 在主菜單上的PHP腳本選項的第一行中斷。

• 最大。同時鏈接：使用此旋轉框限制能夠同時處理的外部鏈接數。

2 參考

使用谷歌翻譯於 https://www.jetbrains.com/help/phpstorm/configuring-xdebug.html