[12.x] Feat: ability to explicitly exclude factory relationships

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

@@ -91,6 +91,13 @@ abstract class Factory
      */
     protected $expandRelationships = true;
 
+    /**
+     * The relationships that should not be automatically created.
+     *
+     * @var array
+     */
+    protected $excludeRelationships = [];
+
     /**
      * The name of the database connection that will be used to create the models.
      *
@@ -152,6 +159,7 @@ abstract class Factory
      * @param  string|null  $connection
      * @param  \Illuminate\Support\Collection|null  $recycle
      * @param  bool|null  $expandRelationships
+     * @param  array  $excludeRelationships
      */
     public function __construct(
         $count = null,
@@ -162,7 +170,8 @@ public function __construct(
         ?Collection $afterCreating = null,
         $connection = null,
         ?Collection $recycle = null,
-        ?bool $expandRelationships = null
+        ?bool $expandRelationships = null,
+        array $excludeRelationships = [],
     ) {
         $this->count = $count;
         $this->states = $states ?? new Collection;
@@ -174,6 +183,7 @@ public function __construct(
         $this->recycle = $recycle ?? new Collection;
         $this->faker = $this->withFaker();
         $this->expandRelationships = $expandRelationships ?? self::$expandRelationshipsByDefault;
+        $this->excludeRelationships = $excludeRelationships;
     }
 
     /**
@@ -508,6 +518,8 @@ protected function expandAttributes(array $definition)
             ->map($evaluateRelations = function ($attribute) {
                 if (! $this->expandRelationships && $attribute instanceof self) {
                     $attribute = null;
+                } elseif ($attribute instanceof self && in_array($attribute->modelName(), $this->excludeRelationships)) {
+                    $attribute = null;
                 } elseif ($attribute instanceof self) {
                     $attribute = $this->getRandomRecycledModel($attribute->modelName())?->getKey()
                         ?? $attribute->recycle($this->recycle)->create()->getKey();
@@ -776,9 +788,9 @@ public function count(?int $count)
      *
      * @return static
      */
-    public function withoutParents()
+    public function withoutParents($parents = [])
     {
-        return $this->newInstance(['expandRelationships' => false]);
+        return $this->newInstance(! $parents ? ['expandRelationships' => false] : ['excludeRelationships' => $parents]);
     }
 
     /**
@@ -820,6 +832,7 @@ protected function newInstance(array $arguments = [])
             'connection' => $this->connection,
             'recycle' => $this->recycle,
             'expandRelationships' => $this->expandRelationships,
+            'excludeRelationships' => $this->excludeRelationships,
         ], $arguments)));
     }
 

tests/Database/DatabaseEloquentFactoryTest.php

@@ -832,6 +832,16 @@ public function test_can_disable_relationships()
         $this->assertNull($post->user_id);
     }
 
+    public function test_can_disable_relationships_explicitly()
+    {
+        $comment = FactoryTestCommentFactory::new()
+            ->withoutParents([FactoryTestUser::class])
+            ->make();
+
+        $this->assertNull($comment->user_id);
+        $this->assertNotNull($comment->commentable->id);
+    }
+
     public function test_can_default_to_without_parents()
     {
         FactoryTestPostFactory::dontExpandRelationshipsByDefault();