在laravel中dingo的功能是什么,怎么使用
Admin 2022-06-16 群英技术资讯 527 次浏览
在laravel中,dingo是针对laravel、lumen框架的api开发工具包;主要有路由版本管理、“Http Exception”异常处理和“Response Transform”转化响应格式三个功能。
本文操作环境:Windows10系统、Laravel6版、Dell G3电脑。
dingo是针对laravel、lumen框架的api开发工具包。
粗看文档目录,基于api规范,它围绕了三个主要功能:
路由版本管理
Http Exception 异常处理
Response Transform 转化响应格式
dingoapi是一个laravel的开源插件,可以在github上搜索到,现在在做一个项目,项目中总是会有后端跟前端的json数据交互,而这个dingoapi为json交互提供了很大的便利。
路由版本控制
一、相关配置
1声明api服务
api规范要求,接口开发要么带api前缀(http://XXX.com/api/xxx),要么是子域名(http://api.XXX.com/xxx),通过这样的标识,代表请求的是api接口服务。
所以,API_PREFIX=api和API_DOMAIN=api.myapp.com须设置其中一个。
.env可能需要配置的选项
当然它的作用并非只是个标识,我们知道dingo的路由与laravel的路由是共存的,dingo便是通过这个特征来判断的。
2版本控制
dingo提供了自己的路由服务,如果http://XXX.com/api/xxx或http://api.XXX.com/xxx访问,它则认为是api请求,dingo路由服务Dingo\Api\Routing\Router会接管laravel自带的路由服务Illuminate\Routing\Router(至于是如何接管的,之后再说),它同样有get(),post(),match(),group()…方法,相当于另一套路由体系。
laravel区分版本的话,可能需要带上一个v1前缀,例如http://XXX.com/api/v1或者http://XXX.com/api/v2。而dingo是通过 header头Accept处理的。它的格式是Accept: application/vnd.YOUR_SUBTYPE.v1+json。意味着你需要发送一个accept的请求头才能访问。
配置文件中,默认这种模式是不强制的,API_STRICT=false,但只能访问配置文件中默认的版本,'version' => env('API_VERSION', 'v1'),。
如果设置为true,即开启严格模式,则必须发送accept头,不能通过浏览器直接访问你的 API。
.env可能需要配置的选项
API_STRICT=true //开启严格模式必须不论v1,v2都须带上accept头信息
API_VERSION=v1 //在没有声明版本号时的默认版本号
若开启严格模式
关于header头的accept属性几个选项:
Accept: application/vnd.YOUR_SUBTYPE.v1+json
API_STANDARDS_TREE=x,prs,vnd Standards Tree 标准树
API_SUBTYPE=myapp 子类型:程序或项目的短名称
v1:版本号
json:返回的格式,也可以为jsonp
.env可能需要配置的选项
API_STANDARDS_TREE=prs
API_SUBTYPE=lara
API_DEFAULT_FORMAT=json //默认
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:mmqy2019@163.com进行举报,并提供相关证据,查实之后,将立刻删除涉嫌侵权内容。
猜你喜欢
PHP echo的用法是什么,简单的应用是怎样的?下文的讲解详细,步骤过程清晰,对大家进一步学习和理解有一定的帮助。有这方面学习需要的朋友就继续往下看吧!
如何理解PHP访问控制,有哪些知识点?下文有详解方法和实例,内容详细,逻辑清晰,有需要的朋友可以参考,希望大家阅读完这篇文章后能有所收获,那么下面就一起来了解一下吧。
很多新手对于任务调度不是很清楚,简单介绍一下,任务调度指的是根据一定的约束规定,将CPU分配给符合条件的任务使用。这篇文章给大家分享的是关于PHP实现协程任务调度的实例,感兴趣的朋友可以了解一下。
在学习Laravel框架的时候,我们会接触到Laravel的数据库迁移,也叫做Migrations,很多新手对于为什么要数据库迁移以及好处不是很了解,对此,这篇文章就给大家介绍一下Migrations。
用于生产环境中的PHP需要对其进行优化,让PHP自身发挥更好的性能,除了写好PHP代码,还要配置好php-fpm以及php.ini调优。本文从内存、OPcache、上传、会话以及安全等方面讲解php.ini的配置调优。
成为群英会员,开启智能安全云计算之旅
立即注册Copyright © QY Network Company Ltd. All Rights Reserved. 2003-2020 群英 版权所有
增值电信经营许可证 : B1.B2-20140078 粤ICP备09006778号 域名注册商资质 粤 D3.1-20240008