[9.x] Allow loading trashed models for resource routes (#44405)

* allow loading trashed models for resource routes

This change gives the ability to load trashed models when registering a route resource.

You can load trashed models on **all** the resource routes by calling `withTrashed()` with no parameters:

```php
Route::resource('users', UserController::class)->withTrashed();
```

You can selectively load trashed models on methods by passing an array:

```php
Route::resource('users', UserController::class)->withTrashed(['show']);
```

* minor styling

* minor formatting

oops

* formatting

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

Author: browner12

src/Illuminate/Routing/PendingResourceRegistration.php

@@ -227,6 +227,19 @@ public function scoped(array $fields = [])
         return $this;
     }
 
+    /**
+     * Define which routes should allow "trashed" models to be retrieved when resolving implicit model bindings.
+     *
+     * @param  array  $methods
+     * @return \Illuminate\Routing\PendingResourceRegistration
+     */
+    public function withTrashed(array $methods = [])
+    {
+        $this->options['trashed'] = $methods;
+
+        return $this;
+    }
+
     /**
      * Register the resource route.
      *

src/Illuminate/Routing/ResourceRegistrar.php

@@ -94,7 +94,9 @@ public function register($name, $controller, array $options = [])
 
         $collection = new RouteCollection;
 
-        foreach ($this->getResourceMethods($defaults, $options) as $m) {
+        $resourceMethods = $this->getResourceMethods($defaults, $options);
+
+        foreach ($resourceMethods as $m) {
             $route = $this->{'addResource'.ucfirst($m)}(
                 $name, $base, $controller, $options
             );
@@ -103,6 +105,11 @@ public function register($name, $controller, array $options = [])
                 $this->setResourceBindingFields($route, $options['bindingFields']);
             }
 
+            if (isset($options['trashed']) &&
+                in_array($m, ! empty($options['trashed']) ? $options['trashed'] : $resourceMethods)) {
+                $route->withTrashed();
+            }
+
             $collection->add($route);
         }