PHPUnit 安裝完全指南：PEAR 一鍵安裝與手動部署步驟詳解

PEAR 安裝（推薦）

pear channel-update pear.php.net
pear install phpunit/PHPUnit
# PHP 5.3+ 會自動安裝相依套件（PHP_CodeCoverage, PHP_Timer 等）

驗證：phpunit --version 輸出版本號即成功。

手動安裝（離線/無 PEAR 環境）

1. 下載 PHPUnit-x.y.z.tgz 從 phar.phpunit.de 或 GitHub Releases。
2. 解壓至專案目錄或全局路徑（如 /usr/local/lib/phpunit）。
3. 確保 include_path 包含該目錄，或在腳本中 set_include_path()。
4. 準備啟動腳本 phpunit（Linux/Mac）：

#!/usr/bin/env php
<?php
require_once 'PHPUnit/Autoload.php';
PHPUnit_TextUI_Command::main();

5. chmod +x phpunit 並放入 $PATH 目錄（如 /usr/local/bin）。

Composer 安裝（現代標準）

composer require --dev phpunit/phpunit ^9.5
# 專案根目錄生成 vendor/bin/phpunit
./vendor/bin/phpunit --version

配置文件 phpunit.xml.dist

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php" colors="true">
    <testsuites>
        <testsuite name="Application Test Suite">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
    <filter>
        <whitelist>
            <directory>src</directory>
        </whitelist>
    </filter>
</phpunit>

常見問題

• Class 'PHPUnit_Framework_TestCase' not found → PHPUnit 6+ 命名空間變更，改用 PHPUnit\Framework\TestCase。
• 內存不足 → php -d memory_limit=512M vendor/bin/phpunit。
• Windows 下 phpunit.bat 可能需手動建立，指向 vendor/bin/phpunit.php。