Testing in Laravel

⏱ Estimated reading time: 2 min

Testing in Laravel ensures that your application works as expected and helps prevent bugs as your codebase grows. Laravel provides a powerful and developer-friendly testing environment built on PHPUnit, with additional tools to test routes, controllers, models, APIs, and user interactions.

1. Why Testing Is Important

• Detects bugs early

• Ensures application stability

• Makes refactoring safer

• Improves code quality and confidence

Laravel encourages testing as part of the development workflow.

2. Testing Environment

Laravel includes PHPUnit by default.

Test configuration:

phpunit.xml

Tests are stored in:

tests/

Two main types:

• Unit Tests

• Feature Tests

3. Unit Testing

Unit tests focus on testing small pieces of code (models, helpers, services).

Location:

tests/Unit

Example unit test:

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

Run unit tests:

php artisan test --testsuite=Unit

4. Feature Testing

Feature tests test the full request lifecycle (routes, controllers, views, APIs).

Location:

tests/Feature

Example feature test:

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

    $response->assertStatus(200);
}

5. Testing Database Interactions

Laravel provides traits for database testing.

Refresh Database

use Illuminate\Foundation\Testing\RefreshDatabase;

This runs migrations before each test.

Using Factories

User::factory()->create();

Example test:

public function test_user_can_be_created()
{
    $user = User::factory()->create();
    $this->assertDatabaseHas('users', [
        'email' => $user->email,
    ]);
}

6. Testing Authentication

Test authenticated users:

$this->actingAs($user)->get('/dashboard')
     ->assertStatus(200);

Test guest access:

$this->get('/dashboard')->assertRedirect('/login');

7. Testing Form Validation

$response = $this->post('/user', []);

$response->assertSessionHasErrors(['name', 'email']);

8. Testing APIs

Test JSON responses:

$this->getJson('/api/posts')
     ->assertStatus(200)
     ->assertJsonStructure([
         'data' => ['*' => ['id', 'title']]
     ]);

9. Mocking and Faking

Fake Mail

Mail::fake();

Fake Events

Event::fake();

Fake Queue

Queue::fake();

10. Running Tests

Run all tests:

php artisan test

With coverage:

php artisan test --coverage

11. Continuous Integration (CI)

Laravel tests integrate easily with CI tools like:

• GitHub Actions

• GitLab CI

• Bitbucket Pipelines

Conclusion

Laravel’s testing tools make it easy to write reliable, maintainable tests for all parts of an application. By using unit tests, feature tests, factories, and fakes, developers can confidently build and scale applications while ensuring long-term stability.