响应宏是 laravel 中用于扩展 response 对象的自定义方法。1. 它们允许你封装常用的响应格式，避免代码重复；2. 通过在 appserviceprovider 的 boot 方法中使用 response::macro() 定义宏；3. 可通过 phpdoc 注释或自定义响应类为宏添加类型提示和自动补全；4. 响应宏中可使用 app() 函数、use 引入变量或依赖注入服务容器实现依赖注入；5. 使用 phpunit 编写测试用例，调用宏并断言返回响应是否符合预期。这种方式提升了代码的可维护性、可测试性和一致性。
响应宏，简单来说，就是给 Laravel 的 Response 对象增加自定义方法。为什么要这么做？因为有些响应格式或者数据处理，我们可能需要在多个地方重复使用，与其到处复制粘贴代码，不如封装成一个宏，方便又优雅。
响应宏配置其实很简单，主要就是在 AppServiceProvider 的 boot 方法里定义。
解决方案
首先，打开 app/Providers/AppServiceProvider.php 文件。
然后，在 boot 方法中，使用 Response::macro() 方法来定义你的宏。
json([
'code' => $code,
'message' => $message,
'data' => $data,
]);
});
Response::macro('error', function ($message = '操作失败', $code = 400, $data = []) {
return response()->json([
'code' => $code,
'message' => $message,
'data' => $data,
]);
});
}
}上面这段代码定义了两个宏：success 和 error。 success 用于返回成功的响应，error 用于返回失败的响应。 它们都接受一些参数，比如数据、消息和状态码，然后返回一个 JSON 格式的响应。
现在，你就可以在你的控制器或者其他地方直接使用这些宏了。
这样，你的代码就变得更加简洁易读了。而且，如果以后你需要修改响应的格式，只需要修改宏的定义，而不需要修改所有使用它的地方。
如何为响应宏添加类型提示和自动补全？
虽然 Laravel 是一个动态语言框架，但我们仍然可以利用 IDE 的特性来增强代码的可读性和可维护性。 为响应宏添加类型提示，可以帮助 IDE 更好地理解你的代码，从而提供更准确的自动补全和错误检查。
一种方法是使用 PhpDoc 注释。 在
AppServiceProvider中定义宏时，可以添加注释来描述宏的参数和返回值。Response::macro('success', /** * @param array $data * @param string $message * @param int $code * @return \Illuminate\Http\JsonResponse */ function ($data = [], $message = '操作成功', $code = 200) { return response()->json([ 'code' => $code, 'message' => $message, 'data' => $data, ]); });另一种方法是创建一个自定义的响应类，并在该类中定义这些宏。 这样做的好处是可以更好地组织你的代码，并且可以更容易地进行单元测试。
首先，创建一个新的类，比如
App\Http\Responses\ApiResponse。json([ 'code' => $code, 'message' => $message, 'data' => $data, ]); } /** * 返回失败的响应 * * @param string $message * @param int $code * @param array $data * @return \Illuminate\Http\JsonResponse */ public static function error(string $message = '操作失败', int $code = 400, array $data = []): JsonResponse { return response()->json([ 'code' => $code, 'message' => $message, 'data' => $data, ]); } }然后，在你的控制器中使用这个类。
这种方式虽然稍微复杂一些，但可以提供更好的类型提示和自动补全，并且可以更容易地进行单元测试。
如何在响应宏中使用依赖注入？
有时候，你的响应宏可能需要依赖一些其他的服务，比如日志服务或者配置服务。 这时候，你可以使用 Laravel 的依赖注入功能来将这些服务注入到你的宏中。
一种方法是使用
app()辅助函数来获取容器中的服务。Response::macro('log', function ($message) { $logger = app('log'); $logger->info($message); return response('Logged: ' . $message); });另一种方法是在宏的闭包中使用
use关键字来引入外部变量。use Illuminate\Contracts\Config\Repository as Config; Response::macro('configValue', function ($key) use ($config) { return response('Config value for ' . $key . ' is ' . $config->get($key)); }); app()->booted(function () use ($config) { Response::macro('configValue', function ($key) use ($config) { return response('Config value for ' . $key . ' is ' . $config->get($key)); }); });但更优雅的方式是使用服务容器来解析你的宏。 这需要你先定义一个类，并在该类中定义你的宏。
config = $config; } public function registerMacros() { Response::macro('configValue', function ($key) { return response('Config value for ' . $key . ' is ' . $this->config->get($key)); }); } }然后，在
AppServiceProvider中，将这个类注册到服务容器中，并在boot方法中调用registerMacros方法。app->singleton(ResponseService::class, function ($app) { return new ResponseService($app['config']); }); } /** * Bootstrap any application services. * * @return void */ public function boot() { $responseService = $this->app->make(ResponseService::class); $responseService->registerMacros(); } }这样，你就可以在你的宏中使用依赖注入了。 这种方式更加灵活和可测试，并且可以更好地组织你的代码。
如何测试响应宏？
测试响应宏其实很简单，你可以直接调用宏，然后断言返回的响应是否符合你的预期。
'John Doe']; $response = Response::success($data, '测试成功'); $response->assertStatus(200); $response->assertJson([ 'code' => 200, 'message' => '测试成功', 'data' => $data, ]); } /** * Test the error macro. * * @return void */ public function testErrorMacro() { $response = Response::error('测试失败', 400); $response->assertStatus(200); // 注意这里，因为 Response::error 返回的是 JsonResponse，所以状态码是 200 $response->assertJson([ 'code' => 400, 'message' => '测试失败', 'data' => [], ]); } }在这个例子中，我们定义了两个测试用例，分别测试
success和error宏。 我们调用宏，然后使用assertStatus和assertJson方法来断言返回的响应是否符合我们的预期。如果你使用了自定义的响应类，那么你可以直接测试这个类的方法。
'John Doe']; $response = ApiResponse::success($data, 'Success message'); $this->assertEquals(200, $response->getStatusCode()); $this->assertEquals(json_encode([ 'code' => 200, 'message' => 'Success message', 'data' => $data, ]), $response->getContent()); } public function testError() { $response = ApiResponse::error('Error message', 400); $this->assertEquals(200, $response->getStatusCode()); $this->assertEquals(json_encode([ 'code' => 400, 'message' => 'Error message', 'data' => [], ]), $response->getContent()); } }总之，测试响应宏的关键是确保你能够正确地调用宏，并断言返回的响应是否符合你的预期。
