Laravel框架实现修改登录和注册接口数据返回格式的方法

1、背景：需要将所有的数据返回格式统一成retCode/retMsg/data

2、登陆接口：

文件目录：app/Http/Controllers/Auth/LoginController

先写登陆接口是因为修改登录接口比注册接口要简单许多

登录接口中的第一句

use AuthenticatesUsers;

可以进去修改登录验证内容(默认是email+password登录)，可以修改

validateLogin()

或者直接修改

username()

，将email改成name，即可用name+password登录了

修改登录接口数据返回格式

login()

方法

public function login(Request $request)
{
$this->validateLogin($request);
if ($this->attemptLogin($request)) {
$user = $this->guard()->user();
$user->generateToken();
$ret=new RetObject();
$ret->retCode="0000";
$ret->retMsg='success';
$ret->data= $user->toArray();
}else{
$ret=new RetObject();
$ret->retCode="0001";
$ret->retMsg='failed';
$ret->data= null;
}
return response()->json($ret);
}

直接修改login方法中的返回内容就可以了

3、注册接口

一开始我都不知道register的接口到底是藏在哪

然后看routes/api.php里的

Route::post('register', 'Auth\RegisterController@register');

这里register接口指向的是RegisterController中的 register方法

但是在RegisterController没有找到register方法，只有registered、validator、create这几个方法

真正的register方法在第一句的

use RegistersUsers;
RegistersUsers的register
public function register(Request $request)
{
$this->validator($request->all())->validate();
event(new Registered($user = $this->create($request->all())));
$this->guard()->login($user);
return $this->registered($request, $user)
?: redirect($this->redirectPath());
}

这里用到了RegisterController  中的registered、validator、create这几个方法

成功的情况下，修改数据返回格式比较简单

直接在RegisterController中的

registered()

方法中修改

protected function registered(Request $request,$user)
{
$user->generateToken();
$ret=new RetObject();
$ret->retCode="0000";
$ret->retMsg='register success';
$ret->data= $user->toArray();
return response()->json($ret);
}

然后在哪里捕捉异常然后失败的时候修改数据返回格式，捣鼓了好久。

一开始尝试直接在RegisterController中的

registered()

方法中使用

try/catch

捕捉异常信息，但是每次Debug都不会跳进来，直接在更底层验证的时候就直接输出报错信息了。

try{
$user->generateToken();
$ret=new RetObject();
$ret->retCode="0000";
$ret->retMsg='register success';
$ret->data= $user->toArray();
return response()->json($ret);
}catch (Exception $exception){
$ret=new RetObject();
$ret->retCode="0001";
$ret->retMsg='register failed';
$ret->data= null;
return response()->json($ret);
}

最终在app/Exception/Handler.php中

report方法是用来将异常写入日志，render是用来渲染各种异常的浏览器输出

所以我们应该是在render中修改捕捉到异常之后返回数据的格式

public function render($request, Exception $exception)
{
// This will replace our 404 response with
// a JSON response.
if ($exception instanceof ModelNotFoundException &&
$request->wantsJson())
{
$ret=new RetObject();
$ret->retCode="404";
$ret->retMsg='页面未找到';
$ret->data= null;
return response()->json($ret);
}elseif ($exception instanceof ValidationException)
{
$ret=new RetObject();
$ret->retCode="0001";
$ret->retMsg=$exception->getMessage();
$ret->data= null;
return response()->json($ret);
}
return parent::render($request, $exception);
}

然后起码是可以自定义捕捉到验证数据异常

ValidationException

时候的返回数据格式了，还有其他的异常也是可以直接在Handler.php的

render

方法中添加。

补充一下Handler的异常处理的控制器基类：目录为vendor/laravel/framework/src/Illuminate/Foundation/Exception/Handler.php

中的report和render方法

public function report(Exception $e)
{
if ($this->shouldntReport($e)) {
return;
}
try {
$logger = $this->container->make(LoggerInterface::class);
} catch (Exception $ex) {
throw $e; // throw the original exception
}
$logger->error($e);
}
public function render($request, Exception $e)
{
$e = $this->prepareException($e);
if ($e instanceof HttpResponseException) {
return $e->getResponse();
} elseif ($e instanceof AuthenticationException) {
return $this->unauthenticated($request, $e);
} elseif ($e instanceof ValidationException) {
return $this->convertValidationExceptionToResponse($e, $request);
}
return $this->prepareResponse($request, $e);
}

更多关于Laravel相关内容感兴趣的读者可查看本站专题：《Laravel框架入门与进阶教程》、《php优秀开发框架总结》、《php面向对象程序设计入门教程》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》

希望本文所述对大家基于Laravel框架的PHP程序设计有所帮助。

您可能感兴趣的文章:

• Laravel实现用户注册和登录
• Laravel 5.4重新登录实现跳转到登录前页面的原理和方法
• Laravel重写用户登录简单示例
• laravel5.2实现区分前后台用户登录的方法
• 基于Laravel5.4实现多字段登录功能方法示例
• Laravel中注册Facades的步骤详解
• 示例详解Laravel的注册重构
• Laravel实现短信注册的示例代码
• 基于laravel制作APP接口（API）
• Laravel 5.5中为响应请求提供的可响应接口详解
• 基于Laravel Auth自定义接口API用户认证的实现方法