[8.x] Added a method to the Macroable trait that removes all configur…

…ed macros. (#39633)

* Added a method to the Macroable trait that removes all configured macros.

* Added a test case for flushMacros.

* Changed the comment on the flushMacros method to be clearer.

src/Illuminate/Macroable/Traits/Macroable.php

@@ -62,6 +62,16 @@ public static function hasMacro($name)
         return isset(static::$macros[$name]);
     }
 
+    /**
+     * Flush the existing macros.
+     *
+     * @return void
+     */
+    public static function flushMacros()
+    {
+        static::$macros = [];
+    }
+
     /**
      * Dynamically handle calls to the class.
      *

tests/Support/SupportMacroableTest.php

@@ -2,6 +2,7 @@
 
 namespace Illuminate\Tests\Support;
 
+use BadMethodCallException;
 use Illuminate\Support\Traits\Macroable;
 use PHPUnit\Framework\TestCase;
 
@@ -73,6 +74,23 @@ public function testClassBasedMacrosNoReplace()
         TestMacroable::mixin(new TestMixin);
         $this->assertSame('foo', $instance->methodThree());
     }
+
+    public function testFlushMacros()
+    {
+        TestMacroable::macro('flushMethod', function () {
+            return 'flushMethod';
+        });
+
+        $instance = new TestMacroable;
+
+        $this->assertSame('flushMethod', $instance->flushMethod());
+
+        TestMacroable::flushMacros();
+
+        $this->expectException(BadMethodCallException::class);
+
+        $instance->flushMethod();
+    }
 }
 
 class EmptyMacroable