实例详解thinkphp6搭建后端api接口

本篇文章给大家带来了关于thinkPHP的相关知识,其中主要介绍了搭建后端api接口的相关问题,主要内容有下载tp6、隐藏入口文件、解决跨域问题等等,希望对大家有帮助。 1、下载t...

本篇文章给大家带来了关于thinkPHP的相关知识,其中主要介绍了搭建后端api接口的相关问题,主要内容有下载tp6、隐藏入口文件、解决跨域问题等等,希望对大家有帮助。

实例详解thinkphp6搭建后端api接口插图1

1、下载tp6

我使用的是集成环境phpstuday,安装了composer,通过composer安装tp6,thinkphp官网已经不再支持直接下载。

composercreate-projecttopthink/thinktp6

你也可以直接按照tp6看云文档的步骤来安装tp6

在下载好的tp6目录通过cmd命令窗口输入

phpthinkrun

在浏览器中输入127.0.0.1:8000,访问到如下页面就安装成功了

实例详解thinkphp6搭建后端api接口插图3

2、打开错误调试

在开始之间,我们先打开tp6的错误调试

1、找到config/app.php下的show_error_msg ,改成true

实例详解thinkphp6搭建后端api接口插图5

2、找到下面根目录下的.example.env文件,重命名此文件,把.example删掉

实例详解thinkphp6搭建后端api接口插图7

查看这里面的代码,会发现,它打开了app_debug调试

实例详解thinkphp6搭建后端api接口插图9

这样我们就能看到完整的报错信息了,例如:

实例详解thinkphp6搭建后端api接口插图11

3、隐藏入口文件

在第1节中,我们访问

http://127.0.0.1:8000

实际访问的是

http://127.0.0.1:8000/index.php/index/index

你也可以通过这样的方式访问

http://127.0.0.1:8000/index/index

如果什么都不填,默认访问的就是index控制器,在config/app.php文件中有这样的定义,你也可以修改默认的控制器

实例详解thinkphp6搭建后端api接口插图13

还有,不管访问任何控制器,如果没有填方法,它都会访问控制器中的index方法,如果index方法不存在,则提示错误信息-方法不存在。

通过在项目根目录中运行的php think run开启的web服务,tp6帮我们做了隐藏入口文件的操作,所以你可以通过第三种方式访问。但是我们这一节要说的就是隐藏入口,怎么能用tp6自带的web服务呢。所以要自己来。

我们在开发时,往往会在本地搭建WNMP等这样的一套web解决方案,这就需要我们自己去隐藏入口文件index.php

为什么要隐藏入口文件?

因为像这样子http://127.0.0.1:4321/index.php/index/index访问方法,这个index.php很不好看。

多余。

危险

我这里因为用的集成环境,选用的是apache服务器,所以我只找了apache的隐藏入口文件的方法,nginx的需要自己搜索了。

现在我启用apache服务器,开的端口是4321

实例详解thinkphp6搭建后端api接口插图15

当我想通过

http://127.0.0.1:4321/index/index

去访问方法时,访问失败

实例详解thinkphp6搭建后端api接口插图17

而我加上入口文件访问时,访问成功

http://127.0.0.1:4321/index.php/index/index

实例详解thinkphp6搭建后端api接口插图19

实现隐藏index.php很简单,只需要找到public目录下的.htaccess文件,添加如下代码就可以了。

<IfModulemod_rewrite.c>#如果mode_rewrite.c模块存在则执行以下命令Options+FollowSymlinks-MultiviewsRewriteEngineOn#开启rewriteEngine#!-d不是目录或目录不存在RewriteCond%{REQUEST_FILENAME}!-d#!-f不是文件或文件不存在RewriteCond%{REQUEST_FILENAME}!-fRewriteRule^(.*)$index.php[QSA,PT,L]#参数解释#^(.*)$:匹配所有的路口映射#QSA:(QueryStringAppending)表示保留参数入get传值?xxx==xx;#PT:把这个URL交给Apache处理;#L:作为最后一条,遇到这条将不再匹配这条之后的规则</IfModule>

现在访问

http://127.0.0.1:4321/index/index

访问成功

实例详解thinkphp6搭建后端api接口插图21

