單元測試

介紹

Laravel 在建立時就有考慮到單元測試。事實上,它支援立即使用被引入的 PHPUnit 做測試,而且已經為你的應用程式建立了 phpunit.xml 檔案。除了 PHPUnit 以外,Laravel 也利用 Symfony HttpKernel、 DomCrawler 和 BrowserKit 元件讓你在測試的時候模擬為一個網頁瀏覽器,來檢查和處理你的視圖。

app/tests 資料夾有提供一個測試範例。在安裝新 Laravel 應用程式之後,只要在命令列上執行 phpunit 來進行測試流程。

定義並執行測試

要建立一個測試案例,只要在 app/tests 資料夾建立新的測試檔案。測試類別必須繼承自 TestCase,接著你可以如你平常使用 PHPUnit 一般去定義測試方法。

測試類別範例

class FooTest extends TestCase {

    public function testSomethingIsTrue()
    {
        $this->assertTrue(true);
    }

}

你可以從終端機執行 phpunit 命令來執行應用程式的所有測試。

注意: 如果你定義自己的 setUp 方法, 請記得呼叫 parent::setUp

測試環境

當執行單元測試的時候,Laravel 會自動將環境設置在 testing。另外 Laravel 會在測試環境匯入 sessioncache 的設定檔案。當在測試環境裡這兩個驅動會被設定為 array (空陣列),代表在測試的時候沒有 session 或 cache 資料將會被保留。視情況你可以任意的建立你需要的測試環境設定。

從測試呼叫路由

從單一測試中呼叫路由

你可以使用 call 方法,輕易地呼叫你的其中一個路由來測試:

$response = $this->call('GET', 'user/profile');

$response = $this->call($method, $uri, $parameters, $files, $server, $content);

接著你可以檢查 Illuminate\Http\Response 物件:

$this->assertEquals('Hello World', $response->getContent());

從測試呼叫控制器

你也可以從測試呼叫控制器:

$response = $this->action('GET', 'HomeController@index');

$response = $this->action('GET', 'UserController@profile', array('user' => 1));

getContent 方法會回傳求值後的字串內容回應。如果你的路由回傳一個 View,你可以透過 original 屬性存取它:

$view = $response->original;

$this->assertEquals('John', $view['name']);

你可以使用 callSecure 方法去呼叫 HTTPS 路由:

$response = $this->callSecure('GET', 'foo/bar');

注意: 在測試環境中,路由篩選器是被禁用的。如果要啟用它們,必須增加 Route::enableFilters() 到你的測試。

DOM 撈取器

你也可以透過呼叫路由來取得 DOM 撈取器實例來檢查內容:

$crawler = $this->client->request('GET', '/');

$this->assertTrue($this->client->getResponse()->isOk());

$this->assertCount(1, $crawler->filter('h1:contains("Hello World!")'));

如果需要更多如何使用撈取器的資訊,請參考它的 官方文件

模擬 Facades

當測試的時候,你或許常會想要模擬呼叫 Laravel 靜態 facade。舉個例子,思考下面的控制器行為:

public function getIndex()
{
    Event::fire('foo', array('name' => 'Dayle'));

    return 'All done!';
}

我們可以在 facade 上使用 shouldReceive 方法,模擬呼叫 Event 類別,它將會回傳一個 Mockery mock 物件實例。

模擬 Facade

public function testGetIndex()
{
    Event::shouldReceive('fire')->once()->with('foo', array('name' => 'Dayle'));

    $this->call('GET', '/');
}

注意: 你不應該模擬 Request facade。取而代之,當執行你的測試,傳遞想要的輸入資料進去 call 方法。

框架 Assertions

Laravel 附帶幾個 assert 方法,讓測試更簡單一點:

Assert 回應為 OK

public function testMethod()
{
    $this->call('GET', '/');

    $this->assertResponseOk();
}

Assert 回應狀態碼

$this->assertResponseStatus(403);

Assert 回應為重新導向

$this->assertRedirectedTo('foo');

$this->assertRedirectedToRoute('route.name');

$this->assertRedirectedToAction('Controller@method');

Assert 回應帶資料的視圖

public function testMethod()
{
    $this->call('GET', '/');

    $this->assertViewHas('name');
    $this->assertViewHas('age', $value);
}

Assert 回應帶資料的 Session

public function testMethod()
{
    $this->call('GET', '/');

    $this->assertSessionHas('name');
    $this->assertSessionHas('age', $value);
}

Assert 回應帶錯誤資訊的 Session

public function testMethod()
{
    $this->call('GET', '/');

    $this->assertSessionHasErrors();

    // Asserting the session has errors for a given key...
    $this->assertSessionHasErrors('name');

    // Asserting the session has errors for several keys...
    $this->assertSessionHasErrors(array('name', 'age'));
}

Assert 回應帶資料的舊輸入內容

public function testMethod()
{
    $this->call('GET', '/');

    $this->assertHasOldInput();
}

輔助方法

TestCase 類別包含幾個輔助方法讓應用程式的測試更為簡單。

從測試裏設定和刷新 Sessions

$this->session(['foo' => 'bar']);

$this->flushSession();

設定目前經過驗證的使用者

你可以使用 be 方法設定目前經過驗證的使用者:

$user = new User(array('name' => 'John'));

$this->be($user);

你可以從測試中使用 seed 方法重新填充你的資料庫:

從測試中重新填充資料庫

$this->seed();

$this->seed($connection);

更多建立填充資料的資訊可以在文件的 遷移與資料填充 部分找到。

重置應用程式

你可能已經知道,你可以透過 $this->app 在任何測試方法中存取你的 Laravel 應用程式本體 / IoC 容器。這個應用程式物件實例會在每個測試類別被重置。如果你希望在給定的方法手動強制重置應用程式,你可以從你的測試方法使用 refreshApplication 方法。這將會重置任何額外的綁定, 例如那些從測試案例執行開始被放到 IoC 容器的 mocks。