Laravel框架实现修改登录和注册接口数据返回格式的方法
本文实例讲述了Laravel框架实现修改登录和注册接口数据返回格式的方法。分享给大家供大家参考,具体如下:
1、背景:需要将所有的数据返回格式统一成retCode/retMsg/data
2、登陆接口:
文件目录:app/Http/Controllers/Auth/LoginController
先写登陆接口是因为修改登录接口比注册接口要简单许多
登录接口中的第一句
useAuthenticatesUsers;
可以进去修改登录验证内容(默认是email+password登录),可以修改
validateLogin()或者直接修改username(),将email改成name,即可用name+password登录了
修改登录接口数据返回格式login()方法
publicfunctionlogin(Request$request) { $this->validateLogin($request); if($this->attemptLogin($request)){ $user=$this->guard()->user(); $user->generateToken(); $ret=newRetObject(); $ret->retCode="0000"; $ret->retMsg='success'; $ret->data=$user->toArray(); }else{ $ret=newRetObject(); $ret->retCode="0001"; $ret->retMsg='failed'; $ret->data=null; } returnresponse()->json($ret); }
直接修改login方法中的返回内容就可以了
3、注册接口
一开始我都不知道register的接口到底是藏在哪
然后看routes/api.php里的
Route::post('register','Auth\RegisterController@register');
这里register接口指向的是RegisterController中的register方法
但是在RegisterController没有找到register方法,只有registered、validator、create这几个方法
真正的register方法在第一句的
useRegistersUsers; RegistersUsers的register publicfunctionregister(Request$request) { $this->validator($request->all())->validate(); event(newRegistered($user=$this->create($request->all()))); $this->guard()->login($user); return$this->registered($request,$user) ?:redirect($this->redirectPath()); }
这里用到了RegisterController 中的registered、validator、create这几个方法
成功的情况下,修改数据返回格式比较简单
直接在RegisterController中的registered()方法中修改
protectedfunctionregistered(Request$request,$user) { $user->generateToken(); $ret=newRetObject(); $ret->retCode="0000"; $ret->retMsg='registersuccess'; $ret->data=$user->toArray(); returnresponse()->json($ret); }
然后在哪里捕捉异常然后失败的时候修改数据返回格式,捣鼓了好久。
一开始尝试直接在RegisterController中的registered()方法中使用try/catch捕捉异常信息,但是每次Debug都不会跳进来,直接在更底层验证的时候就直接输出报错信息了。
try{ $user->generateToken(); $ret=newRetObject(); $ret->retCode="0000"; $ret->retMsg='registersuccess'; $ret->data=$user->toArray(); returnresponse()->json($ret); }catch(Exception$exception){ $ret=newRetObject(); $ret->retCode="0001"; $ret->retMsg='registerfailed'; $ret->data=null; returnresponse()->json($ret); }
最终在app/Exception/Handler.php中
report方法是用来将异常写入日志,render是用来渲染各种异常的浏览器输出
所以我们应该是在render中修改捕捉到异常之后返回数据的格式
publicfunctionrender($request,Exception$exception) { //Thiswillreplaceour404responsewith //aJSONresponse. if($exceptioninstanceofModelNotFoundException&& $request->wantsJson()) { $ret=newRetObject(); $ret->retCode="404"; $ret->retMsg='页面未找到'; $ret->data=null; returnresponse()->json($ret); }elseif($exceptioninstanceofValidationException) { $ret=newRetObject(); $ret->retCode="0001"; $ret->retMsg=$exception->getMessage(); $ret->data=null; returnresponse()->json($ret); } returnparent::render($request,$exception); }
然后起码是可以自定义捕捉到验证数据异常ValidationException时候的返回数据格式了,还有其他的异常也是可以直接在Handler.php的render方法中添加。
补充一下Handler的异常处理的控制器基类:目录为vendor/laravel/framework/src/Illuminate/Foundation/Exception/Handler.php
中的report和render方法
publicfunctionreport(Exception$e) { if($this->shouldntReport($e)){ return; } try{ $logger=$this->container->make(LoggerInterface::class); }catch(Exception$ex){ throw$e;//throwtheoriginalexception } $logger->error($e); } publicfunctionrender($request,Exception$e) { $e=$this->prepareException($e); if($einstanceofHttpResponseException){ return$e->getResponse(); }elseif($einstanceofAuthenticationException){ return$this->unauthenticated($request,$e); }elseif($einstanceofValidationException){ return$this->convertValidationExceptionToResponse($e,$request); } return$this->prepareResponse($request,$e); }
更多关于Laravel相关内容感兴趣的读者可查看本站专题:《Laravel框架入门与进阶教程》、《php优秀开发框架总结》、《php面向对象程序设计入门教程》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》
希望本文所述对大家基于Laravel框架的PHP程序设计有所帮助。