3. laravel 5.5 多子域名 + dingo + jwt 简单环境搭建

环境介绍

　　laravel 5.5.* + php 7.2 + mysql 5.7.27

1. 创建 laravel 项目 (自行配置一下域名如果不会请参考 laravel 的第一篇文章 )

　　composer create-project --prefer-dist laravel/laravel=5.5.* laravel-dj

2. 引入 dingo 并进行部分配置 (dingo 文档)

　　更改 compose.json 的 require 文件

"require": {
    "php": ">=7.0.0",
    "dingo/api": "2.1.0",
    "fideloper/proxy": "~3.3",
    "laravel/framework": "5.5.*",
    "laravel/tinker": "~1.0"
}

　　使用 compose update 进行更新

　　　　composer update

　　发布 dingo

　　　　php artisan vendor:publish --provider="Dingo\Api\Provider\LaravelServiceProvider"

　　添加部分配置到 .env 文件

API_PREFIX=/
API_STANDARDS_TREE=vnd
API_SUBTYPE=dj
API_VERSION=v1
API_NAME="dj API"
API_CONDITIONAL_REQUEST=false
API_STRICT=false
API_DEFAULT_FORMAT=json
API_DEBUG=true

3. 配置先后台接口分离 (例如 laravel-dj.com/admin 和 laravel-dj.com/front )

　　# 如果想配置 node1.larave-dj.com 和 node2.laravel-dj.com 接口访问请参考多域名使用

　　修改 RouteServiceProvider 的 map function

public function map()
    {
//        $this->mapApiRoutes();
        $this->mapFrontApiRoutes();
        $this->mapAdminApiRoutes();
        $this->mapWebRoutes();
    }

　　添加 mapFrontApiRoutes 方法和 mapAdminApiRoutes

protected function mapFrontApiRoutes()
{
    app('Dingo\Api\Routing\Router')->group([
        'version' => 'v1',
        'prefix' => 'front',
        'middleware' => 'api',
        'namespace' => 'App\Http\Controllers\Api\Front',
    ], function ($api) {
        require base_path('routes/api/front.php');
    });
}

protected function mapAdminApiRoutes()
{
    app('Dingo\Api\Routing\Router')->group([
        'version' => 'v1',
        'prefix' => 'admin',
        'middleware' => 'api',
        'namespace' => 'App\Http\Controllers\Api\Admin',
    ], function ($api) {
        require base_path('routes/api/admin.php');
    });
}

　　根据配置文件创建 Admin 下的 UserController 和 Front 下的 UserController 以及路由文件 routes/api/front.php 和 routes/api/admin.php

　　　　php artisan make:controller Api/Admin/UserController --resource

　　　　php artisan make:controller Api/Front/UserController --resource

　　并在 Api\Admin\UserController show 方法内写入 dd('admin' . $id);

　　　　Api\Front\UserController show 方法内写入 dd('front' . $id);

　　在 routes 下创建 api 文件夹

　　　　创建 front.php 和 admin.php 并进行部分路由写入

　　#front.php

<?php
$api = app('Dingo\Api\Routing\Router');
$api->group([],
    function ($api) {
        $api->get('/', function(){ return 'this is front';});
        $api->get('users/{id}', 'UserController@show');
    }
);

　　#admin.php

<?php
$api = app('Dingo\Api\Routing\Router');
$api->group([],
    function ($api) {
        $api->get('/', function(){ return 'this is admin';});
        $api->get('users/{id}', 'UserController@show');
    }
);

访问 laravel-dj.com/admin 和 laravel-dj.com/front

访问 laravel-dj.com/admin/users/1 和 laravel-dj.com/front/users/1

4. 使用 transfromer 格式化接口数据　( transform文档 )

　　migrate 一下 laravel 自带的 user 表 (需要配置一下 .env 和 mysql )

　　　　php artisan migrate

　　手动写入 3 条数据　到 user 表

　　admin 的 UserController 下引入 dingo 的 Helpers

　　在 app 下创建 Transformers 文件夹， Transformers下创建 Admin 文件夹并编写 UserTransform.php

#UserTransform.php

<?php
namespace App\Transformers\Admin;
use App\User;
use League\Fractal\TransformerAbstract;
class UserTransform extends TransformerAbstract
{
    public function transform(User $user)
    {
        return [
            'id'          => $user->id,
            'name'        => $user->name,
            'email'       => $user->email,
            ];
    }
}

　　更改 admin 下的 UserController 内的 show 方法

　　　　验证 item 方法

public function show($id)
{
    $user = User::find($id);
    return $this->response->item($user, new UserTransform());
}

　　　访问 laravel-dj.com/admin/users/1

　　　　验证 paginator 方法

public function show($id)
{
    $users = User::paginate(1);
    return $this->response->paginator($users, new UserTransform());
}

　　　访问 laravel-dj.com/admin/users/1

验证 collection 方法

public function show($id)
{
    $users = User::all();
    return $this->response->colletion($users, new UserTransform());
}

　　　　访问 laravel-dj.com/admin/users/1

5. 使用 jwt 进行访问限制 (请参考具体安装 )

　　安装 jwt 的包

　　　　composer require tymon/jwt-auth:1.0.0-rc.4.1

　　在 config/app.php 下添加 provider

'providers' => [
...
Tymon\JWTAuth\Providers\LaravelServiceProvider::class,
]

　　发布 jwt 配置文件

php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\LaravelServiceProvider"

　　修改 config/auth.php

#auth.php

return [
    'defaults' => [
        'guard' => 'admin',
        'passwords' => 'users',
    ],
    'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],

        'admin' => [
            'driver' => 'jwt',
            'provider' => 'users',
        ],
    ],
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\User::class,
        ],
    ],
    'passwords' => [
        'users' => [
            'provider' => 'users',
            'table' => 'password_resets',
            'expire' => 60,
        ],
    ],
];

　　修改 App\User 让是让 User 支持 jwt 用户认证

<?php

namespace App;

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

class User extends Authenticatable implements JWTSubject
{
    use Notifiable;
    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = [
        'name', 'email', 'password',
    ];
    /**
     * The attributes that should be hidden for arrays.
     *
     * @var array
     */
    protected $hidden = [
        'password', 'remember_token',
    ];
    public function getJWTIdentifier()
    {
        return $this->getKey();
    }
    /**
     * Return a key value array, containing any custom claims to be added to the JWT.
     *
     * @return array
     */
    public function getJWTCustomClaims()
    {
        return [];
    }
}

　　在 admin 下的 UserController 下的 show 方法内手动登陆并编写 respondWithToken 方法返回 token

public function show($id)
{
    $user = User::find($id);
    $token = auth('users')->fromUser($user);
    return $this->respondWithToken($token);
}

protected function respondWithToken($token)
{
    return response()->json([
        'access_token' => $token,
        'token_type' => 'bearer',
        'expires_in' => auth('users')->factory()->getTTL() * 60
    ]);
}

　　访问 laravel-dj.com/admin/users/1 获取 token

　　修改 routes/api/admin.php 使用 jwt 进行访问限制

#admin.php

<?php
$api = app('Dingo\Api\Routing\Router');
$api->group(
    [
    ],
    function ($api) {
        $api->get('best', function(){ return 'admin best';});
        $api->get('users/{id}', 'UserController@show');
        $api->group([
            'middleware' => ['jwt.auth']
        ], function ($api){
            $api->get('users',function(){
                return auth()->user()->toArray();
            });
        });
    }
);

　　访问 laravel-dj.com/admin