[8.x] Adds withoutDeprecationHandling (#39261)

* Adds `withoutDeprecationHandling`

* Updates test

* Updates tests

Author: nunomaduro

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

@@ -0,0 +1,49 @@
+<?php
+
+namespace Illuminate\Foundation\Testing\Concerns;
+
+use ErrorException;
+
+trait InteractsWithDeprecationHandling
+{
+    /**
+     * The original deprecation handler.
+     *
+     * @var callable|null
+     */
+    protected $originalDeprecationHandler;
+
+    /**
+     * Restore deprecation handling.
+     *
+     * @return $this
+     */
+    protected function withDeprecationHandling()
+    {
+        if ($this->originalDeprecationHandler) {
+            set_error_handler(tap($this->originalDeprecationHandler, function () {
+                $this->originalDeprecationHandler = null;
+            }));
+        }
+
+        return $this;
+    }
+
+    /**
+     * Disable deprecation handling for the test.
+     *
+     * @return $this
+     */
+    protected function withoutDeprecationHandling()
+    {
+        if ($this->originalDeprecationHandler == null) {
+            $this->originalDeprecationHandler = set_error_handler(function ($level, $message, $file = '', $line = 0) {
+                if (error_reporting() & $level) {
+                    throw new ErrorException($message, 0, $level, $file, $line);
+                }
+            });
+        }
+
+        return $this;
+    }
+}

src/Illuminate/Foundation/Testing/TestCase.php

@@ -22,6 +22,7 @@ abstract class TestCase extends BaseTestCase
         Concerns\InteractsWithAuthentication,
         Concerns\InteractsWithConsole,
         Concerns\InteractsWithDatabase,
+        Concerns\InteractsWithDeprecationHandling,
         Concerns\InteractsWithExceptionHandling,
         Concerns\InteractsWithSession,
         Concerns\InteractsWithTime,

tests/Testing/Concerns/InteractsWithDeprecationHandlingTest.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Illuminate\Tests\Testing\Concerns;
+
+use ErrorException;
+use Illuminate\Foundation\Testing\Concerns\InteractsWithDeprecationHandling;
+use PHPUnit\Framework\TestCase;
+
+class InteractsWithDeprecationHandlingTest extends TestCase
+{
+    use InteractsWithDeprecationHandling;
+
+    protected $original;
+
+    protected $deprecationsFound = false;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+
+        $this->original = set_error_handler(function () {
+            $this->deprecationsFound = true;
+        });
+    }
+
+    public function testWithDeprecationHandling()
+    {
+        $this->withDeprecationHandling();
+
+        trigger_error('Something is deprecated', E_USER_DEPRECATED);
+
+        $this->assertTrue($this->deprecationsFound);
+    }
+
+    public function testWithoutDeprecationHandling()
+    {
+        $this->withoutDeprecationHandling();
+
+        $this->expectException(ErrorException::class);
+        $this->expectExceptionMessage('Something is deprecated');
+
+        trigger_error('Something is deprecated', E_USER_DEPRECATED);
+    }
+
+    public function tearDown(): void
+    {
+        set_error_handler($this->original);
+
+        $this->originalDeprecationHandler = null;
+        $this->deprecationsFound = false;
+
+        parent::tearDown();
+    }
+}