本文實例講述了Laravel框架實現修改登錄和注冊接口數據返回格式的方法。分享給大家供大家參考,具體如下:
1、背景:需要將所有的數據返回格式統一成retCode/retMsg/data
2、登陸接口:
文件目錄:app/Http/Controllers/Auth/LoginController
先寫登陸接口是因為修改登錄接口比注冊接口要簡單許多
登錄接口中的第一句
可以進去修改登錄驗證內容(默認是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調用Gin接口調用formData上傳文件的實現方法
- laravel 錯誤處理,接口錯誤返回json代碼
- 在Laravel中使用GuzzleHttp調用第三方服務的API接口代碼
- laravel實現一個上傳圖片的接口,并建立軟鏈接,訪問圖片的方法
- Laravel5.4簡單實現app接口Api Token認證方法
- Laravel統一封裝接口返回狀態實例講解