萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Laravel 5.2 實現前後台用戶認證分離完整教程

需求背景

Laravel 預設單一認證機制,實際專案常需前台會員與後台管理員完全隔離:不同資料表、不同登入頁、不同權限邏輯。本文詳細說明 Laravel 5.2 多 Guard 實作前後台認證分離的完整步驟。

步驟 1:前台認證(預設)

php artisan make:auth
php artisan migrate

生成 users、password_resets 表,路由自動註冊在 web middleware 群組。

步驟 2:配置多 Guard(config/auth.php)

return [
    'defaults' => [
        'guard' => 'web',
        'passwords' => 'users',
    ],
    'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        'admin' => [          // 新增:後台 Guard
            'driver' => 'session',
            'provider' => 'admins',
        ],
        'api' => [
            'driver' => 'token',
            'provider' => 'users',
        ],
    ],
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\User::class,
        ],
        'admins' => [       // 新增:後台 Provider
            'driver' => 'eloquent',
            'model' => App\Admin::class,
        ],
    ],
    'passwords' => [
        'users' => [
            'provider' => 'users',
            'email' => 'auth.emails.password',
            'table' => 'password_resets',
            'expire' => 60,
        ],
        // 如需後台獨立重設密碼,可新增 admins 區塊
    ],
];

步驟 3:建立 Admin 模型與遷移

php artisan make:model Admin --migration

修改遷移檔複製 users 表結構,執行 php artisan migrate 生成 admins 表。

步驟 4:定義後台路由群組

Route::group(['prefix' => 'admin', 'middleware' => 'admin'], function () {
    Route::get('login', 'Admin\AuthController@getLogin');
    Route::post('login', 'Admin\AuthController@postLogin');
    Route::get('register', 'Admin\AuthController@getRegister');
    Route::post('register', 'Admin\AuthController@postRegister');
    Route::get('logout', 'Admin\AuthController@logout');
    Route::get('/', 'Admin\AdminController@index');
});

關鍵點:middleware => 'admin' 會自動套用 auth:admin 中介層(見下文)。

步驟 5:建立控制器

Admin/AuthController.php

<?php
namespace App\Http\Controllers\Admin;

use App\Admin;
use Validator;
use App\Http\Controllers\Controller;
use Illuminate\Foundation\Auth\ThrottlesLogins;
use Illuminate\Foundation\Auth\AuthenticatesAndRegistersUsers;

class AuthController extends Controller
{
    use AuthenticatesAndRegistersUsers, ThrottlesLogins;

    protected $redirectTo = '/admin';
    protected $guard = 'admin';              // 指定 Guard
    protected $loginView = 'admin.login';    // 後台登入視圖
    protected $registerView = 'admin.register';

    public function __construct()
    {
        $this->middleware('guest:admin', ['except' => 'logout']); // 關鍵:guest:admin
    }

    protected function validator(array $data)
    {
        return Validator::make($data, [
            'name' => 'required|max:255',
            'email' => 'required|email|max:255|unique:admins', // 驗證 admins 表
            'password' => 'required|confirmed|min:6',
        ]);
    }

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

Admin/AdminController.php

<?php
namespace App\Http\Controllers\Admin;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use Auth;

class AdminController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth:admin'); // 關鍵:auth:admin
    }

    public function index()
    {
        $admin = Auth::guard('admin')->user();
        return view('admin.home');
    }
}

步驟 6:建立後台視圖

  • 複製 resources/views/auth 至 resources/views/admin
  • 修改表單 action 加上 admin/ 前綴
  • 調整 layouts/app.blade.php 使用 Auth::guard('admin') 判斷登入狀態

導航欄範例

@if (Auth::guard('admin')->guest())
    <a href="{{ url('admin/login') }}">Login</a>
    <a href="{{ url('admin/register') }}">Register</a>
@else
    <a href="#" class="dropdown-toggle">{{ Auth::guard('admin')->user()->name }}</a>
    <a href="{{ url('admin/logout') }}">Logout</a>
@endif

步驟 7:解決重導向問題

若未登入訪問後台頁面導向錯誤,修改 app/Http/Middleware/Authenticate.php:

return redirect()->guest($guard . '/login');

確保 admin guard 導向 /admin/login。

驗證測試

  1. 訪問 /login → 前台登入(users 表)
  2. 訪問 /admin/login → 後台登入(admins 表)
  3. 兩者 Session 完全隔離,互不干擾
copyright © 萬盛學電腦網 all rights reserved