README

此包允许您创建管理员用户（不同于应用程序的用户）。它使用自定义守卫，并包含Laravel认证视图：登录、注册、密码重置等。在构建无需重新构建所有内容的受保护区域（例如控制台）时特别有用。

安装和设置

在全新的Laravel (>= v5.4) 安装上，通过运行以下命令来安装包：

composer require helori/laravel-admin

配置您的应用程序（Laravel版本 < 5.5）

// config/app.php
'providers' => [
    ...
    Helori\LaravelAdmin\AdminServiceProvider::class,
];

设置守卫、提供者和密码重置选项以处理管理员认证

// config/auth.php
'guards' => [
    ...
    'admin' => [
        'driver' => 'session',
        'provider' => 'admins',
    ],
],
'providers' => [
    ...
    'admins' => [
        'driver' => 'eloquent',
        'model' => Helori\LaravelAdmin\Models\Admin::class,
    ]
],
'passwords' => [
    ...
    'admins' => [
        'provider' => 'admins',
        'table' => 'admins_resets',
        'expire' => 60,
    ],
],

配置抛出认证异常时的重定向

// app/Exceptions/Handler.php
use Illuminate\Auth\AuthenticationException;
...
protected function unauthenticated($request, AuthenticationException $exception)
{
    if ($request->expectsJson()) {
        return response()->json(['error' => 'Unauthenticated.'], 401);
    }

    $guard = array_get($exception->guards(), 0);
    if($guard === 'admin'){
        return redirect()->guest(route('admin-login'));
    }else{
        return redirect()->guest(route('login'));
    }
}

配置管理员已认证时的重定向

// app/Middleware/RedirectIfAuthenticated.php
public function handle($request, Closure $next, $guard = null)
{
    if (Auth::guard($guard)->check()) {
        if($guard === 'admin'){
            return redirect()->route('admin-home');
        }else{
            return redirect('/');
        }
    }

    return $next($request);
}

运行迁移

php artisan migrate

创建第一个管理员以便能够第一次登录

php artisan tinker
$admin = new \Helori\LaravelAdmin\Models\Admin
$admin->name = 'John'
$admin->email = 'john@domain.com'
$admin->password = bcrypt('john_password')
$admin->save()
exit

发布laravel-admin默认资产

php artisan vendor:publish --tag=laravel-admin-assets

安装包的前端依赖项

npm install jquery@3.* bootstrap@4.* --save-dev

编辑您的laravel mix配置文件

// webpack.mix.js
mix.sass(
    "./resources/assets/sass/admin.scss",
    "./public/css/admin.css"
).js(
    "./resources/assets/js/admin.js",
    "./public/js/admin.js", "."
);

编译您的资产

npm run dev

您的管理员认证应该在以下位置可用：

http://your-domain.test/admin/login

开始创建受保护的视图

// routes/web.php
...
Route::group(['prefix' => 'admin', 'middleware' => 'auth:admin'], function ()
{
    Route::get('/', function(){
        return view('your-admin-home');
    });
    ...
});