需要注意,在第一节中我们看到,运行了php think run 后,我们的项目目录访问的是public目录

实例详解thinkphp6搭建后端api接口插图23

官方文档中也说在项目中应该只有public目录是可以被外界访问的,所以如果有什么需要访问的图片、视频等资源,应该放在此目录下

4、解决跨域问题

在应用开发中,前后端都是分开独立开发的,而前后端通常都会自己搭建一个web服务,运行在不同的端口上,在前端访问后端的接口时,会报跨域的错误。而这种跨域问题通常是要有后端来处理的,tp6有专门的中间件来做这个事情,真是太方便了,只需要在app目录下的middleware.php中添加该中间件,就实现了跨域访问。

<?php//全局中间件定义文件return[//全局请求缓存//\think\middleware\CheckRequestCache::class,//多语言加载//\think\middleware\LoadLangPack::class,//Session初始化//\think\middleware\SessionInit::class//跨域解决\think\middleware\AllowCrossDomain::class,];5、路由解决api版本控制

在app目录中的container控制器中新建两个文件夹v1,v2,在其中都创建User.php文件

实例详解thinkphp6搭建后端api接口插图25

v1/User.php

<?phpnamespaceapp\controller\v1;useapp\BaseController;classUserextendsBaseController{publicfunctionlogin(){return'我是v1';}}

v2/User.php

<?phpnamespaceapp\controller\v2;useapp\BaseController;classUserextendsBaseController{publicfunctionlogin(){return'我是v2';}}

注意上面两个文件的命名空间,就第一行代码,在哪个文件夹下,就写到哪里。

现在方法有了,我们还无法访问,需要使用路由,让路由帮我们找对应的方法。

至于路由的概念去文档自己看。我这里主要用路由组的方式,我觉得这个比资源路由好用,灵活。

在根目录下的route目录下的app.php文件代码如下:

<?php//+----------------------------------------------------------------------//|ThinkPHP[WECANDOITJUSTTHINK]//+----------------------------------------------------------------------//|Copyright(c)2006~2018http://thinkphp.cnAllrightsreserved.//+----------------------------------------------------------------------//|Licensed(http://www.apache.org/licenses/LICENSE-2.0)//+----------------------------------------------------------------------//|Author:liu21st<liu21st@gmail.com>//+----------------------------------------------------------------------usethink\facade\Route;//api版本控制$v=request()->header('Api-Version');//默认api版本为v1if($v==null)$v="v1";//用户Route::group('user',function(){Route::post('login','login');})->prefix($v.'.user/')->pattern(['id'=>'\d+']);

以上代码进行控制api版本的方式是,请求发起者在header中传递要访问的api的版本,这里获取到对应的版本,访问对应的方法。

鉴于以上我使用的是post请求,且要传递header,所以使用postman进行测试。

访问v1版本的接口时:

实例详解thinkphp6搭建后端api接口插图27

访问v12版本的接口时:

实例详解thinkphp6搭建后端api接口插图29

6、jwt token验证

我用的是tp6看云文档收录的插件

composerrequirethans/tp-jwt-auth

该插件的github地址-文档

在开始之前可以看看文档里是怎么操作的,我也是按照文档来的

安装完成后,该插件所在的位置在根目录下的vendor/thans/tp-jwt-auth

还会在根目录下的config目录下生成jwt.php文件来记录一些配置信息

实例详解thinkphp6搭建后端api接口插图31

看这里都是读取的env中的参数,所以咱也在根目录下的.env文件中配置参数。

在根目录下打开cmd窗口,执行

phpthinkjwt:create

会帮你在.env文件中生成密钥secret,红色框中的是新增的内容

实例详解thinkphp6搭建后端api接口插图33

token的有效期为60秒,为了方便我们测试,我就不改了,如果你要改,可以在.env中添加,这样就改成了1小时

实例详解thinkphp6搭建后端api接口插图35

这个插件有三种方式【header,token,param】传递token,我就使用其中一个,也是最常用的一种,就是在【header】中传递token信息,这个插件默认验证header中的token信息需要传递的参数名为authorization,而在header中直接传递该参数tp6是获取不到的,需要做一些设置,在根目录中的public目录下的.htacccess文件中添加

