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

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
Laravel AI SDK and Laravel MCP Security Fixes: Update Now image

Laravel AI SDK and Laravel MCP Security Fixes: Update Now

Read article
Mailbox for Laravel: Preview and Test Rendered Email image

Mailbox for Laravel: Preview and Test Rendered Email

Read article
Count Worker Crashes as Job Exceptions in Laravel 13.34 image

Count Worker Crashes as Job Exceptions in Laravel 13.34

Read article
Elastic Bridge: Eloquent-Style Queries for Elasticsearch and OpenSearch image

Elastic Bridge: Eloquent-Style Queries for Elasticsearch and OpenSearch

Read article
Laravel Release Cycle: Versions, Support Policy, and Dates image

Laravel Release Cycle: Versions, Support Policy, and Dates

Read article
Unlearn.dev goes free for a weekend, October 10 and 11 image

Unlearn.dev goes free for a weekend, October 10 and 11

Read article