Feature tests in Laravel simulate user behavior to test how different parts of your application work together. To write them, you use Artisan to create a test file with php artisan make:test ExampleTest, then utilize built-in methods like get(), post(), and assertions such as assertStatus() and assertSee() to verify expected outcomes. You can also leverage model factories for dynamic test data, authenticate users with actingAs(), and structure tests logically to ensure maintainability. Running tests regularly helps catch issues early and keeps your application robust.

Writing feature tests in Laravel might seem intimidating at first, but once you get the hang of it, it becomes a powerful way to ensure your application works as expected from end to end.

What Are Feature Tests in Laravel?

Feature tests are meant to test how different parts of your application work together. Unlike unit tests, which focus on isolated pieces like individual classes or methods, feature tests simulate user behavior—like visiting a page, submitting a form, or clicking a link—and check if the app responds correctly.

They’re especially useful for testing routes, controllers, forms, authentication flows, and anything that involves HTTP requests and responses.

Setting Up Your First Feature Test

To start writing feature tests, Laravel provides a convenient Artisan command:

php artisan make:test ExampleTest

This creates a new test file inside the tests/Feature directory. By default, all feature test classes extend Tests\TestCase, which gives you access to helper methods like get(), post(), assertStatus(), and more.

Here’s a basic structure of what a feature test might look like:

public function test_page_is_accessible()
{
    $response = $this->get('/home');

    $response->assertStatus(200);
}

You can also test more complex scenarios like logging in a user, submitting forms, and checking database changes.

Common Assertions and Helpers You’ll Use

Laravel's testing tools come with a lot of built-in assertions that make it easy to verify your app is behaving correctly. Here are some common ones you’ll use often:

• $this->get($uri) – Simulate a GET request.
• $this->post($uri, $data) – Simulate a POST request with data.
• ->assertStatus($code) – Check if the response has a specific HTTP status code.
• ->assertSee($text) – Make sure the response contains certain text.
• ->assertRedirect($uri) – Confirm the response redirects to a given URI.
• ->assertSessionHasErrors() – Check if there are validation errors in the session.
• ->assertExactJson($data) – Ensure the JSON response exactly matches the provided array.

These assertions help you cover most of the typical scenarios when testing web features.

Tips for Writing Maintainable Feature Tests

As your app grows, so will your test suite. To keep things manageable, here are a few best practices:

• Use factories for test data
  Laravel model factories let you generate realistic test data without hardcoding values everywhere. It keeps your tests clean and consistent.

• Log in users properly
  Instead of manually setting sessions or cookies, use $this->actingAs($user) to simulate authenticated users.

• Don’t over-test minor details
  Focus on core functionality. Checking every line of HTML or JSON can slow down tests and make them brittle.

• Group related tests logically
  Each test class should cover one feature or flow. For example, separate login tests from registration tests.

• Run your test suite regularly
  Run php artisan test often to catch regressions early. If tests take too long, consider splitting them into smaller groups.

That’s basically how you write feature tests in Laravel. It’s not overly complicated, but there are enough moving parts that getting familiar with the helpers and patterns really helps.

The above is the detailed content of How do I write feature tests in Laravel?. For more information, please follow other related articles on the PHP Chinese website!