在 Laravel 8 API 中实现多表用户认证-php教程-PHP中文网

在 Laravel 8 API 中实现多表用户认证

霞舞

发布： 2025-10-07 14:56:12

原创

736人浏览过

在 Laravel 8 API 中实现多表用户认证

本教程将指导如何在 Laravel 8 API 应用中实现多表用户认证。针对默认认证机制仅支持单一用户表的问题，我们将通过配置自定义认证守卫（Guards）和用户提供者（Providers），实现对来自不同数据表（如学生表、教师表）的用户进行灵活、安全的身份验证，确保不同用户类型的独立管理和登录流程。

理解 Laravel 认证机制

laravel 默认的认证系统主要通过 config/auth.php 文件进行配置，它由两个核心组件构成：

守卫 (Guards)：定义了用户如何被认证。例如，web 守卫使用会话（session）存储用户状态，而 api 守卫通常使用令牌（token）进行无状态认证。
提供者 (Providers)：定义了如何从持久化存储（如数据库）中检索用户数据。默认的 users 提供者通常指向 App\Models\User 模型。

当我们需要从多个数据表（例如 users、students、teachers）中认证不同类型的用户时，就需要扩展这些默认配置，为每种用户类型创建独立的守卫和提供者。

步骤一：创建并配置用户模型

首先，确保你的不同用户类型都有对应的 Eloquent 模型，并且这些模型都实现了 Illuminate\Contracts\Auth\Authenticatable 接口。对于 Laravel 8 及更高版本，你可以让你的模型继承 Illuminate\Foundation\Auth\User 类，因为它已经实现了该接口。

例如，如果你有 Student 和 Teacher 表，你需要创建对应的模型：

// app/Models/Student.php
namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens; // 如果使用 Sanctum 进行 API 认证

class Student extends Authenticatable
{
    use Notifiable, HasApiTokens; // 引入 HasApiTokens

    protected $table = 'students'; // 确保指向正确的表名

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

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

    protected $casts = [
        'email_verified_at' => 'datetime',
    ];
}

登录后复制

类似地，为 Teacher 模型进行配置。

// app/Models/Teacher.php
namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;

class Teacher extends Authenticatable
{
    use Notifiable, HasApiTokens;

    protected $table = 'teachers'; // 确保指向正确的表名

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

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

    protected $casts = [
        'email_verified_at' => 'datetime',
    ];
}

登录后复制

步骤二：配置认证守卫与提供者

接下来，修改 config/auth.php 文件，为每种用户类型定义新的提供者和守卫。

定义提供者 (Providers)：在 providers 数组中，为 students 和 teachers 添加新的提供者。

// config/auth.php

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],

    'students' => [ // 新增学生提供者
        'driver' => 'eloquent',
        'model' => App\Models\Student::class,
    ],

    'teachers' => [ // 新增教师提供者
        'driver' => 'eloquent',
        'model' => App\Models\Teacher::class,
    ],
],

登录后复制

定义守卫 (Guards)：在 guards 数组中，为每种用户类型定义一个 API 守卫。这里以 sanctum 驱动为例，如果你使用 Passport 或其他 JWT 方案，请相应调整 driver。

// config/auth.php

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],

    'api' => [ // 默认API守卫，可根据需要调整
        'driver' => 'sanctum',
        'provider' => 'users',
    ],

    'student_api' => [ // 学生API守卫
        'driver' => 'sanctum', // 或者 'token' / 'passport'
        'provider' => 'students', // 使用上面定义的学生提供者
    ],

    'teacher_api' => [ // 教师API守卫
        'driver' => 'sanctum', // 或者 'token' / 'passport'
        'provider' => 'teachers', // 使用上面定义的教师提供者
    ],
],

登录后复制

步骤三：实现认证逻辑

现在你可以在控制器中根据不同的守卫来认证用户。

示例：学生登录控制器

表单大师AI

一款基于自然语言处理技术的智能在线表单创建工具，可以帮助用户快速、高效地生成各类专业表单。

