Add expects to built-in Facade testing methods (#34932)

Author: jasonmccreary

src/Illuminate/Support/Facades/Facade.php

@@ -90,6 +90,22 @@ public static function shouldReceive()
         return $mock->shouldReceive(...func_get_args());
     }
 
+    /**
+     * Initiate a mock expectation on the facade.
+     *
+     * @return \Mockery\Expectation
+     */
+    public static function expects()
+    {
+        $name = static::getFacadeAccessor();
+
+        $mock = static::isMock()
+            ? static::$resolvedInstance[$name]
+            : static::createFreshMockInstance();
+
+        return $mock->expects(...func_get_args());
+    }
+
     /**
      * Create a fresh mock instance for the given class.
      *

tests/Support/SupportFacadeTest.php

@@ -70,6 +70,16 @@ public function testCanBeMockedWithoutUnderlyingInstance()
         FacadeStub::shouldReceive('foo')->once()->andReturn('bar');
         $this->assertSame('bar', FacadeStub::foo());
     }
+
+    public function testExpectsReturnsAMockeryMockWithExpectationRequired()
+    {
+        $app = new ApplicationStub;
+        $app->setAttributes(['foo' => new stdClass]);
+        FacadeStub::setFacadeApplication($app);
+
+        $this->assertInstanceOf(MockInterface::class, $mock = FacadeStub::expects('foo')->with('bar')->andReturn('baz')->getMock());
+        $this->assertSame('baz', $app['foo']->foo('bar'));
+    }
 }
 
 class FacadeStub extends Facade