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

* Factory@insert() * clean up * Update Factory.php --------- Co-authored-by: Taylor Otwell <taylor@laravel.com>

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';
+}