[12.x] isSoftDeletable(), isPrunable(), and isMassPrunable() to model class (#56060)

* feat(database): ✨ Add isSoftDeletable(), isPrunable(), and isMassPrunable() to model class

* fix(database): 🐛 Call model method instead of command method

* Restore "only check for soft deletes once when mass-pruning"

Co-authored-by: Luke Kuzmish <[email protected]>

See #55274

See #56060 (comment)

* Fix typo

Follow-up to 07520f2

* formatting

* fix test

---------

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

Author: shaedrich

src/Illuminate/Database/Console/PruneCommand.php

@@ -4,9 +4,6 @@
 
 use Illuminate\Console\Command;
 use Illuminate\Contracts\Events\Dispatcher;
-use Illuminate\Database\Eloquent\MassPrunable;
-use Illuminate\Database\Eloquent\Prunable;
-use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Database\Events\ModelPruningFinished;
 use Illuminate\Database\Events\ModelPruningStarting;
 use Illuminate\Database\Events\ModelsPruned;
@@ -101,7 +98,7 @@ protected function pruneModel(string $model)
             ? $instance->prunableChunkSize
             : $this->option('chunk');
 
-        $total = $this->isPrunable($model)
+        $total = $model::isPrunable()
             ? $instance->pruneAll($chunkSize)
             : 0;
 
@@ -141,7 +138,7 @@ protected function models()
             })
             ->when(! empty($except), fn ($models) => $models->reject(fn ($model) => in_array($model, $except)))
             ->filter(fn ($model) => class_exists($model))
-            ->filter(fn ($model) => $this->isPrunable($model))
+            ->filter(fn ($model) => $model::isPrunable())
             ->values();
     }
 
@@ -161,31 +158,18 @@ protected function getPath()
         return app_path('Models');
     }
 