查看详情

// app/Http/Controllers/Api/StudentAuthController.php
namespace App\Http\Controllers\Api;

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

class StudentAuthController extends Controller
{
    public function login(Request $request)
    {
        $credentials = $request->validate([
            'email' => 'required|email',
            'password' => 'required',
        ]);

        // 尝试使用 'student_api' 守卫进行认证
        if (Auth::guard('student_api')->attempt($credentials)) {
            $student = Auth::guard('student_api')->user();

            // 生成 API Token (如果使用 Laravel Sanctum)
            $token = $student->createToken('student-api-token')->plainTextToken;

            return response()->json([
                'message' => 'Student logged in successfully.',
                'token' => $token,
                'student' => $student,
            ], 200);
        }

        return response()->json(['message' => 'Invalid student credentials.'], 401);
    }

    public function logout(Request $request)
    {
        // 撤销当前守卫下的所有令牌
        Auth::guard('student_api')->user()->tokens()->delete();

        return response()->json(['message' => 'Student logged out successfully.'], 200);
    }

    public function me()
    {
        // 获取当前认证的学生用户
        return response()->json(Auth::guard('student_api')->user());
    }
}

登录后复制

示例：教师登录控制器

类似地，为教师创建一个 TeacherAuthController，并使用 Auth::guard('teacher_api')->attempt($credentials) 进行认证。

步骤四：配置 API 路由

在 routes/api.php 文件中定义你的认证路由和受保护路由。

// routes/api.php

use App\Http\Controllers\Api\StudentAuthController;
use App\Http\Controllers\Api\TeacherAuthController;

// 学生认证路由
Route::post('/student/login', [StudentAuthController::class, 'login']);

// 教师认证路由
Route::post('/teacher/login', [TeacherAuthController::class, 'login']);

// 受学生守卫保护的路由
Route::middleware('auth:student_api')->group(function () {
    Route::get('/student/me', [StudentAuthController::class, 'me']);
    Route::post('/student/logout', [StudentAuthController::class, 'logout']);
    // 其他学生专属API
});

// 受教师守卫保护的路由
Route::middleware('auth:teacher_api')->group(function () {
    Route::get('/teacher/me', [TeacherAuthController::class, 'me']);
    Route::post('/teacher/logout', [TeacherAuthController::class, 'logout']);
    // 其他教师专属API
});

登录后复制

注意 auth:student_api 和 auth:teacher_api 中间件的使用，它指示 Laravel 使用特定的守卫来验证请求。

注意事项与最佳实践

API Token 管理：对于 API 认证，通常会使用 Laravel Sanctum 或 Passport 来生成和管理 API Token。确保你的用户模型（Student、Teacher）使用了 HasApiTokens trait。
密码加密：所有用户表中的密码都应该使用 Laravel 的 Hash 门面进行加密存储。
错误处理：在认证失败时，返回清晰的错误信息和适当的 HTTP 状态码（例如 401 Unauthorized）。
中间件顺序：确保 auth 中间件在其他需要用户身份信息的中间件之前运行。
跨域资源共享 (CORS)：如果你的 API 和前端应用部署在不同的域上，请正确配置 CORS。Laravel 提供了 Fruitcake\Cors\HandleCors 中间件来处理这个问题。
安全考虑：避免在响应中返回敏感的用户信息。只返回客户端需要的数据。

总结

通过为不同用户类型定义独立的认证守卫和提供者，Laravel 提供了一个强大且灵活的机制来实现多表用户认证。这种方法不仅清晰地分离了不同用户群体的认证逻辑，也使得权限管理和API访问控制更加精细化。理解并正确配置 config/auth.php 是实现这一目标的关键，结合适当的认证驱动（如 Sanctum）和路由中间件，你可以为复杂的应用构建健壮的多用户认证系统。

以上就是在 Laravel 8 API 中实现多表用户认证的详细内容，更多请关注php中文网其它相关文章！