Laravel权限控制模块搭建

在Laravel中搭建权限控制模块通常涉及以下几个步骤：

1. 安装Laravel

确保你已经安装了Laravel框架。如果没有安装，可以参考Laravel官方文档进行安装。

2. 创建一个新的Laravel项目

如果你还没有一个Laravel项目，可以使用Composer创建一个新的项目：

composer create-project --prefer-dist laravel/laravel my-project
cd my-project

3. 安装Laravel UI和Passport（可选）

为了简化权限控制，可以使用Laravel UI和Passport来快速设置用户认证和授权。

composer require laravel/ui passport --dev

然后运行迁移：

php artisan ui bootstrap --auth
php artisan migrate

4. 创建权限和角色模型

你可以使用Laravel的Eloquent ORM来创建权限和角色模型。例如，创建一个Role模型和一个Permission模型，并在它们之间建立多对多关系。

php artisan make:model Role -m
php artisan make:model Permission -m

在生成的迁移文件中定义表结构：

database/migrations/xxxx_xx_xx_xxxxxx_create_roles_table.php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateRolesTable extends Migration
{
    public function up()
    {
        Schema::create('roles', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('display_name')->nullable();
            $table->string('description')->nullable();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('roles');
    }
}

database/migrations/xxxx_xx_xx_xxxxxx_create_permissions_table.php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreatePermissionsTable extends Migration
{
    public function up()
    {
        Schema::create('permissions', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('display_name')->nullable();
            $table->string('description')->nullable();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('permissions');
    }
}

在Role模型中定义关系：

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

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Spatie\Permission\Traits\HasRoles;

class Role extends Model
{
    use HasFactory, HasRoles;

    // ...
}

在Permission模型中定义关系：

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

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Spatie\Permission\Traits\HasRoles;

class Permission extends Model
{
    use HasFactory, HasRoles;

    // ...
}

5. 创建中间件

创建一个中间件来检查用户是否具有特定权限：

php artisan make:middleware CheckPermission

在生成的中间件文件中定义逻辑：

// app/Http/Middleware/CheckPermission.php
namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class CheckPermission
{
    public function handle(Request $request, Closure $next, $permission)
    {
        if (auth()->guest() || !$request->user()->can($permission)) {
            abort(403, 'Unauthorized action.');
        }

        return $next($request);
    }
}

6. 注册中间件

在app/Http/Kernel.php中注册中间件：

protected $routeMiddleware = [
    // ...
    'permission' => \App\Http\Middleware\CheckPermission::class,
];

7. 在路由中使用中间件

在路由文件中使用刚刚创建的中间件：

// routes/web.php
Route::middleware(['permission:edit-posts'])->group(function () {
    Route::post('/posts/{post}/edit', [PostController::class, 'edit']);
});

8. 创建控制器

创建一个控制器来处理权限相关的逻辑：

php artisan make:controller PostController

在控制器中使用中间件：

// app/Http/Controllers/PostController.php
namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    public function edit(Request $request, Post $post)
    {
        // ...
    }
}

9. 创建视图

创建一个视图来显示权限相关的界面。

10. 测试权限控制

登录到你的应用程序并尝试访问需要权限的路由，确保权限控制正常工作。

通过以上步骤，你可以在Laravel中搭建一个基本的权限控制模块。根据你的需求，你可能需要进一步扩展和定制这个模块。