laravel-responder

laravel-responder

优化Laravel和Lumen的API响应生成器,支持Fractal数据转换

此包支持通过Fractal transformers转换数据,生成和序列化成功与错误响应,处理例外情况,并辅助响应测试。兼容PHP 7.0+及Laravel 5.1+或Lumen 5.1+,可通过Composer安装,提供多种响应创建方法,包括服务注入、helper函数和facade。提供高质量响应并配备详尽文档,便于开发者快速上手。

Laravel ResponderAPI响应FractalLaravel数据转换Github开源项目

项目介绍:Laravel Responder

Laravel Responder 是一个用于构建 API 响应的插件,旨在将 Fractal 集成到 Laravel 和 Lumen 中。它可以使用转换器对数据进行转换,创建和序列化成功或错误响应,处理异常,并帮助您测试响应。

为什么选择 Laravel Responder?

在 Laravel 中,可以直接从控制器方法返回模型以将其转换为 JSON,这是一种快速构建 API 的方式,但容易暴露数据库列。Fractal,通过引入转换器解决了这个问题,但整合到框架中可能有些麻烦。Laravel Responder 提供了更简洁的方式,使代码更加优雅:

例如,将常见的数据库返回简化为:

public function index() { return responder()->success(User::all())->respond(); }

这样,不仅可以保持代码的整洁性,还可以充分利用 Fractal 的强大功能,同时藏在精美的抽象后面。

系统要求

  • PHP 7.0 或更高版本
  • Laravel 5.1 或更高版本或 Lumen 5.1 或更高版本

安装

通过 Composer 安装:

composer require flugger/laravel-responder

如果你使用的是 Laravel 5.5 或更高版本,包会自动发现,无需手动注册服务提供者和门面。

使用

创建响应

你可以使用 Responder 服务类中的 successerror 方法来构建成功或错误响应。在控制器方法中,直接注入 Responder 服务类即可:

public function index(Responder $responder) { return $responder->success(); }

你也可以使用 responder 辅助函数:

return responder()->success();

创建成功响应

可使用 success 方法为响应设置数据,支持不同类型的数据,包括查询构建器实例:

return responder()->success(Product::all())->respond();

创建转换器

转换器类提供了一个转换数据的便利之地,并允许你在多个地方重用转换器。可以通过 Artisan 命令创建转换器:

php artisan make:transformer ProductTransformer

创建错误响应

当 API 消费者执行意外操作时,可以返回描述问题的错误响应:

return responder()->error('sold_out_error', 'The requested product is sold out.')->respond();

处理异常

为了提高用户体验,Laravel Responder 提供了处理异常的能力。替换或使用包的异常处理器,异常将自动转化为错误响应。

贡献与支持

任何贡献都非常欢迎,可以在 Github 上创建拉取请求。如果您发现漏洞或有改进建议,也可以提交问题。

捐赠

这个包是免费使用的,但如果您想表示感谢,可以通过 PayPal 捐赠支持包的开发。

授权

Laravel Responder 是在 MIT 许可下发布的免费软件。

编辑推荐精选

扣子-AI办公

扣子-AI办公

职场AI,就用扣子

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

堆友

堆友

多风格AI绘画神器

堆友平台由阿里巴巴设计团队创建,作为一款AI驱动的设计工具,专为设计师提供一站式增长服务。功能覆盖海量3D素材、AI绘画、实时渲染以及专业抠图,显著提升设计品质和效率。平台不仅提供工具,还是一个促进创意交流和个人发展的空间,界面友好,适合所有级别的设计师和创意工作者。

图像生成AI工具AI反应堆AI工具箱AI绘画GOAI艺术字堆友相机AI图像热门
码上飞

码上飞

零代码AI应用开发平台

零代码AI应用开发平台,用户只需一句话简单描述需求,AI能自动生成小程序、APP或H5网页应用,无需编写代码。

Vora

Vora

免费创建高清无水印Sora视频

Vora是一个免费创建高清无水印Sora视频的AI工具

Refly.AI

Refly.AI

最适合小白的AI自动化工作流平台

无需编码,轻松生成可复用、可变现的AI自动化工作流

酷表ChatExcel

酷表ChatExcel

大模型驱动的Excel数据处理工具

基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。

AI工具酷表ChatExcelAI智能客服AI营销产品使用教程
TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
AIWritePaper论文写作

AIWritePaper论文写作

AI论文写作指导平台

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

AI辅助写作AI工具AI论文工具论文写作智能生成大纲数据安全AI助手热门
博思AIPPT

博思AIPPT

AI一键生成PPT,就用博思AIPPT!

博思AIPPT,新一代的AI生成PPT平台,支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等,内置海量精美PPT模板,涵盖商务、教育、科技等不同风格,同时针对每个页面提供多种版式,一键自适应切换,完美适配各种办公场景。

AI办公办公工具AI工具博思AIPPTAI生成PPT智能排版海量精品模板AI创作热门
潮际好麦

潮际好麦

AI赋能电商视觉革命,一站式智能商拍平台

潮际好麦深耕服装行业,是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌,以及国内10万+淘宝、天猫、京东等主流平台的品牌商家,为卖家节省将近85%的出图成本,提升约3倍出图效率,让品牌能够快速上架。

下拉加载更多