Laravel Tutorials

Feature Tests powered by database seeders

Published
Feature Tests powered by database seeders image

At Laracon AU in 2018, David Hemphill gave a talk titled "Abusing Laravel for Fun and Profit" and one section of the talk I found interesting was on feature tests powered by database seeders:

David goes through some common ways to set up your data before testing, such as using a setUp method, a trait, and then he came around to using custom seeders in his tests.

One advantage to seeders is you can create them for specific cases and call $this->seed directly from your test instead of using factories all over. Like this example:

class WebhookTest extends TestCase {
function setUp() {
$this-›seed( 'UserwithTeamSeeder');
$this-›user = User :: first);
$this-›team = Team:: first() ;
}
function test_a_user_can_create_a_webhook() {
// Act
//

Another advantage is that you can have isolated seeds to match specific scenarios. David gives the examples of:

  • UserWithValidApiKey
  • TeamWithExpiredBillingPlan
  • OrganizationOverUsageLimit
  • CreatorHasntFinishedSetup
  • CustomerWithNovaLicense

This allows you to make them specific for complex test setups and is great for testing complex edge cases.

One final tip he mentions is you don't even have to keep these with your other seeders. In your composer.json, you can autoload these from somewhere else, like your tests directory:

"autoload-dev": {
"psr-4": {
"Tests\\": "tests/",
"Tests\\Seeders\\": "tests/seeders"
}
},

Of course, like all things programming, this is just one way of doing tests with data. I've heard of others creating entire seeds with all the edge cases and lots of almost real-world data. Then only refreshing the db if they add a new migration.

If you are tired of writing lots of factories directly in your tests give this idea a try. You might like it.

Eric L. Barnes photo

Eric is the creator of Laravel News and has been covering Laravel since 2012.

Sponsored

masteringlaravel logo
Laravel Code Review

Get expert guidance in a few days with a Laravel code review

Visit Laravel Code Review

The latest

View all →
PHP Security Releases Fix Two Critical RCE Vulnerabilities image

PHP Security Releases Fix Two Critical RCE Vulnerabilities

Read article
Prevent Stale Database Reads in Laravel 13.38 image

Prevent Stale Database Reads in Laravel 13.38

Read article
Critical PHP Security Release Coming Tomorrow (October 21) image

Critical PHP Security Release Coming Tomorrow (October 21)

Read article
Critical Token Guard Auth Bypass Fixed in Laravel 13.29 and 12.68 image

Critical Token Guard Auth Bypass Fixed in Laravel 13.29 and 12.68

Read article
Run Large PlanetScale Queries in Laravel With DB::olap() image

Run Large PlanetScale Queries in Laravel With DB::olap()

Read article
Fluent Rule Builders for All Laravel Validation Rules image

Fluent Rule Builders for All Laravel Validation Rules

Read article