用一个罕见的技巧在 Laravel 中优雅地响应不同的响应

拥抱 Laravel 中响应的隐秘力量

在 API 开发的领域中，娴熟地驾驭响应至关重大。然而，传统上，我们常常求助于笨拙的手段，例如使用生硬的整数来表示微妙的响应细微差别。

考虑下述这个司空见惯的场景：API 处理过程中，当特定状况触发时，我们需要向调用方传达一个特定的响应码。

public function store(Request $request)
{
  // 业务逻辑

  return response()->json([
    'message': '数据已保存',
  ], 201);
}

乍看之下，此种方法似乎无伤大雅。但深层探究，我们就会发觉其局限性。首先，它有悖于 Laravel 倡导的整洁编码准则。其次，它为日后的调试和可读性埋下了隐患。

揭开 ApiResponse 的面纱

庆幸的是，Laravel 为我们送上了一份厚礼——응답 类。此类可谓 Laravel 响应系统的基石，它巧妙地将响应码封装在更具性的异常之中。

要领略其魅力，我们只需将上述响应重写为：

public function store(Request $request)
{
  // 业务逻辑

  return $this->created($request);
}

简洁明了，是不是？created 方法内置于 응답 类中，它会自动将 201 响应码连同响应数据一并送出。

响应码大盘点

응답 类囊括了全方位的响应码，涵盖了从最常见的 200（“OK”）到 500（“内部服务器出错”）等所有场景。

方法	响应码
created	201	资源已建立
accepted	202	请求已接受，但尚未响应
noContent	204	请求已受理，无内容可供响应
badRequest	400	请求语法有误，服务器拒绝
unauthorized	401	请求未经身份验证或鉴权
forbidden	403	请求禁止
notFound	404	请求资源未找到
internalServerError	500	服务器遇到意外状况，导致其未能响应

进阶用法

응답 类还允许我们自定响应码和响应数据。例如，要将一条特定信息连同 404 响应码一并送出，我们可以这样做：

return $this->notFound('资源已遭遗弃，请移步别处');

结论

在 Laravel 中，응답 类为我们提供了管理响应的优雅而强有力的方法。告别生硬的整数，拥抱描述性的异常，让我们的 API 响应更上一层楼。