让Laravel开发Api更得心应手

php artisan make:migration create_users_table(里面内容可参考我对应的文件)

<?php

namespace App\Models; //这里从App改成了App\Models

use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use Notifiable;
    protected $table = 'users';

     //去掉我创建的数据表没有的字段
    protected $fillable = [
        'name', 'password'
    ];

     //去掉我创建的数据表没有的字段
    protected $hidden = [
        'password'
    ];
    //将密码进行加密
    public function setPasswordAttribute($value)
    {
        $this->attributes['password'] = bcrypt($value);
    }
}

protected $routeMiddleware = [
        'auth' => \App\Http\Middleware\Authenticate::class,
        'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
        'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
        'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
        'can' => \Illuminate\Auth\Middleware\Authorize::class,
        'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
        'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
        'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
        'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
        ...... //前面的中间件
        'cors'=> \Medz\Cors\Laravel\Middleware\ShouldGroup::class,
];

<?php

namespace App\Exceptions;
use App\Api\Helpers\ExceptionReport;
use Exception;
use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;

class Handler extends ExceptionHandler
{

    public function render($request, Exception $exception)
    {
        //ajax请求我们才捕捉异常
        if ($request->ajax()){
            // 将方法拦截到自己的ExceptionReport
            $reporter = ExceptionReport::make($exception);
            if ($reporter->shouldReturn()){
                return $reporter->report();
            }
            if(env('APP_DEBUG')){
                //开发环境，则显示详细错误信息
                return parent::render($request, $exception);
            }else{
                //线上环境,未知错误，则显示500
                return $reporter->prodReport();
            }
        }
        return parent::render($request, $exception);
    }
}

  <?php
  
  return [
  
      /*
      |--------------------------------------------------------------------------
      | JWT Authentication Secret
      |--------------------------------------------------------------------------
      |
      | 用于加密生成 token 的 secret
      |
      */
  
      'secret' => env('JWT_SECRET'),
  
      /*
      |--------------------------------------------------------------------------
      | JWT Authentication Keys
      |--------------------------------------------------------------------------
      |
      | 如果你在 .env 文件中定义了 JWT_SECRET 的随机字符串
      | 那么 jwt 将会使用 对称算法 来生成 token
      | 如果你没有定有，那么jwt 将会使用如下配置的公钥和私钥来生成 token
      |
      */
  
      'keys' => [
  
          /*
          |--------------------------------------------------------------------------
          | Public Key
          |--------------------------------------------------------------------------
          |
          | 公钥
          |
          */
  
          'public' => env('JWT_PUBLIC_KEY'),
  
          /*
          |--------------------------------------------------------------------------
          | Private Key
          |--------------------------------------------------------------------------
          |
          | 私钥
          |
          */
  
          'private' => env('JWT_PRIVATE_KEY'),
  
          /*
          |--------------------------------------------------------------------------
          | Passphrase
          |--------------------------------------------------------------------------
          |
          | 私钥的密码。 如果没有设置，可以为 null。
          |
          */
  
          'passphrase' => env('JWT_PASSPHRASE'),
  
      ],
  
      /*
      |--------------------------------------------------------------------------
      | JWT time to live
      |--------------------------------------------------------------------------
      |
      | 指定 access_token 有效的时间长度（以分钟为单位），默认为1小时，您也可以将其设置为空，以产生永不过期的标记
      |
      */
  
      'ttl' => env('JWT_TTL', 60),
  
      /*
      |--------------------------------------------------------------------------
      | Refresh time to live
      |--------------------------------------------------------------------------
      |
      | 指定 access_token 可刷新的时间长度（以分钟为单位）。默认的时间为 2 周。
      | 大概意思就是如果用户有一个 access_token，那么他可以带着他的 access_token 
      | 过来领取新的 access_token，直到 2 周的时间后，他便无法继续刷新了，需要重新登录。
      |
      */
  
      'refresh_ttl' => env('JWT_REFRESH_TTL', 20160),
  
      /*
      |--------------------------------------------------------------------------
      | JWT hashing algorithm
      |--------------------------------------------------------------------------
      |
      | 指定将用于对令牌进行签名的散列算法。
      |
      */
  
      'algo' => env('JWT_ALGO', 'HS256'),
  
      /*
      |--------------------------------------------------------------------------
      | Required Claims
      |--------------------------------------------------------------------------
      |
      | 指定必须存在于任何令牌中的声明。
      | 
      |
      */
  
      'required_claims' => [
          'iss',
          'iat',
          'exp',
          'nbf',
          'sub',
          'jti',
      ],
  
      /*
      |--------------------------------------------------------------------------
      | Persistent Claims
      |--------------------------------------------------------------------------
      |
      | 指定在刷新令牌时要保留的声明密钥。
      |
      */
  
      'persistent_claims' => [
          // 'foo',
          // 'bar',
      ],
  
      /*
      |--------------------------------------------------------------------------
      | Blacklist Enabled
      |--------------------------------------------------------------------------
      |
      | 为了使令牌无效，您必须启用黑名单。
      | 如果您不想或不需要此功能，请将其设置为 false。
      |
      */
  
      'blacklist_enabled' => env('JWT_BLACKLIST_ENABLED', true),
  
      /*
      | -------------------------------------------------------------------------
      | Blacklist Grace Period
      | -------------------------------------------------------------------------
      |
      | 当多个并发请求使用相同的JWT进行时，
      | 由于 access_token 的刷新 ，其中一些可能会失败
      | 以秒为单位设置请求时间以防止并发的请求失败。
      |
      */
  
      'blacklist_grace_period' => env('JWT_BLACKLIST_GRACE_PERIOD', 0),
  
      /*
      |--------------------------------------------------------------------------
      | Providers
      |--------------------------------------------------------------------------
      |
      | 指定整个包中使用的各种提供程序。
      |
      */
  
      'providers' => [
  
          /*
          |--------------------------------------------------------------------------
          | JWT Provider
          |--------------------------------------------------------------------------
          |
          | 指定用于创建和解码令牌的提供程序。
          |
          */
  
          'jwt' => Tymon\JWTAuth\Providers\JWT\Namshi::class,
  
          /*
          |--------------------------------------------------------------------------
          | Authentication Provider
          |--------------------------------------------------------------------------
          |
          | 指定用于对用户进行身份验证的提供程序。
          |
          */
  
          'auth' => Tymon\JWTAuth\Providers\Auth\Illuminate::class,
  
          /*
          |--------------------------------------------------------------------------
          | Storage Provider
          |--------------------------------------------------------------------------
          |
          | 指定用于在黑名单中存储标记的提供程序。
          |
          */
  
          'storage' => Tymon\JWTAuth\Providers\Storage\Illuminate::class,
  
      ],
  
  ];
  

  <?php
  
  namespace App\Http\Middleware\Api;
  
  use Auth;
  use Closure;
  use Tymon\JWTAuth\Exceptions\JWTException;
  use Tymon\JWTAuth\Facades\JWTAuth;
  use Tymon\JWTAuth\Http\Middleware\BaseMiddleware;
  use Tymon\JWTAuth\Exceptions\TokenExpiredException;
  use Symfony\Component\HttpKernel\Exception\UnauthorizedHttpException;
  
  // 注意，我们要继承的是 jwt 的 BaseMiddleware
  class RefreshTokenMiddleware extends BaseMiddleware
  {
      /**
       * Handle an incoming request.
       *
       * @param  \Illuminate\Http\Request $request
       * @param  \Closure $next
       *
       * @throws \Symfony\Component\HttpKernel\Exception\UnauthorizedHttpException
       *
       * @return mixed
       */
      public function handle($request, Closure $next)
      {
          // 检查此次请求中是否带有 token，如果没有则抛出异常。
          $this->checkForToken($request);
  //         使用 try 包裹，以捕捉 token 过期所抛出的 TokenExpiredException  异常
          try {
              // 检测用户的登录状态，如果正常则通过
              if ($this->auth->parseToken()->authenticate()) {
                  return $next($request);
              }
              throw new UnauthorizedHttpException('jwt-auth', '未登录');
          } catch (TokenExpiredException $exception) {
              // 此处捕获到了 token 过期所抛出的 TokenExpiredException 异常，我们在这里需要做的是刷新该用户的 token 并将它添加到响应头中
              try {
                  // 刷新用户的 token
                  $token = $this->auth->refresh();
                  // 使用一次性登录以保证此次请求的成功
                  Auth::guard('api')->onceUsingId($this->auth->manager()->getPayloadFactory()->buildClaimsCollection()->toPlainArray()['sub']);
              } catch (JWTException $exception) {
                  // 如果捕获到此异常，即代表 refresh 也过期了，用户无法刷新令牌，需要重新登录。
                  throw new UnauthorizedHttpException('jwt-auth', $exception->getMessage());
              }
          }
  
          // 在响应头中返回新的 token
          return $this->setAuthenticationHeader($next($request), $token);
      }
  }

    //用户登录
       public function login(Request $request)
       {
           $token = Auth::guard('api')->attempt(['name' => $request->name, 'password' => $request->password]);
           if ($token) {
               //如果登陆，先检查原先是否有存token，有的话先失效，然后再存入最新的token
               $user = Auth::guard('api')->user();
               if ($user['last_token']) {
                   try{
                       Auth::guard('api')->setToken($user['last_token'])->invalidate();
                   }catch (TokenExpiredException $e){
                       //因为让一个过期的token再失效，会抛出异常，所以我们捕捉异常，不需要做任何处理
                   }
               }
               $user->last_token = $token;
               $user->save();  
               return $this->setStatusCode(201)->success(['token' => 'bearer ' . $token]);
           }
           return $this->failed('账号或密码错误', 400);
       }
       

  <?php
  
  namespace App\Jobs\Api;
  
  use Illuminate\Bus\Queueable;
  use Illuminate\Queue\SerializesModels;
  use Illuminate\Queue\InteractsWithQueue;
  use Illuminate\Contracts\Queue\ShouldQueue;
  use Illuminate\Foundation\Bus\Dispatchable;
  
  class SaveLastTokenJob implements ShouldQueue
  {
      use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
      protected $model;
      protected $token;
  
      /**
       * SaveLastTokenJob constructor.
       * @param $model
       * @param $token
       */
  
      public function __construct($model,$token)
      {
          //
          $this->model=$model;
          $this->token=$token;
      }
  
      /**
       * Execute the job.
       *
       * @return void
       */
      public function handle()
      {
          $user=$this->model;
          $user->last_token=$this->token;
          $user->save();
      }
  }