Laravel 5.5+ Dingo +Jwt 快速搭建 API系统

1，安装Dingo

（1）首先更改composer.json里面的内容，将此代码放入

"require":{
        "dingo/api": "1.0.0-beta8"
},
"minimum-stability":"dev",

（2）执行安装

composer update

2，安装jwt

composer require tymon/jwt-auth:dev-develop --prefer-source

3，配置

（1）config/app.config

"providers"=>[
    ...
    Dingo\Api\Provider\LaravelServiceProvider::class,
    Tymon\JWTAuth\Providers\LaravelServiceProvider::class,
],

'aliases' => [
    ...
    'JWTAuth' => Tymon\JWTAuth\Facades\JWTAuth::class，
    'JWTFactory' => Tymon\JWTAuth\Facades\JWTFactory::class
]

（2）发布配置文件

php artisan vendor:publish --provider="Dingo\Api\Provider\LaravelServiceProvider"  //生成 api.php
php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\LaravelServiceProvider"  //生成 jwt.php

或者
php artisan vendoer:publish 
选择编号即可发布

（3）生成 JWT_SECRET 写入.env

php artisan jwt:secret  

（4）config/api.php

'auth' => [
    'jwt' => Dingo\Api\Auth\Provider\JWT::class
]

（5）在 .env 中，把 dingo 配置在最后

API_STANDARDS_TREE=vnd // 环境
API_SUBTYPE=myapp // 子类型
API_PREFIX=api // 前缀
API_DOMAIN=api.myapp.com //子域名  （前缀和子域名只能存在一个）可选
API_VERSION=v1 // 版本
API_NAME=My API // 名字（使用API Blueprint命令才会用到）
API_CONDITIONAL_REQUEST=false // 带条件的请求
API_STRICT=false // Strict模式
API_DEFAULT_FORMAT=json // 响应格式
API_DEBUG=true // 调试模式

上面的配置不是都是必要的，可根据实际情况进行选择（上面配置时参考网络配置）,如：

API_STANDARDS_TREE=prs   /vnd
API_SUBTYPE=laravelapi
API_PREFIX=api
API_VERSION=v1
API_DEBUG=false
API_DEFAULT_FORMAT=json

（6）在routers/api.php中新建内容，两个路径分别是注册和登录：

$api = app('Dingo\Api\Routing\Router');

$api->version('v1', function($api) {
    $api->post('login', 'App\Http\Api\Auth\LoginController@login');
    $api->post('register', 'App\Http\Api\Auth\RegisterController@register');
    $api->group(['middleware'=>'jwt.api.auth'],function($api){
        $api->get('logout','App\Http\Api\Auth\LoginController@logout');
        $api->get('user', 'App\Http\Api\UsersController@index');
        $api->get('refresh','App\Http\Api\Auth\RefreshController@refresh');
    });
});

$api->version('v2', function($api) {
    $api->get('version', function() {
        return response('this is version v2');
    });
});

生成Controller

php artisan make:controller App\Http\Api\Auth\LoginController
php artisan make:controller App\Http\Api\Auth\RegisterController
php artisan make:controller App\Http\Api\Auth\RefreshController

（7）创建数据认证模板，并使用数据迁移

php artisan make:model User -m   //生成user 模型的同时，创建数据迁移
单独生成迁移文件
php artisan make:migration create_users_table

修改内容

public function up()
{
    Schema::create('users', function (Blueprint $table) {
        $table->increments('id');
        $table->string('name')->unique();
        $table->string('email')->unique();
        $table->string('password');
        $table->rememberToken();
        $table->timestamps();
    });
}

生成表

php artisan migrate

（8）编辑验证模板Model/Users.php

<?php

namespace App\Model;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Tymon\JWTAuth\Contracts\JWTSubject;
use Illuminate\Foundation\Auth\User as Authenticatable;

class Users extends Authenticatable implements JWTSubject 
{
    use Notifiable;

    protected $fillable = ['name','email','password'];

    protected $hidden = ['password','remember_token'];

    public function getJWTIdentifier(){
        return $this->getKey();
    }

    public function getJWTCustomClaims(){
        return [];
    }
}

（9）注册 RegisterController.php

<?php

namespace App\Http\Api\Auth;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use App\User;
use Dingo\Api\Routing\Helpers;
use Illuminate\Foundation\Auth\RegistersUsers;
use Illuminate\Support\Facades\Validator;
use Tymon\JWTAuth\Facades\JWTAuth;

class RegisterController extends Controller
{
    use RegistersUsers;
    use Helpers;
    public function register(Request $request)
    {
        $validator = $this->validator($request->all());
        if ($validator->fails()) {
            throw new StoreResourceFailedException("Validation Error", $validator->errors());
        }
        $user = $this->create($request->all());

        if ($user->save()) {

            $token = JWTAuth::fromUser($user);

            return $this->response->array([
                "token" => $token,
                "message" => "注册成功",
                "status_code" => 201,
            ]);
        } else {
            return $this->response->error("User Not Found...", 404);
        }
    }
    public function validator($data)
    {
        return Validator::make($data,[
            'name'=>'required|unique:users|max:10',
            'email'=>'required|unique:users|email',
            'password'=>'required|min:6']);
    }
    public function sendFailResponse($message)
    {
        return $this->response->error($message,400);
    }

    protected function create(array $data) {
        return User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'password' => bcrypt($data['password']),
        ]);
    }
}

（10）登录 LoginController.php

<?php

namespace App\Http\Api\Auth;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use Illuminate\Support\Facades\Hash;
use Symfony\Component\HttpKernel\Exception\UnauthorizedHttpException;
use Tymon\JWTAuth\Facades\JWTAuth;
use App\User;
use Dingo\Api\Routing\Helpers;
use Illuminate\Foundation\Auth\AuthenticatesUsers;

class LoginController extends Controller
{
    use AuthenticatesUsers;
    use Helpers;
    public function login(Request $request)
    {
        $user=User::where('name',$request->email)->orwhere('email',$request->email)->firstOrFail();
        if($user && Hash::check($request->password,$user->password)){
            $token=JWTAuth::fromuser($user);    //获取token
            $this->clearLoginAttempts($request);  //清除登录次数
            return $this->response->array([
                'token'=>$token,
                'message'=>"Login Success",
                'status_code'=>200
            ]);
        }
        else{
            throw new UnauthorizedHttpException("Login Failed");
        }
    }
    public function logout(){
        JWTAuth::invalidate(JWTAuth::getToken());    //token加入黑名单(注销)
        $this->guard()->logout();
    }

}

（11）刷新LoginController.php

<?php

namespace App\Http\Api\Auth;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use Tymon\JWTAuth\Facades\JWTAuth;
use Dingo\Api\Routing\Helpers;
use Illuminate\Foundation\Auth\AuthenticatesUsers;

class RefreshController extends Controller
{
    use AuthenticatesUsers;
    use Helpers;
    public function refresh(Request $request)
    {
        $old_token=JWTAuth::gettoken();    //获取过期token
        $new_token=JWTAuth::refresh($old_token);    //刷新token并返回
        JWTAuth::invalidate($old_token);    //销毁过期token
        return $this->response->array([
            'token'=>$new_token,
            'status_code'=>201
        ]);
    }
}

4，每次请求需要加 Header

Authorization ：Bearer + token