非你网

响应格式的统一，对前端来说，是一种更好的体验。这里借鉴别人的地方，仅仅对 response 做统一格式响应。

规范的响应结构

RESTful 服务最佳实践

code—— 包含一个整数类型的 HTTP 响应状态码。
status—— 包含文本：”success”，”fail” 或”error”。HTTP 状态响应码在 500-599 之间为”fail”，在 400-499 之间为”error”，其它均为”success”（例如：响应状态码为 1XX、2XX 和 3XX）。
message—— 当状态值为”fail” 和”error” 时有效，用于显示错误信息。参照国际化（il8n）标准，它可以包含信息号或者编码，可以只包含其中一个，或者同时包含并用分隔符隔开。
data—— 包含响应的 body。当状态值为”fail” 或”error” 时，data 仅包含错误原因或异常名称。

继续阅读

写在前面

统一响应结构，的确很有用。一种是官方默认的响应返回，比如自定义的 Request 的 validate。一种是自定义结构的。想要好的体验，就得两种统一处理起来。

工作中使用 Laravel 开发 API 项目已经有些年头了，发现每次启动新的 Api 项目的时都会在 Laravel 基础上进行一些预处理，包括针对 API 项目的结构设计，统一响应结构的封装，异常的捕获处理以及授权模块的配置等。总是在做一些重复的工作，那索性将这些常用的基础封装做成一个「启动模板」好了。

项目地址：戳这儿
继续阅读