ServBay

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

如何啟用ServBay自帶的Xdebug模組 ​

作為強大的整合式Web開發工具，ServBay自帶了Xdebug模組，且其啟用過程非常簡單。Xdebug是一個PHP的除錯和分析工具，能夠幫助開發者進行程式碼除錯、效能分析和程式碼覆蓋率檢測，是開發和維護PHP應用的利器。

Xdebug模組簡介 ​

Xdebug是一個功能強大的PHP擴展，用於除錯和分析PHP程式碼。它提供了豐富的除錯功能，包括斷點除錯、堆疊追蹤、變數監視等。此外，Xdebug還支援效能分析和程式碼覆蓋率檢測，幫助開發者優化程式碼效能和保證程式碼品質。

主要特點 ​

  1. 斷點除錯：Xdebug支援在程式碼中設定斷點，逐行除錯程式碼，方便查找和修復錯誤。
  2. 堆疊追蹤：在發生錯誤時，Xdebug可以生成詳細的堆疊追蹤資訊，幫助開發者快速定位問題。
  3. 效能分析：Xdebug提供了效能分析功能，可以生成詳細的效能報告，幫助開發者優化程式碼效能。
  4. 程式碼覆蓋率：Xdebug支援程式碼覆蓋率檢測，幫助開發者確保測試覆蓋了所有程式碼路徑。
  5. 整合開發環境支援：Xdebug可以與多種整合開發環境（IDE）整合，如PHPStorm、Visual Studio Code等，提供方便的除錯體驗。

ServBay自帶的Xdebug模組版本 ​

ServBay支援多個PHP版本，並且為每個版本預裝了相應的Xdebug模組。具體版本如下：

  • PHP 5.6、7.0、7.1：Xdebug 2.5.5
  • PHP 7.2、7.3、7.4：Xdebug 3.1.6
  • PHP 8.0、8.1、8.2、8.3：Xdebug 3.3.1
  • PHP 8.4：Xdebug 3.4.0-dev

提示

每個版本的PHP Xdebug埠互相獨立，與版本號相關聯，比如PHP 7.2的Xdebug埠是39072，PHP 8.3的Xdebug埠是39083

如何啟用Xdebug模組 ​

預設情況下，Xdebug模組是禁用的。啟用Xdebug模組的步驟非常簡單，只需導航到語言-PHP，選擇要啟用模組的 PHP 版本，比如 PHP 8.4，點擊右側的擴展，然後在Xdebug模組的左側打開開關，儲存即可。

用戶也可以手動打開或者修改模組配置，以下是詳細步驟：

步驟一：找到配置文件 ​

首先，定位到對應PHP版本的conf.d目錄。例如，要為PHP 8.3啟用Xdebug模組，我們需要編輯以下文件：

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

步驟二：編輯配置文件 ​

打開xdebug.ini文件，取消註釋以下內容：

ini
[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so

步驟三：配置Xdebug參數 ​

為了充分利用Xdebug的功能，可以在xdebug.ini中配置一些常用參數。例如：

ini
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

步驟四：重啟PHP服務 ​

在ServBay的服務管理面板中，重啟相應的PHP服務。例如，重啟PHP 8.3的服務。重啟完成後，Xdebug模組將成功載入。

驗證Xdebug模組是否成功載入 ​

可以透過創建一個簡單的PHP文件來驗證Xdebug模組是否成功載入。在Web伺服器的根目錄下創建一個phpinfo.php文件，內容如下：

php
<?php
phpinfo();
?>

訪問https://servbay.host/phpinfo.php，在輸出的PHP資訊頁面中查找Xdebug模組的相關資訊。如果看到Xdebug的相關資訊，說明模組已經成功載入。

如何啟用ServBay自帶的Xdebug模組

在PHPStorm中配置Xdebug ​

為了在PHPStorm中使用Xdebug進行除錯，需要進行以下配置步驟：

步驟一：打開PHPStorm並進入設置 ​

  1. 打開PHPStorm。
  2. 點擊選單欄中的 File，然後選擇 Settings（Windows/Linux）或 Preferences（macOS）。

步驟二：配置PHP解釋器 ​

  1. 在設置窗口中，導航到 Languages & Frameworks -> PHP。
  2. 在 CLI Interpreter 部分，點擊右側的 ... 按鈕。
  3. 在彈出的窗口中，點擊 + 號新增新的PHP解釋器，選擇 Local。
  4. 設置PHP解釋器路徑為ServBay中對應的PHP版本的路徑，例如 /Applications/ServBay/package/php/8.3/8.3.7/bin/php。
  5. 點擊 OK 儲存設置。 如何啟用ServBay自帶的Xdebug模組

步驟三：配置Xdebug除錯 ​

提示

每個版本的PHP Xdebug埠互相獨立，與版本號相關聯，比如PHP 7.2的Xdebug埠是39072，PHP 8.3的Xdebug埠是39083

  1. 在設置窗口中，導航到 Languages & Frameworks -> PHP -> Debug。
  2. 在 Xdebug 部分，設置 Debug Port 為 39083，與 xdebug.client_port 配置一致。
  3. 確保 Can accept external connections 選項已勾選。
  4. 點擊 Apply 然後點擊 OK 儲存設置。 如何啟用ServBay自帶的Xdebug模組

步驟四：配置PHP Web應用伺服器 ​

  1. 在設置窗口中，導航到 Languages & Frameworks -> PHP -> Servers。
  2. 點擊右側的 + 號新增一個新的伺服器配置。
  3. 設置伺服器名稱，例如 ServBay Localhost。
  4. 設置 Host 為你在ServBay主機中對應的host，比如 servbay.new，埠為443（HTTPS）。
  5. 設置 Debugger 為 Xdebug。
  6. 點擊 OK 儲存設置。 如何啟用ServBay自帶的Xdebug模組如何啟用ServBay自帶的Xdebug模組

步驟五：啟動除錯會話 ​

  1. 在PHPStorm中打開你想要除錯的PHP專案。
  2. 在程式碼中設置斷點（點擊行號左側的空白區域）。
  3. 點擊PHPStorm頂部工具欄中的 Start Listening for PHP Debug Connections 按鈕（小蟲子圖標）。
  4. 在瀏覽器中訪問你的PHP應用，Xdebug會自動連接到PHPStorm並在斷點處暫停執行。 如何啟用ServBay自帶的Xdebug模組

結論 ​

ServBay提供了便捷的方式來管理和啟用Xdebug模組。透過簡單的配置和重啟操作，開發者可以快速地在不同PHP版本中啟用Xdebug模組，從而充分利用其強大的除錯和分析功能，提升PHP應用的開發和維護效率。Xdebug的斷點除錯、效能分析和程式碼覆蓋率檢測功能使得它成為PHP開發者不可或缺的工具。