[12.x] Factory@insert() (#57600)

* Factory@insert()

* clean up

* Update Factory.php

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: cosmastech

src/Illuminate/Database/Eloquent/Factories/Factory.php

@@ -447,6 +447,34 @@ public function make($attributes = [], ?Model $parent = null)
         }
     }
 
+    /**
+     * Insert the model records in bulk. No model events are emitted.
+     *
+     * @param  array<string, mixed>  $attributes
+     * @param  Model|null  $parent
+     * @return void
+     */
+    public function insert(array $attributes = [], ?Model $parent = null): void
+    {
+        $made = $this->make($attributes, $parent);
+
+        $madeCollection = $made instanceof Collection 
+            ? $made 
+            : $this->newModel()->newCollection([$made]);
+
+        $model = $madeCollection->first();
+
+        if (isset($this->connection)) {
+            $model->setConnection($this->connection);
+        }
+
+        $query = $model->newQueryWithoutScopes();
+
+        $query->fillAndInsert(
+            $madeCollection->withoutAppends()->toArray()
+        );
+    }
+
     /**
      * Make an instance of the model with the given attributes.
      *

tests/Database/DatabaseEloquentFactoryTest.php

@@ -9,6 +9,7 @@
 use Illuminate\Contracts\Foundation\Application;
 use Illuminate\Database\Capsule\Manager as DB;
 use Illuminate\Database\Eloquent\Attributes\UseFactory;
+use Illuminate\Database\Eloquent\Casts\Attribute;
 use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Factories\CrossJoinSequence;
 use Illuminate\Database\Eloquent\Factories\Factory;
@@ -982,6 +983,23 @@ public function test_factory_model_morph_many_relationship_has_pending_attribute
         $this->assertEquals('other body', FactoryTestComment::first()->body);
     }
 
+    public function test_factory_can_insert()
+    {
+        (new FactoryTestPostFactory())
+            ->count(5)
+            ->recycle([
+                (new FactoryTestUserFactory())->create(['name' => Name::Taylor]),
+                (new FactoryTestUserFactory())->create(['name' => Name::Shad, 'created_at' => now()])
+            ])
+            ->state(['title' => 'hello'])
+            ->insert();
+        $this->assertCount(5, $posts = FactoryTestPost::query()->where('title', 'hello')->get());
+        $this->assertEquals(strtoupper($posts[0]->user->name), $posts[0]->upper_case_name);
+        $this->assertEquals(2, ($users = FactoryTestUser::query()->get())->count());
+        $this->assertCount(1, $users->where('name', 'shaedrich'));
+        $this->assertCount(1, $users->where('name', 'totwell'));
+    }
+
     /**
      * Get a database connection instance.
      *
@@ -1072,6 +1090,13 @@ class FactoryTestPost extends Eloquent
 
     protected $table = 'posts';
 
+    protected $appends = ['upper_case_name'];
+
+    public function upperCaseName(): Attribute
+    {
+        return Attribute::get(fn ($attr) => Str::upper($this->user->name));
+    }
+
     public function user()
     {
         return $this->belongsTo(FactoryTestUser::class, 'user_id');
@@ -1193,3 +1218,9 @@ class FactoryTestUseFactoryAttribute extends Eloquent
 {
     use HasFactory;
 }
+
+enum Name: string
+{
+    case Taylor = 'totwell';
+    case Shad = 'shaedrich';
+}