{"id":620,"date":"2025-09-02T11:45:22","date_gmt":"2025-09-02T11:45:22","guid":{"rendered":"https:\/\/1v0.net\/blog\/?p=620"},"modified":"2025-09-02T11:45:24","modified_gmt":"2025-09-02T11:45:24","slug":"using-laravel-factories-and-seeders-for-test-data","status":"publish","type":"post","link":"https:\/\/1v0.net\/blog\/using-laravel-factories-and-seeders-for-test-data\/","title":{"rendered":"Using Laravel Factories and Seeders for Test Data"},"content":{"rendered":"\n

Populating reliable test and demo data is essential for development speed, realistic QA, and repeatable CI. In this guide, you\u2019ll learn what factories<\/strong> are (and why they matter), how to build seeders<\/strong> that are safe and idempotent, how to scale with an extended folder structure<\/strong> for large projects, and how to tailor seeding for environments<\/strong> (local\/staging\/production) and even multi-tenant<\/strong> apps.<\/p>\n\n\n\n

<\/div>\n\n\n\n

What Are Factories (and Why Use Them)?<\/strong><\/h2>\n\n\n\n

Factories<\/strong> generate model instances with realistic attributes for testing, seeding, and demos. They keep your code DRY, encourage consistent data shapes, and make complex relationship graphs trivial to build. Instead of hand-writing arrays, you call factory builders that know how to produce valid models (with relationships, states, and sequences).<\/p>\n\n\n\n

Basic Factory Definition<\/strong><\/h3>\n\n\n
\/\/ database\/factories\/UserFactory.php<\/span>\nnamespace<\/span> Database<\/span>\\Factories<\/span>;\n\nuse<\/span> App<\/span>\\Models<\/span>\\User<\/span>;\nuse<\/span> Illuminate<\/span>\\Database<\/span>\\Eloquent<\/span>\\Factories<\/span>\\Factory<\/span>;\nuse<\/span> Illuminate<\/span>\\Support<\/span>\\Str<\/span>;\n\nclass<\/span> UserFactory<\/span> extends<\/span> Factory<\/span>\n<\/span>{\n    protected<\/span> $model = User::class;\n\n    public<\/span> function<\/span> definition<\/span>()<\/span>: array<\/span>\n    <\/span>{\n        return<\/span> [\n            'name'<\/span> => $this<\/span>->faker->name(),\n            'email'<\/span> => $this<\/span>->faker->unique()->safeEmail(),\n            'email_verified_at'<\/span> => now(),\n            'password'<\/span> => bcrypt('password'<\/span>), \/\/ don't use in production<\/span>\n            'remember_token'<\/span> => Str::random(10<\/span>),\n        ];\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
This factory tells Laravel how to build a valid User<\/code> with realistic defaults. Use it for tests (User::factory()<\/code>) and also inside seeders to generate bulk data.<\/p>\n\n\n\n
Factory States (Variants)<\/strong><\/h3>\n\n\n
\/\/ database\/factories\/UserFactory.php (continued)<\/span>\npublic<\/span> function<\/span> admin<\/span>()<\/span>: static<\/span>\n<\/span>{\n    return<\/span> $this<\/span>->state(fn () => [\n        'is_admin'<\/span> => true<\/span>,\n    ]);\n}\n\npublic<\/span> function<\/span> unverified<\/span>()<\/span>: static<\/span>\n<\/span>{\n    return<\/span> $this<\/span>->state(fn () => [\n        'email_verified_at'<\/span> => null<\/span>,\n    ]);\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
States<\/strong> let you quickly switch variants like admin users or unverified users: User::factory()->admin()->create()<\/code>. Combine states freely.<\/p>\n\n\n\n
Sequences (Patterned Data)<\/strong><\/h3>\n\n\n
User::factory()\n    ->count(4<\/span>)\n    ->sequence(\n        ['plan'<\/span> => 'free'<\/span>],\n        ['plan'<\/span> => 'pro'<\/span>],\n        ['plan'<\/span> => 'business'<\/span>],\n        ['plan'<\/span> => 'enterprise'<\/span>],\n    )\n    ->create();<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Sequences<\/strong> rotate attribute sets per model, great for realistic mixes (pricing tiers, locales, statuses).<\/p>\n\n\n\n
Relationships (for \/ has \/ hasAttached)<\/strong><\/h3>\n\n\n
\/\/ Example: A Post belongs to a User and has many Tags via pivot<\/span>\nuse<\/span> App<\/span>\\Models<\/span>\\Post<\/span>;\nuse<\/span> App<\/span>\\Models<\/span>\\Tag<\/span>;\n\nPost::factory()\n    ->for(User::factory()->admin(), 'author'<\/span>)\n    ->hasAttached(Tag::factory()->count(3<\/span>), ['weight'<\/span> => 1<\/span>]) \/\/ pivot fields<\/span>\n    ->count(10<\/span>)\n    ->create();<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
for()<\/code> assigns a parent relation; has()<\/code>\/hasAttached()<\/code> creates children (including pivot attributes). This builds correct graphs with one call.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Seeders: Repeatable, Idempotent Data<\/strong><\/h2>\n\n\n\n
Seeders<\/strong> populate databases with base lookups, reference data, demo content, and admin accounts. Make them idempotent<\/em> (safe to run multiple times) so deploys and CI stay reliable.<\/p>\n\n\n\n
DatabaseSeeder as the Orchestrator<\/strong><\/h3>\n\n\n
\/\/ database\/seeders\/DatabaseSeeder.php<\/span>\nnamespace<\/span> Database<\/span>\\Seeders<\/span>;\n\nuse<\/span> Illuminate<\/span>\\Database<\/span>\\Seeder<\/span>;\n\nclass<\/span> DatabaseSeeder<\/span> extends<\/span> Seeder<\/span>\n<\/span>{\n    public<\/span> function<\/span> run<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        $this<\/span>->call([\n            LookupSeeder::class,\n            AdminUserSeeder::class,\n            DemoContentSeeder::class,\n        ]);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
The root seeder calls sub-seeders in a controlled order. Keep \u201cbase system\u201d seed separate from \u201cdemo\u201d seed for clarity.<\/p>\n\n\n\n
Idempotent Patterns (firstOrCreate \/ upsert)<\/strong><\/h3>\n\n\n
\/\/ database\/seeders\/LookupSeeder.php<\/span>\nuse<\/span> App<\/span>\\Models<\/span>\\Plan<\/span>;\nuse<\/span> Illuminate<\/span>\\Database<\/span>\\Seeder<\/span>;\n\nclass<\/span> LookupSeeder<\/span> extends<\/span> Seeder<\/span>\n<\/span>{\n    public<\/span> function<\/span> run<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        Plan::upsert([\n            ['code'<\/span> => 'free'<\/span>, 'name'<\/span> => 'Free'<\/span>, 'price'<\/span> => 0<\/span>],\n            ['code'<\/span> => 'pro'<\/span>, 'name'<\/span> => 'Pro'<\/span>, 'price'<\/span> => 19<\/span>],\n        ], ['code'<\/span>], ['name'<\/span>,'price'<\/span>]);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
upsert<\/code> updates or inserts by a unique key; firstOrCreate<\/code> is perfect for single rows. This keeps seeders re-runnable.<\/p>\n\n\n\n
Model::unguard + FK Handling (MySQL)<\/strong><\/h3>\n\n\n
use<\/span> Illuminate<\/span>\\Database<\/span>\\Eloquent<\/span>\\Model<\/span>;\nuse<\/span> Illuminate<\/span>\\Support<\/span>\\Facades<\/span>\\DB<\/span>;\n\n\/\/ inside a seeder run():<\/span>\nModel::unguard();\nDB::statement('SET FOREIGN_KEY_CHECKS=0'<\/span>);\n\/\/ ... perform bulk inserts \/ truncations cautiously ...<\/span>\nDB::statement('SET FOREIGN_KEY_CHECKS=1'<\/span>);\nModel::reguard();<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Temporarily unguard models for bulk inserts and use FK toggles carefully when resetting demo data. Avoid in production seed unless you know the implications.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Extended Folder Structure for Many Seeders<\/strong><\/h2>\n\n\n\n
Large apps benefit from grouping seeders by domain. Keep \u201ccore\u201d vs \u201cdemo\u201d clear, and isolate third-party integration seeds (e.g., roles\/permissions) for repeatability.<\/p>\n\n\n
database\/\n\u2514\u2500 seeders\/\n   \u251c\u2500 Core\/\n   \u2502  \u251c\u2500 Lookup\/\n   \u2502  \u2502  \u251c\u2500 CountriesSeeder.php\n   \u2502  \u2502  \u2514\u2500 PlansSeeder.php\n   \u2502  \u251c\u2500 Auth\/\n   \u2502  \u2502  \u251c\u2500 AdminUserSeeder.php\n   \u2502  \u2502  \u2514\u2500 RolesPermissionsSeeder.php\n   \u2502  \u2514\u2500 Content\/\n   \u2502     \u2514\u2500 SettingsSeeder.php\n   \u251c\u2500 Demo\/\n   \u2502  \u251c\u2500 UsersDemoSeeder.php\n   \u2502  \u251c\u2500 BlogDemoSeeder.php\n   \u2502  \u2514\u2500 OrdersDemoSeeder.php\n   \u2514\u2500 Tenants\/\n      \u251c\u2500 TenantBootstrapSeeder.php\n      \u2514\u2500 TenantDemoSeeder.php<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
This structure scales: Core<\/code> is minimal system data; Demo<\/code> is optional; Tenants<\/code> handles multi-tenant bootstrap. PSR-4 autoloading works for nested namespaces under Database\\Seeders<\/code>.<\/p>\n\n\n\n
Namespacing & Calling Sub-Seeders<\/strong><\/h3>\n\n\n
\/\/ database\/seeders\/DatabaseSeeder.php<\/span>\nnamespace<\/span> Database<\/span>\\Seeders<\/span>;\n\nuse<\/span> Database<\/span>\\Seeders<\/span>\\Core<\/span>\\Lookup<\/span>\\CountriesSeeder<\/span>;\nuse<\/span> Database<\/span>\\Seeders<\/span>\\Core<\/span>\\Lookup<\/span>\\PlansSeeder<\/span>;\nuse<\/span> Database<\/span>\\Seeders<\/span>\\Core<\/span>\\Auth<\/span>\\AdminUserSeeder<\/span>;\nuse<\/span> Database<\/span>\\Seeders<\/span>\\Core<\/span>\\Auth<\/span>\\RolesPermissionsSeeder<\/span>;\nuse<\/span> Database<\/span>\\Seeders<\/span>\\Demo<\/span>\\BlogDemoSeeder<\/span>;\n\nclass<\/span> DatabaseSeeder<\/span> extends<\/span> Seeder<\/span>\n<\/span>{\n    public<\/span> function<\/span> run<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        $this<\/span>->call([\n            CountriesSeeder::class,\n            PlansSeeder::class,\n            RolesPermissionsSeeder::class,\n            AdminUserSeeder::class,\n        ]);\n\n        if<\/span> (app()->environment(['local'<\/span>,'staging'<\/span>])) {\n            $this<\/span>->call([BlogDemoSeeder::class]);\n        }\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Keep imports explicit. Use environment checks to include demo-only data locally while keeping production clean.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Environment & Tenant-Aware Seeding<\/strong><\/h2>\n\n\n\n
Environment-Specific<\/strong><\/h3>\n\n\n
# run only demo seeds locally<\/span>\nphp artisan db:seed --class=Database\\\\Seeders\\\\Demo\\\\BlogDemoSeeder<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
Use command-line control for targeted seeds. Inside DatabaseSeeder<\/code>, conditionally call demo seeders with app()->environment([...])<\/code>.<\/p>\n\n\n\n
Per-Tenant (Loop & Switch)<\/strong><\/h3>\n\n\n
\/\/ database\/seeders\/Tenants\/TenantBootstrapSeeder.php<\/span>\nuse<\/span> App<\/span>\\Models<\/span>\\Tenant<\/span>;\nuse<\/span> Illuminate<\/span>\\Support<\/span>\\Facades<\/span>\\DB<\/span>;\n\nclass<\/span> TenantBootstrapSeeder<\/span> extends<\/span> Seeder<\/span>\n<\/span>{\n    public<\/span> function<\/span> run<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        foreach<\/span> (Tenant::cursor() as<\/span> $tenant) {\n            \/\/ switch connection dynamically, then seed<\/span>\n            DB::setDefaultConnection($tenant->connection);\n            $this<\/span>->call([\n                TenantSchemaSeeder::class,\n                TenantAdminSeeder::class,\n            ]);\n        }\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Multi-tenant apps often seed per-tenant databases. Loop tenants, switch connection (or use a tenancy package helper), and call tenant-specific seeders.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Generating Bulk Data with Factories<\/strong><\/h2>\n\n\n
\/\/ database\/seeders\/Demo\/BlogDemoSeeder.php<\/span>\nuse<\/span> App<\/span>\\Models<\/span>\\User<\/span>;\nuse<\/span> App<\/span>\\Models<\/span>\\Post<\/span>;\nuse<\/span> App<\/span>\\Models<\/span>\\Tag<\/span>;\n\nclass<\/span> BlogDemoSeeder<\/span> extends<\/span> Seeder<\/span>\n<\/span>{\n    public<\/span> function<\/span> run<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        $users = User::factory()->count(10<\/span>)->create();\n\n        $tags = Tag::factory()\n            ->count(8<\/span>)\n            ->sequence(fn ($sequence) => ['weight'<\/span> => $sequence->index + 1<\/span>])\n            ->create();\n\n        Post::factory()\n            ->count(50<\/span>)\n            ->for($users->random(), 'author'<\/span>)\n            ->hasAttached($tags->random(rand(2<\/span>,4<\/span>)))\n            ->create();\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Factories make it trivial to create consistent, high-volume demo data with correct relations. Use sequence<\/code> for predictable patterns and random()<\/code> for variety.<\/p>\n\n\n\n
Performance Tips<\/strong><\/h3>\n\n\n
\/\/ Example: bulk inserts with minimal event noise<\/span>\nPost::withoutEvents(function<\/span> ()<\/span> <\/span>{\n    Post::factory()->count(2000<\/span>)->create();\n});<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Wrap heavy factory runs with withoutEvents<\/code> if event\/listener overhead is large. Consider chunking tasks, disabling observers, and using optimized indexes.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Using Factories Directly in Tests<\/strong><\/h2>\n\n\n
\/\/ tests\/Feature\/PostApiTest.php<\/span>\nuse<\/span> Tests<\/span>\\TestCase<\/span>;\nuse<\/span> Illuminate<\/span>\\Foundation<\/span>\\Testing<\/span>\\RefreshDatabase<\/span>;\nuse<\/span> App<\/span>\\Models<\/span>\\User<\/span>;\nuse<\/span> App<\/span>\\Models<\/span>\\Post<\/span>;\n\nclass<\/span> PostApiTest<\/span> extends<\/span> TestCase<\/span>\n<\/span>{\n    use<\/span> RefreshDatabase<\/span>;\n\n    public<\/span> function<\/span> test_index_requires_auth<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        $this<\/span>->getJson('\/api\/posts'<\/span>)->assertUnauthorized();\n    }\n\n    public<\/span> function<\/span> test_index_returns_posts<\/span>()<\/span>: void<\/span>\n    <\/span>{\n        $user = User::factory()->create();\n        Post::factory()->count(3<\/span>)->for($user, 'author'<\/span>)->create();\n\n        $this<\/span>->actingAs($user)->getJson('\/api\/posts'<\/span>)\n            ->assertOk()\n            ->assertJsonCount(3<\/span>, 'data'<\/span>);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Factories shine in tests: realistic data, clearer intent, and isolated states per test using RefreshDatabase<\/code>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Optional: Admin-Only UI to Run Demo Seeds<\/strong><\/h2>\n\n\n
\/\/ routes\/web.php<\/span>\nRoute::post('\/admin\/run-demo-seed'<\/span>, [AdminSeedController::class, 'run'<\/span>])\n    ->middleware(['auth'<\/span>,'can:admin'<\/span>]);\n\n\/\/ app\/Http\/Controllers\/AdminSeedController.php<\/span>\nuse<\/span> Illuminate<\/span>\\Support<\/span>\\Facades<\/span>\\Artisan<\/span>;\n\nclass<\/span> AdminSeedController<\/span>\n<\/span>{\n    public<\/span> function<\/span> run<\/span>()<\/span>\n    <\/span>{\n        Artisan::call('db:seed'<\/span>, [\n            '--class'<\/span> => 'Database\\\\Seeders\\\\Demo\\\\BlogDemoSeeder'<\/span>,\n            '--force'<\/span> => true<\/span>,\n        ]);\n\n        return<\/span> back()->with('status'<\/span>,'Demo data seeded.'<\/span>);\n    }\n}<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Expose a safe, admin-guarded endpoint to trigger demo seeds for staging or QA. Never allow anonymous access to seed endpoints.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Wrapping Up<\/strong><\/h2>\n\n\n\n
Factories produce realistic models with minimal code; seeders assemble them into coherent datasets for base lookups, demos, and tests. With a scalable folder structure, idempotent patterns (upsert<\/code>\/firstOrCreate<\/code>), and environment\/tenant awareness, your data pipeline stays fast, reliable, and CI-friendly.<\/p>\n\n\n\n
<\/div>\n\n\n\n
What\u2019s Next<\/strong><\/h2>\n\n\n\n
Level up your testing and data quality with these:<\/p>\n\n\n\n