Debian版PHPStorm如何進行單元測試

Debian版PHPStorm進行單元測試的完整步驟

1. 準備工作：安裝必要工具

在開始前，確保Debian系統已安裝PHP、Composer和PHPUnit。若未安裝，可通過以下命令完成：

# 更新軟件包列表
sudo apt update
# 安裝PHP（以PHP 8.2為例，可根據需求調整版本）
sudo apt install php8.2 php8.2-cli php8.2-mbstring php8.2-xml
# 安裝Composer（PHP依賴管理工具）
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
# 安裝PHPUnit（全局安裝，方便命令行使用）
composer global require phpunit/phpunit
# 將Composer全局bin目錄加入系統PATH（避免命令未找到）
echo 'export PATH=$PATH:$HOME/.composer/vendor/bin' >> ~/.bashrc
source ~/.bashrc
# 驗證PHPUnit安裝
phpunit --version

2. 在PHPStorm中配置PHPUnit

要讓PHPStorm識別PHPUnit并正確運行測試，需完成以下配置：

• 打開PHPStorm設置：進入頂部菜單欄「File」→「Settings」（Debian系統可能顯示為「PhpStorm」→「Preferences」）。
• 配置PHP解釋器：導航至「Languages & Frameworks」→「PHP」，點擊「Interpreter」右側的「…」，選擇系統中已安裝的PHP版本（如/usr/bin/php8.2），點擊「OK」保存。
• 配置PHPUnit路徑：在「Languages & Frameworks」→「PHP」→「Test Frameworks」中，點擊左上角「+」→「PHPUnit」。
  • 選擇「Use custom autoloader」（推薦，避免全局依賴沖突），在「Path to autoload.php」中輸入Composer的autoload路徑（通常為~/.composer/vendor/autoload.php），點擊「OK」保存。

3. 創建測試用例

測試用例需遵循PHPUnit的命名規范（以Test結尾），并存放在項目根目錄下的tests文件夾中（需手動創建）：

• 創建測試目錄：在項目根目錄下運行mkdir tests。
• 編寫測試類：以測試Calculator類為例，在tests目錄下創建CalculatorTest.php，內容如下：

  <?php
  use PHPUnit\Framework\TestCase;
  
  class CalculatorTest extends TestCase {
      public function testAddition() {
          $calculator = new Calculator();
          $this->assertEquals(3, $calculator->add(1, 2)); // 斷言1+2=3
      }
  
      public function testSubtraction() {
          $calculator = new Calculator();
          $this->assertEquals(2, $calculator->subtract(3, 1)); // 斷言3-1=2
      }
  }
  

  注：Calculator類需提前存在于項目中（如src/Calculator.php），否則測試會因類未找到而失敗。

4. 運行單元測試

PHPStorm提供多種運行測試的方式，滿足不同場景需求：

• 運行單個測試文件：在tests目錄下右鍵點擊CalculatorTest.php，選擇「Run ‘CalculatorTest’」（或按Shift + F10快捷鍵），測試結果將顯示在底部「Run」工具窗口中。
• 運行整個測試目錄：進入頂部菜單欄「Run」→「Edit Configurations」，點擊左上角「+」→「PHPUnit」，在「Test kind」中選擇「All in directory」，指定Directory為tests，點擊「OK」保存配置。之后可通過工具欄的綠色三角形按鈕運行整個目錄的測試。

5. 查看與分析測試結果

測試運行后，「Run」工具窗口會顯示詳細結果：

• 成功測試：以綠色標注，顯示通過的測試方法數量。
• 失敗測試：以紅色標注，顯示失敗的測試方法及錯誤原因（如斷言不匹配），點擊失敗項可直接跳轉到測試文件中的對應方法。
• 代碼覆蓋率：點擊「Run」窗口中的「Coverage」標簽，可查看測試覆蓋的代碼比例（需提前在「Run/Debug Configurations」中勾選「Code Coverage」）。

6. 調試單元測試

若測試失敗，可通過PHPStorm的調試功能快速定位問題：

• 設置斷點：在測試方法或被測類的代碼行左側點擊，添加斷點（紅色圓點）。
• 啟動調試：右鍵點擊測試文件，選擇「Debug ‘CalculatorTest’」（或按Shift + F9），程序會在斷點處暫停。
• 查看變量：在調試窗口中查看當前變量的值、調用棧等信息，逐步執行代碼（F7/F8）以定位問題根源。

通過以上步驟，即可在Debian系統上使用PHPStorm高效完成PHP項目的單元測試。測試過程中，建議定期運行測試以確保代碼變更不會破壞現有功能，并通過代碼覆蓋率優化測試用例的全面性。