SetEnvIf Authorization .+ HTTP_AUTHORIZATION=$0

实例详解thinkphp6搭建后端api接口插图37

那么现在开始测试:

(1).生成token

我就在之前创建的v1/User.php控制器中写了

<?phpnamespaceapp\controller\v1;useapp\BaseController;//引入jwt插件usethans\jwt\facade\JWTAuth;classUserextendsBaseController{publicfunctionlogin(){//生成token$token=JWTAuth::builder(['uid'=>1,'name'=>'ceshi']);return$token;}}

在postman中测试

实例详解thinkphp6搭建后端api接口插图39

(2).验证token

我使用的是路由中间件的方式验证token,

写一个中间件

在根目录下的app目录中创建middleware目录,在其下创建CheckToken.php文件 app/middleware/CheckToken.php

实例详解thinkphp6搭建后端api接口插图41

文件内容

<?phpnamespaceapp\middleware;usethans\jwt\facade\JWTAuth;usethans\jwt\exception\JWTException;classCheckToken{publicfunctionhandle($request,\Closure$next){//OPTIONS请求直接返回if($request->isOptions()){returnresponse();}try{JWTAuth::auth();}catch(JWTException$e){returnjson($e->getMessage());}return$next($request);}}

起别名

给该中间件起个别名,在根目录下的config/middleware.php文件中

实例详解thinkphp6搭建后端api接口插图43

在路由文件中使用中间件

实例详解thinkphp6搭建后端api接口插图45

创建对应的方法

在第三步中我们创建了一个getUserInfo()方法,现在在User.php文件中创建

publicfunctiongetUserInfo(){returnjson(['id'=>1,'name'=>'啦啦啦']);}

实例详解thinkphp6搭建后端api接口插图47

验证一下

刚刚创建的token必然过期了,咱重新获取一条

实例详解thinkphp6搭建后端api接口插图49

现在验证一下,请求userinfo方法,并在header中添加参数Authorization,

注意:token值需要加上bearer ,bearer后的空格也要的。

实例详解thinkphp6搭建后端api接口插图51

过了一分钟后,我们再来试一试

实例详解thinkphp6搭建后端api接口插图53

可以看到token验证提示,该通过过期了,这个插件成功了,并没有继续往下走,把之前的信息返回。

(3).注销token

这个插件在github中的文档中没有说到怎么注销或删除token,只有一个刷新refresh和拉黑invalidate,我看了一下它的代码,刷新方法中会调用拉黑方法,看到这个注释,让我激动了一下,鸡儿!原来拉黑就是注销

实例详解thinkphp6搭建后端api接口插图55

这个拉黑的具体操作就是把你要注销的token保存在本地的cookie中,默认的保存时间是14天,14天后cookie会自己删除的,你可以在根目录下的runtime目录下的cache目录中找到对应的文件,我就不测试这个方法了,我感觉这个操作好像没什么必要。

文件内容形似这样

实例详解thinkphp6搭建后端api接口插图57

至此token这节就结束了。

什么?

你想改默认的token名称?那你可得好好研究这个插件了,看看怎么改,改完了记得踢我一脚,让我也看看,虽然我觉得一个Authorization已经够用了。

实例详解thinkphp6搭建后端api接口插图59

7、统一的参数返回形式

实际开发中,后端返回给前端的参数往往都是这样的。

实例详解thinkphp6搭建后端api接口插图61

所以我们需要对参数返回形式做个统一的处理

在app目录下的common.php中定义的方法全局都可调用,所以在这个文件中定义此方法。

<?phpusethink\Response;//应用公共文件//统一返回数据格式functionresult($data=[],string$msg='error',int$code=200,string$type='json'):Response{$result=["code"=>$code,"msg"=>$msg,"data"=>$data];//调用Response的create方法,指定code可以改变请求的返回状态码returnResponse::create($result,$type)->code($code);}

唉,这个时候,经验的重要性就体现出来,我是个前端,而且在我自己看来,还算是个没有工作经验的前端,

不知道他们后端到底怎么处理这个状态码,网上的东西越看越乱,状态码可以分为业务状态码和请求返回的状态码,我这里就简单了,就只有请求返回的状态码,虽然在返回的数据中也传递了这个码,其实没什么用,小项目、不复杂的项目根本用不少业务状态码。

我看别人还会单独分装成功和失败的方法,这个就看自己习惯了,我感觉好像没啥必要。

终究是经验不足,网上能参考的代码太少,还千篇一律,最可气的是一篇文章居然可以在多个博客网站上出现,别人抄的、复制的就算了,作者自己也发这么多地方,真的搞笑,百度一下,跳出来全是同一个,标题也是一样,很迷~。

调用就很简单了,可以直接使用

我们还是改一下login方法

publicfunctionlogin(){$data=[['id'=>1,'name'=>'杰森'],['id'=>2,'name'=>'麦克']];$code=200;$msg='获取成功';returnresult($data,$msg,$code);}

实例详解thinkphp6搭建后端api接口插图63

返回结果

实例详解thinkphp6搭建后端api接口插图65

这样好像没有体现我们修改的请求的状态码,那我们把$code改成500,再来看看结果如何

实例详解thinkphp6搭建后端api接口插图67

咱已经成功的将改请求状态变成了500

得嘞,现在再来回头看看我们之前写的检查jwt的中间件,把返回的结果封装一下

实例详解thinkphp6搭建后端api接口插图69

再去验证一下看看,看着返回的结果就舒服多了,这特么才是后端给前端返回的结果。

实例详解thinkphp6搭建后端api接口插图71

本小节结束,记录一下一些常见的状态码,我在自己写的时候就只用到了这些状态码

状态码描述200请求成功204请求成功,未返回实体,比如option请求,这玩意儿用不着呀400错误的请求401认证失败,这个一般在token验证那里403拒绝访问404请求的资源不存在422参数验证错误500服务器错误

7、异常捕捉

异常捕捉(看云文档)内容挺多的,自己去百度吧,我就把我遇到过的常见的错误进行捕捉,其它的异常我也爱莫能助,不懂啊 !>_>!

我也就不自定义类了,直接在它给的默认的异常处理文件里写了。

实例详解thinkphp6搭建后端api接口插图73

(1)参数验证错误捕捉

我们先写一个参数验证的类,在app目录下创建validate目录,创建User.php文件

实例详解thinkphp6搭建后端api接口插图75

app/validate/User.php

<?phpnamespaceapp\validate;usethink\Validate;classUserextendsValidate{protected$rule=['name'=>'require|max:25','age'=>'number|between:1,120','email'=>'email',];protected$message=['name.require'=>'名称必须','name.max'=>'名称最多不能超过25个字符','age.number'=>'年龄必须是数字','age.between'=>'年龄只能在1-120之间','email'=>'邮箱格式错误',];}

tp6的异常捕捉分为两种,自动和手动的,手动的就是通过try{}catch{}捕捉。tp6的异常捕捉大多是自动的,不过,比如我们现在要操作的参数验证错误就需要自己去捕捉来抛出异常,我们此节的目的是统一捕捉这个错误,我就不用手动的了。

我们就在异常处理类的render方法中添加这个捕捉抛出就可以了。

实例详解thinkphp6搭建后端api接口插图77

//1.参数验证错误if($einstanceofValidateException){returnresult($e->getError(),'参数验证不通过',422);}

现在在方法中一下,看看能否捕获。

app/controller/v1/User.php

实例详解thinkphp6搭建后端api接口插图79

查看结果,成功被捕获到了,并抛出了错误内容

实例详解thinkphp6搭建后端api接口插图81

如果验证通过了,就会正常的走下去,则会显示我return的测试内容

实例详解thinkphp6搭建后端api接口插图83

(2)未匹配到资源或方法的异常捕获

我还没找到方法,在我的预想中这个应该要做到能够准确的反应未匹配到的原因。

//2.方法(控制器、路由、http请求)、资源(多媒体文件,如视频、文件)未匹配到,//一旦在定义的路由规则中匹配不到,它就会直接去匹配控制器,但是因为在控制器中做了版本控制v1,v2这样的,所以它是无法获取对应控制器的//所以都会直接走了HttpException的错误//感觉好像也无所谓,反正是做api接口的,只不过这样就不好准确的提示信息了//到底这个请求时控制器找不到呢?还是方法找不到?还是请求类型(get,post)不对?if(($einstanceofClassNotFoundException||$einstanceofRouteNotFoundException)||($einstanceofHttpException&&$e->getStatusCode()==404)){$data=['err_msg'=>$e->getMessage(),'tips_1'=>'请检查路径是否是否填写正确','tips_2'=>'请检查请求类型是否正确',];returnresult($data,'方法或资源未找到,请检查',404);}

下面就不写了,太麻烦了,直接放全部代码

<?phpnamespaceapp;useParseError;//语法错误useTypeError;useInvalidArgumentException;//参数错误usethink\db\exception\DataNotFoundException;usethink\db\exception\ModelNotFoundException;usethink\db\exception\PDOException;//数据库连接错误usethink\db\exception\DbException;//数据库模型访问错误,比如方法不存在usethink\exception\RouteNotFoundException;usethink\exception\ClassNotFoundException;usethink\exception\FuncNotFoundException;usethink\exception\FileException;usethink\exception\Handle;usethink\exception\HttpException;usethink\exception\HttpResponseException;usethink\exception\ValidateException;usethink\exception\ErrorException;usethink\Response;useThrowable;/***应用异常处理类*/classExceptionHandleextendsHandle{/***不需要记录信息(日志)的异常类列表*@vararray*/protected$ignoreReport=[HttpException::class,HttpResponseException::class,ModelNotFoundException::class,DataNotFoundException::class,ValidateException::class,];/***记录异常信息(包括日志或者其它方式记录)**@accesspublic*@paramThrowable$exception*@returnvoid*/publicfunctionreport(Throwable$exception):void{//使用内置的方式记录异常日志parent::report($exception);}/***RenderanexceptionintoanHTTPresponse.**@accesspublic*@param\think\Request$request*@paramThrowable$e*@returnResponse*/publicfunctionrender($request,Throwable$e):Response{//添加自定义异常处理机制//请求异常if($einstanceofHttpException&&$request->isAjax()){returnresponse($e->getMessage(),$e->getStatusCode());}//使用了错误的数据类型或缺失参数if($einstanceofInvalidArgumentException||$einstanceofErrorException){$fileUrlArr=explode(DIRECTORY_SEPARATOR,$e->getFile());$data=['err_msg'=>$e->getMessage(),'file'=>$fileUrlArr[count($fileUrlArr)-1],'line'=>$e->getLine()];returnresult($data,'参数错误',413);}//1.参数验证错误if($einstanceofValidateException){returnresult($e->getError(),'参数验证不通过',422);}//2.方法(控制器、路由、http请求)、资源(多媒体文件,如视频、文件)未匹配到,//一旦在定义的路由规则中匹配不到,它就会直接去匹配控制器,但是因为在控制器中做了版本控制v1,v2这样的,所以它是无法获取对应控制器的//所以都会直接走了HttpException的错误//感觉好像也无所谓,反正是做api接口的,只不过这样就不好准确的提示信息了//到底这个请求时控制器找不到呢?还是方法找不到?还是请求类型(get,post)不对?if(($einstanceofClassNotFoundException||$einstanceofRouteNotFoundException)||($einstanceofHttpException&&$e->getStatusCode()==404)){$data=['err_msg'=>$e->getMessage(),'tip_1'=>'请检查路径是否是否填写正确','tips_2'=>'请检查请求类型是否正确',];returnresult($data,'方法或资源未找到,请检查',404);}//3.语法错误if($einstanceofParseError){$fileUrlArr=explode(DIRECTORY_SEPARATOR,$e->getFile());$data=['err_msg'=>$e->getMessage(),'file'=>$fileUrlArr[count($fileUrlArr)-1],'line'=>$e->getLine()];returnresult($data,'服务器异常-语法错误',411);}//4.数据库错误if($einstanceofPDOException||$einstanceofDbException){$fileUrlArr=explode(DIRECTORY_SEPARATOR,$e->getFile());$data=['err_msg'=>$e->getMessage(),'file'=>$fileUrlArr[count($fileUrlArr)-1],'line'=>$e->getLine()];returnresult($data,'服务器异常-数据库错误',412);}//其他错误交给系统处理returnparent::render($request,$e);}}

本节结束,这里面用的错误处理都是我在平常练习中遇到的错误,至于其他的没有处理是因为我还没碰到,碰到再说吧。为了给前端好的反馈,我们应该处理所有的异常的返回形式,不然,tp6默认返回页面形式的,前端等于得不到相应了。至于这个自定义异常捕获,应该有相应的插件的吧,你要是感兴趣可以去找找。

7、自动生成api文档

之前我还很好奇,后端是怎么搞出接口文档的,都是自己录入数据套模板的吗?原来他么的都是插件做的,真他么方便!!!

(1)安装插件

composerrequirehg/apidoc//文档//https://hgthecode.github.io/thinkphp-apidoc/guide/install/

你就照着插件的文档来就好了,不用跟着我。

(2)下载对应的前端页面

下载最新的,放在public目录下

实例详解thinkphp6搭建后端api接口插图85

(3)使用

具体配置你还得看文档,我就直接照着最简单的做了,我就试一个,将app/controller/v1/User.php写了注释,它会读注释生成接口文档

引入注释

app/controller/v1/User.php

<?phpnamespaceapp\controller\v1;useapp\BaseController;//添加这句,注释写法为@Apidoc\参数名(...)usehg\apidoc\annotationasApidoc;/***@Apidoc\Title("V1")*@Apidoc\Group("base")*/classUserextendsBaseController{/***@Apidoc\Title("登录")*@Apidoc\Url("v1.user/login")*@Apidoc\Tag("测试基础")*@Apidoc\Param("username",type="string",require=true,desc="用户名")*@Apidoc\Param("password",type="string",require=true,desc="密码")*@Apidoc\Returned("id",type="int",desc="新增用户的id")*/publicfunctionlogin(){returnresult(null,'成功',200);}}

查看效果

实例详解thinkphp6搭建后端api接口插图87

这个接口文档这里有点小问题,因为我们前面使用在header中添加api版本的方式控制请求的api版本,所以如果直接用/user/login是无法访问到控制器的,也就访问不到方法,必须得加上控制器所在位置的信息,就在前面加上了v1,变成了v1.user/login。这种形式是通过控制器去访问的方法,显然不理想,我想要达到的目标是不需要再里面加上v1,这个还得好好研究研究,不然前面定义的路由不是跟这个接口文档对不上了吗?你们要是研究到了,记得踢我一脚哈 >_>!

#后记:当时只是练习一下我,我也没深究,but其实这个apidoc它的官方文档里有设置项的,关于这个多应用/多版本的配置项,去apidoc的文档去看吧,在config/apidoc.php修改apps的配置就可以了,然后就可以通过右上角的选择框切换版本了

//设置应用/版本(必须设置)'apps'=>[['title'=>'演示示例','path'=>'app','folder'=>'controller','items'=>[['title'=>'V1.0','path'=>'app\controller\v1','folder'=>'v1'],['title'=>'V2.0','path'=>'app\controller\v2','folder'=>'v2']]],],总结

一个简单的后端接口这样应该就够用了,以我之前做过的学校的课程设计的经验来说的哈。我没有用过别的后端语言,不过就现在感觉,php真好用,不亏是世界上最好的语言。

产品猿社区致力收录更多优质的商业产品,给服务商以及软件采购客户提供更多优质的软件产品,帮助开发者变现来实现多方共赢;

日常运营的过程中我们难免会遇到各种版权纠纷等问题,如果您在社区内发现有您的产品未经您授权而被用户提供下载或使用,您可按照我们投诉流程处理,点我投诉

本文来自用户发布投稿,不代表产品猿立场 ;若对此文有疑问或内容有严重错误,可联系平台客服反馈;

部分产品是用户投稿,可能本文没有提供官方下下载地址或教程,若您看到的内容没有下载入口,您可以在我们产品园商城搜索看开发者是否有发布商品;若您是开发者,也诚邀您入驻商城平台发布的产品,地址:点我进入

如若转载,请注明出处:http://www.chanpinyuan.cn/33608.html;
(0)
上一篇 2023年1月19日 下午4:16
下一篇 2023年1月19日 下午4:17

相关推荐

发表回复

登录后才能评论
分享本页
返回顶部