[TOC] # 使用場景 我們在使用laravel來寫API時，經常需要返回一個json字符串或JsonResponse，通常我們的做法可能有兩種。 1. 在BaseController中定義一個返回Json響應de方法，然后繼承該BaseController。如： ~~~ //BaseController.php public function json($data = null, $status = 200, $headers = [], $options = 0) { return new JsonResponse($data, $status, $headers, $options); } //YourController.php class YourController extends BaseController { public function users(UserRepository $userRepository) { return $this->json($userRepository->allUser()); } } ~~~ 然而這寫法確實挺方便，然而當你在其他地方需要使用到Json響應時（如中間件驗證失敗時你想要返回一個Json響應）。你無法使用到$this->json(...)。 2. 直接在需要用到Json響應得地方使用return new JsonResponse或者使用Response Facade。但這種做法當需要修改Response響應時得全部改動，不可取。 # Response 宏 Laravel提供了一個非常方便的響應宏來處理這一情況 首先，我們需要先注冊一個響應宏，在任意一個ServiceProvider的boot方法里（ResponseMacroServiceProvider），使用Response Facade注冊 ~~~ Response::macro('success', function ($data = [], $message = 'success') { return new JsonResponse([ 'code' => 0, 'data' => $data, 'message' => $message ], 200); }); ~~~ 接下來， 你可以再任何地方使用它response()。 ~~~ //UserController.php public function users(UserRepository $userRepository) { return response()->success($userRepository->all(), 'success'); } ~~~ 注意，你只能通過response()這個全局方法或是app('Illuminate\Routing\ResponseFactory')來使用它 ~~~ response()->success();//OK app('Illuminate\Routing\ResponseFactory')->success();//OK //Response Facade Response::success();//ok (new \Illuminate\Http\Response)->success();//Error ~~~ # 原理 我們在ServiceProvider里使用Response Facade來注冊的success宏，我們先看看Response這個Facade的正真類是什么。 ~~~ // Illuminate\Support\Facades.php protected static function getFacadeAccessor() { return 'Illuminate\Contracts\Routing\ResponseFactory'; } ~~~ 該Facade返回了一個ResponseFactory接口，那該接口的具體實列對象時什么呢。 ~~~ //Illuminate\Routing\RoutingServiceProvider.php /** * Register the response factory implementation. * * @return void */ protected function registerResponseFactory() { $this->app->singleton('Illuminate\Contracts\Routing\ResponseFactory', function ($app) { return new ResponseFactory($app['Illuminate\Contracts\View\Factory'], $app['redirect']); }); } ~~~ 可以看到，該RoutingServiceProvider注冊了一個Illuminate\Routing\ResponseFactory的實列給Response Facade。 我們在Illuminate\Routing\ResponseFactory的源碼中可以看到，它引用了一個Illuminate\Support\Traits\Macroable trait。 ~~~ namespace Illuminate\Routing; use Illuminate\Support\Traits\Macroable; class ResponseFactory implements FactoryContract { use Macroable; } ~~~ 該Trait源碼如下，看完源碼就知道為什么調用response()就能正常訪問success方法了。 ~~~ trait Macroable { protected static $macros = []; public static function macro($name, callable $macro) { static::$macros[$name] = $macro; } public static function hasMacro($name) { return isset(static::$macros[$name]); } public static function __callStatic($method, $parameters) { if (! static::hasMacro($method)) { throw new BadMethodCallException("Method {$method} does not exist."); } if (static::$macros[$method] instanceof Closure) { return call_user_func_array(Closure::bind(static::$macros[$method], null, static::class), $parameters); } return call_user_func_array(static::$macros[$method], $parameters); } public function __call($method, $parameters) { if (! static::hasMacro($method)) { throw new BadMethodCallException("Method {$method} does not exist."); } if (static::$macros[$method] instanceof Closure) { return call_user_func_array(static::$macros[$method]->bindTo($this, static::class), $parameters); } return call_user_func_array(static::$macros[$method], $parameters); } } ~~~ 其實該 trait Illuminate\Support\Traits\Macroable 在很多地方都有使用，包括 FileSystem、Database-Builder。 http://d.laravel-china.org/docs/5.4/responses#response-macros