Declare exceptions unreportable using the ShouldntReport interface (#52337)

* Added ability to define exceptions as unreportable using ShouldntReport interface

* Update ShouldntReport.php

* formatting

---------

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

Author: chrispage1

src/Illuminate/Contracts/Debug/ShouldntReport.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Illuminate\Contracts\Debug;
+
+interface ShouldntReport
+{
+    //
+}

src/Illuminate/Foundation/Exceptions/Handler.php

@@ -13,6 +13,7 @@
 use Illuminate\Console\View\Components\Error;
 use Illuminate\Contracts\Container\Container;
 use Illuminate\Contracts\Debug\ExceptionHandler as ExceptionHandlerContract;
+use Illuminate\Contracts\Debug\ShouldntReport;
 use Illuminate\Contracts\Foundation\ExceptionRenderer;
 use Illuminate\Contracts\Support\Responsable;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
@@ -401,6 +402,10 @@ protected function shouldntReport(Throwable $e)
             return true;
         }
 
+        if ($e instanceof ShouldntReport) {
+            return true;
+        }
+
         $dontReport = array_merge($this->dontReport, $this->internalDontReport);
 
         if (! is_null(Arr::first($dontReport, fn ($type) => $e instanceof $type))) {

tests/Integration/Foundation/ExceptionHandlerTest.php

@@ -5,6 +5,8 @@
 use Illuminate\Auth\Access\AuthorizationException;
 use Illuminate\Auth\Access\Response;
 use Illuminate\Contracts\Debug\ExceptionHandler;
+use Illuminate\Contracts\Debug\ShouldntReport;
+use Illuminate\Contracts\Support\Responsable;
 use Illuminate\Support\Facades\Config;
 use Illuminate\Support\Facades\Route;
 use Orchestra\Testbench\TestCase;
@@ -42,6 +44,30 @@ public function testItRendersAuthorizationExceptions()
             ]);
     }
 
+    public function testItDoesntReportExceptionsWithShouldntReportInterface()
+    {
+        Config::set('app.debug', true);
+        $reported = [];
+        $this->app[ExceptionHandler::class]->reportable(function (Throwable $e) use (&$reported) {
+            $reported[] = $e;
+        });
+
+        $exception = new class extends \Exception implements ShouldntReport, Responsable {
+            public function toResponse($request)
+            {
+                return response('shouldnt report', 500);
+            }
+        };
+
+        Route::get('test-route', fn () => throw $exception);
+
+        $this->getJson('test-route')
+            ->assertStatus(500)
+            ->assertSee('shouldnt report');
+
+        $this->assertEquals([], $reported);
+    }
+
     public function testItRendersAuthorizationExceptionsWithCustomStatusCode()
     {
         Route::get('test-route', fn () => Response::deny('expected message', 321)->withStatus(404)->authorize());