PHP 腳本測試方法詳解：從 HTTP 模擬到 SimpleTest 實戰演練

PHP 腳本測試方法詳解：從 HTTP 模擬到 SimpleTest 實戰演練

遺留代碼往往缺乏測試，重構前必須建立測試保護網。本文介紹 PHP 腳本級測試的核心思路：模擬 HTTP 請求、捕獲響應、隔離依賴，並實戰演示 SimpleTest 框架的 Web 測試能力。

一、核心難點與解決思路

二、測試包裝類模式

<?php
class ForumPostingTestWrapper {
    private $headers = [];

    public function handleRequest(array $postData) {
        $_POST = $postData;  // 模擬 POST 請求
        // 可按需模擬 $_GET, $_SERVER, $_COOKIE, $_FILES

        ob_start();  // 開啟輸出緩衝
        include 'forum/post_new_copy.php';  // 包含被測腳本副本
        $content = ob_get_clean();  // 獲取並清空緩衝

        return [
            'content' => $content,
            'headers' => $this->headers
        ];
    }

    // 攔截 header() 呼叫
    public function header($line) {
        $this->headers[] = $line;
    }

    // 可擴展：攔截 exit/die、setcookie、session_start 等
}

三、測試用例

// 使用 PHPUnit 風格斷言（或 SimpleTest）
$wrapper = new ForumPostingTestWrapper();
$response = $wrapper->handleRequest([
    'id_thread' => 42,
    'text' => 'Hello, world',
    'author' => 'tester'
]);

// 斷言響應內容
assertStringContainsString('發布成功', $response['content']);
// 斷言 Header
assertContains('Content-Type: text/html', $response['headers']);

四、副本策略：最小化修改

1. 複製原腳本為 post_new_copy.php
2. 移除未使用的 include/require
3. 將內置函數調用改為對象方法：header() → $this->header()
4. 將全局資源（DB 連接）改為對象屬性注入

測試通過後，將邏輯遷移回原腳本或重構為類庫，副本可刪除。

五、SimpleTest 實戰：Web 測試框架

SimpleTest 內建 WebTestCase，支援完整 HTTP 交互模擬（GET/POST/點擊鏈接/提交表單/斷言標題/內容/表單字段）。

安裝

下載源碼包解壓至項目目錄，require_once 'simpletest/autorun.php' 即可使用。

案例 1：檢查網站可訪問

require_once 'simpletest/web_tester.php';

class SiteAvailabilityTest extends WebTestCase {
    function testHomepageLoads() {
        $this->get('https://example.com/');
        $this->assertResponse(200);
        $this->assertTitle('Example Domain');
        $this->assertWantedPattern('/Example Domain/');
    }
}

// 運行
$test = new SiteAvailabilityTest();
$test->run(new HtmlReporter());

案例 2：完整登錄流程測試

class LoginFlowTest extends WebTestCase {
    function testValidLogin() {
        // 1. 獲取登錄頁
        $this->get('https://app.example.com/login.php');

        // 2. 填寫表單
        $this->setField('username', 'testuser');
        $this->setField('password', 'secret123');

        // 3. 提交
        $this->clickSubmit('登錄');

        // 4. 斷言登錄成功
        $this->assertResponse(200);
        $this->assertWantedPattern('/歡迎回來/');
        $this->assertTitle('用戶中心');

        // 5. 點擊進入管理頁
        $this->clickLink('管理後台');
        $this->assertTitle('管理中心');
        $this->assertWantedPattern('/請選擇操作/');

        // 6. 登出
        $this->clickLink('退出登錄');
        $this->assertWantedPattern('/已登出/');
    }
}

SimpleTest 核心 API 速查

六、PHP 單元測試工具包對比

建議：新專案首選 PHPUnit；維護無 Composer 的舊專案，SimpleTest 是零配置快速上手的最佳選擇。