-    /**
-     * Determine if the given model class is prunable.
-     *
-     * @param  string  $model
-     * @return bool
-     */
-    protected function isPrunable($model)
-    {
-        $uses = class_uses_recursive($model);
-
-        return in_array(Prunable::class, $uses) || in_array(MassPrunable::class, $uses);
-    }
-
     /**
      * Display how many models will be pruned.
      *
-     * @param  string  $model
+     * @param  class-string  $model
      * @return void
      */
     protected function pretendToPrune($model)
     {
         $instance = new $model;
 
         $count = $instance->prunable()
-            ->when(in_array(SoftDeletes::class, class_uses_recursive(get_class($instance))), function ($query) {
+            ->when($model::isSoftDeletable(), function ($query) {
                 $query->withTrashed();
             })->count();
 

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

@@ -8,7 +8,6 @@
 use Illuminate\Contracts\Foundation\Application;
 use Illuminate\Database\Eloquent\Collection as EloquentCollection;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Enumerable;
@@ -971,7 +970,7 @@ public function __call($method, $parameters)
             return $this->macroCall($method, $parameters);
         }
 
-        if ($method === 'trashed' && in_array(SoftDeletes::class, class_uses_recursive($this->modelName()))) {
+        if ($method === 'trashed' && $this->modelName()::isSoftDeletable()) {
             return $this->state([
                 $this->newModel()->getDeletedAtColumn() => $parameters[0] ?? Carbon::now()->subDay(),
             ]);

src/Illuminate/Database/Eloquent/MassPrunable.php

@@ -23,7 +23,7 @@ public function pruneAll(int $chunkSize = 1000)
 
         $total = 0;
 
-        $softDeletable = in_array(SoftDeletes::class, class_uses_recursive(get_class($this)));
+        $softDeletable = static::isSoftDeletable();
 
         do {
             $total += $count = $softDeletable

src/Illuminate/Database/Eloquent/Model.php

@@ -2289,6 +2289,30 @@ public function setPerPage($perPage)
         return $this;
     }
 
+    /**
+     * Determine if the model is soft deletable.
+     */
+    public static function isSoftDeletable(): bool
+    {
+        return in_array(SoftDeletes::class, class_uses_recursive(static::class));
+    }
+
+    /**
+     * Determine if the model is prunable.
+     */
+    protected function isPrunable(): bool
+    {
+        return in_array(Prunable::class, class_uses_recursive(static::class)) || static::isMassPrunable();
+    }
+
+    /**
+     * Determine if the model is mass prunable.
+     */
+    protected function isMassPrunable(): bool
+    {
+        return in_array(MassPrunable::class, class_uses_recursive(static::class));
+    }
+
     /**
      * Determine if lazy loading is disabled.
      *

src/Illuminate/Database/Eloquent/Prunable.php

@@ -20,7 +20,7 @@ public function pruneAll(int $chunkSize = 1000)
         $total = 0;
 
         $this->prunable()
-            ->when(in_array(SoftDeletes::class, class_uses_recursive(static::class)), function ($query) {
+            ->when(static::isSoftDeletable(), function ($query) {
                 $query->withTrashed();
             })->chunkById($chunkSize, function ($models) use (&$total) {
                 $models->each(function ($model) use (&$total) {
@@ -64,7 +64,7 @@ public function prune()
     {
         $this->pruning();
 
-        return in_array(SoftDeletes::class, class_uses_recursive(static::class))
+        return static::isSoftDeletable()
             ? $this->forceDelete()
             : $this->delete();
     }

src/Illuminate/Database/Eloquent/Relations/HasOneOrManyThrough.php

@@ -9,7 +9,6 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Database\Eloquent\Relations\Concerns\InteractsWithDictionary;
-use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Database\Query\Grammars\MySqlGrammar;
 use Illuminate\Database\UniqueConstraintViolationException;
 
@@ -146,7 +145,7 @@ public function getQualifiedParentKeyName()
      */
     public function throughParentSoftDeletes()
     {
-        return in_array(SoftDeletes::class, class_uses_recursive($this->throughParent));
+        return $this->throughParent::isSoftDeletable();
     }
 
     /**

src/Illuminate/Foundation/Testing/Concerns/InteractsWithDatabase.php

@@ -4,7 +4,6 @@
 
 use Illuminate\Contracts\Support\Jsonable;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Database\Events\QueryExecuted;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\DB;
@@ -223,8 +222,7 @@ public function expectsDatabaseQueryCount($expected, $connection = null)
      */
     protected function isSoftDeletableModel($model)
     {
-        return $model instanceof Model
-            && in_array(SoftDeletes::class, class_uses_recursive($model));
+        return $model instanceof Model && $model::isSoftDeletable();
     }
 
     /**

src/Illuminate/Routing/ImplicitRouteBinding.php

@@ -4,7 +4,6 @@
 
 use Illuminate\Contracts\Routing\UrlRoutable;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
-use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Routing\Exceptions\BackedEnumCaseNotFoundException;
 use Illuminate\Support\Reflector;
 use Illuminate\Support\Str;
@@ -42,14 +41,14 @@ public static function resolveForRoute($container, $route)
 
             $parent = $route->parentOfParameter($parameterName);
 
-            $routeBindingMethod = $route->allowsTrashedBindings() && in_array(SoftDeletes::class, class_uses_recursive($instance))
+            $routeBindingMethod = $route->allowsTrashedBindings() && $instance::isSoftDeletable()
                 ? 'resolveSoftDeletableRouteBinding'
                 : 'resolveRouteBinding';
 
             if ($parent instanceof UrlRoutable &&
                 ! $route->preventsScopedBindings() &&
                 ($route->enforcesScopedBindings() || array_key_exists($parameterName, $route->bindingFields()))) {
-                $childRouteBindingMethod = $route->allowsTrashedBindings() && in_array(SoftDeletes::class, class_uses_recursive($instance))
+                $childRouteBindingMethod = $route->allowsTrashedBindings() && $instance::isSoftDeletable()
                     ? 'resolveSoftDeletableChildRouteBinding'
                     : 'resolveChildRouteBinding';
 

src/Illuminate/Routing/RouteBinding.php

@@ -4,7 +4,6 @@
 
 use Closure;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
-use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Support\Str;
 
 class RouteBinding
@@ -68,7 +67,7 @@ public static function forModel($container, $class, $callback = null)
             // throw a not found exception otherwise we will return the instance.
             $instance = $container->make($class);
 
-            $routeBindingMethod = $route?->allowsTrashedBindings() && in_array(SoftDeletes::class, class_uses_recursive($instance))
+            $routeBindingMethod = $route?->allowsTrashedBindings() && $instance::isSoftDeletable()
                 ? 'resolveSoftDeletableRouteBinding'
                 : 'resolveRouteBinding';
 

tests/Support/SupportArrTest.php

@@ -292,8 +292,8 @@ public function testWhereNotNull(): void
         $array = array_values(Arr::whereNotNull(['a', null, 'b', null, 'c']));
         $this->assertEquals(['a', 'b', 'c'], $array);
 
-        $array = array_values(Arr::whereNotNull([null, 1, 'string', 0.0, false, [], new stdClass(), fn () => null]));
-        $this->assertEquals([1, 'string', 0.0, false, [], new stdClass(), fn () => null], $array);
+        $array = array_values(Arr::whereNotNull([null, 1, 'string', 0.0, false, [], $class = new stdClass(), $function = fn () => null]));
+        $this->assertEquals([1, 'string', 0.0, false, [], $class, $function], $array);
     }
 
     public function testFirst()