database/
├── factories/
│   ├── UserFactory.php      ← ships with Laravel
│   └── PostFactory.php
├── migrations/
└── seeders/
    ├── DatabaseSeeder.php   ← entry point for db:seed
    └── PostSeeder.php

1. Define a factory

   Generate a factory for the model. In definition(), return default values. fake() gives you Faker, a library of realistic random data.

   
             php artisan make:factory PostFactory --model=Post
           

   
             <?php
   
             namespace Database\Factories;
   
             use App\Models\User;
             use Illuminate\Database\Eloquent\Factories\Factory;
   
             class PostFactory extends Factory
             {
                 public function definition(): array
                 {
                     return [
                         'user_id'      => User::factory(),
                         'title'        => fake()->sentence(),
                         'body'         => fake()->paragraphs(4, true),
                         'published_at' => now(),
                     ];
                 }
             }
           

   The model needs the HasFactory trait (models made with make:model already have it). 'user_id' => User::factory() creates an author automatically when none is given.

2. Use it: make, create and count

   make() builds models in memory only; create() also saves them. Override any field by passing an array.

   
             $post  = Post::factory()->make();                       // not saved
             $post  = Post::factory()->create();                     // saved + author created
             $posts = Post::factory()->count(10)->create();          // 10 posts
             $post  = Post::factory()->create(['title' => 'Pinned']); // override a field
           

3. Add states for variations

   A state is a named tweak to the defaults, like a draft post. It keeps tests readable: Post::factory()->draft() says exactly what you mean.

   
             public function draft(): static
             {
                 return $this->state(fn (array $attributes) => [
                     'published_at' => null,
                 ]);
             }
           

   
             test('drafts are hidden from the blog index', function () {
                 Post::factory()->draft()->create(['title' => 'Secret draft']);
   
                 $this->get('/posts')->assertDontSee('Secret draft');
             });
           

4. Build relationships with has and for

   Factories understand your Eloquent relationships. Use has() to create children and for() to attach a parent.

   
             // A user with 3 posts, each with 5 comments
             $user = User::factory()
                 ->has(Post::factory()->count(3)->has(Comment::factory()->count(5)))
                 ->create();
   
             // Magic shortcut for the same "has many" idea
             $user = User::factory()->hasPosts(3)->create();
   
             // A post that belongs to a specific user and category
             $post = Post::factory()
                 ->for($user)
                 ->for(Category::factory()->state(['name' => 'Laravel']))
                 ->create();
           

5. Write seeders and wire up DatabaseSeeder

   A seeder is a class with a run() method that creates data. DatabaseSeeder is the entry point; it calls the others in order.

   
             php artisan make:seeder PostSeeder
           

   
             class DatabaseSeeder extends Seeder
             {
                 public function run(): void
                 {
                     User::factory()->create([
                         'name'  => 'Test User',
                         'email' => 'test@example.com',   // a known login for local dev
                     ]);
   
                     $this->call([CategorySeeder::class, PostSeeder::class]);
                 }
             }
           

   
             public function run(): void
             {
                 User::factory(10)
                     ->has(Post::factory()->count(5)->for(Category::inRandomOrder()->first()))
                     ->create();
             }
           

6. Run the seeders

   db:seed runs DatabaseSeeder. migrate:fresh --seed drops every table, re-runs all migrations, then seeds: a perfect reset button for local development.

   
             php artisan db:seed                          # run DatabaseSeeder
             php artisan db:seed --class=PostSeeder       # run just one seeder
             php artisan migrate:fresh --seed             # wipe, rebuild, seed
           

   ⚠️ Never run migrate:fresh in production

   It deletes every table and all data. Laravel asks for confirmation in production, but treat it as a local-only command.

   In tests, call $this->seed() (or $this->seed(CategorySeeder::class)) when you need reference data like categories.

• Factories define default fake attributes in definition() using fake().
• make() builds in memory, create() saves; count(n) makes many.
• States (->draft()) name common variations; keep defaults predictable.
• has() creates children and for() attaches a parent model.
• Seeders fill the DB; DatabaseSeeder calls them; run with db:seed or migrate:fresh --seed.