Laravelでロールベースのアクセス制御を実装する方法

Laravel でロールベースのアクセス制御を実装する方法

はじめに:
Web アプリケーションでは、機密データと機密操作コンポーネントを保護するためにアクセス制御が重要です。ロールベースのアクセス制御は、ユーザーがそのロールに基づいて実行できるアクションを制限できる一般的なアクセス制御戦略です。

Laravel は、ロールベースのアクセス制御を実装するためのシンプルかつ強力な機能を提供する人気の PHP フレームワークです。この記事では、Laravel を使用してロールベースのアクセス制御を実装する方法を説明し、いくつかの具体的なコード例を示します。

ステップ 1: データベースを準備する
まず、ユーザー、ロール、権限の情報を保存するデータベースを作成する必要があります。 Laravelの移行機能を使用してデータベーステーブルを作成できます。ユーザー、ロール、権限の移行ファイルの例を次に示します。

<?php

use IlluminateDatabaseMigrationsMigration;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateSupportFacadesSchema;

class CreateRolesAndPermissionsTables extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        // 创建角色表
        Schema::create('roles', function (Blueprint $table) {
            $table->id();
            $table->string('name')->unique();
            $table->timestamps();
        });

        // 创建权限表
        Schema::create('permissions', function (Blueprint $table) {
            $table->id();
            $table->string('name')->unique();
            $table->timestamps();
        });

        // 创建用户表
        Schema::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->string('password');
            $table->timestamps();
        });

        // 创建用户角色表
        Schema::create('role_user', function (Blueprint $table) {
            $table->id();
            $table->unsignedBigInteger('user_id');
            $table->unsignedBigInteger('role_id');
            $table->timestamps();
        });

        // 创建角色权限表
        Schema::create('permission_role', function (Blueprint $table) {
            $table->id();
            $table->unsignedBigInteger('permission_id');
            $table->unsignedBigInteger('role_id');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        // 删除表格
        Schema::dropIfExists('permission_role');
        Schema::dropIfExists('role_user');
        Schema::dropIfExists('users');
        Schema::dropIfExists('permissions');
        Schema::dropIfExists('roles');
    }
}

移行コマンドを実行してデータベース テーブルを作成します。

php artisan migrate

ステップ 2: モデルと関係を定義する
In Laravel では、モデルとリレーションシップを使用して、ユーザー、ロール、権限などのデータを管理できます。以下はモデルと関係の定義の例です:

<?php

namespace AppModels;

use IlluminateDatabaseEloquentFactoriesHasFactory;
use IlluminateFoundationAuthUser as Authenticatable;

class User extends Authenticatable
{
    use HasFactory;

    /**
     * 获取用户的角色
     */
    public function roles()
    {
        return $this->belongsToMany(Role::class, 'role_user');
    }

    /**
     * 检查用户是否具有指定角色
     */
    public function hasRole($role)
    {
        return $this->roles->contains('name', $role);
    }
}

class Role extends Model
{
    use HasFactory;

    /**
     * 获取角色的权限
     */
    public function permissions()
    {
        return $this->belongsToMany(Permission::class, 'permission_role');
    }
}

class Permission extends Model
{
    use HasFactory;
}

ステップ 3: ポリシーを定義する
Laravel では、特定のリソースに対するユーザーのアクセス許可を定義および検証するためにストラテジーが使用されます。ポリシーを使用して、ロールベースのアクセス制御を実装できます。以下はポリシー定義の例です:

<?php

namespace AppPolicies;

use AppModelsUser;
use IlluminateAuthAccessHandlesAuthorization;

class PostPolicy
{
    use HandlesAuthorization;

    /**
     * 确定用户是否有权限更新一个帖子
     */
    public function update(User $user, Post $post)
    {
        return $user->hasRole('admin') || $user->hasRole('editor');
    }
}

ステップ 4: ストラテジの登録
ストラテジを使用するには、Laravel のストラテジ プロバイダーに登録する必要があります。 app/Providers/AuthServiceProvider.php ファイルを開き、次のコードを追加します:

<?php

namespace AppProviders;

use IlluminateSupportFacadesGate;
use IlluminateFoundationSupportProvidersAuthServiceProvider as ServiceProvider;
use AppPoliciesPostPolicy;

class AuthServiceProvider extends ServiceProvider
{
    protected $policies = [
        'AppModelsPost' => 'AppPoliciesPostPolicy',
    ];

    public function boot()
    {
        $this->registerPolicies();
    }
}

ステップ 5: ミドルウェアを使用する
ロールベースのアクセス制御を実装するには、次のコードを追加します。ルーティングと制御 サーバーで Laravel のミドルウェアを使用して、ユーザーの役割を確認します。以下はミドルウェア定義の例です。

<?php

namespace AppHttpMiddleware;

use Closure;

class RoleMiddleware
{
    public function handle($request, Closure $next, ...$roles)
    {
        if (!$request->user()->hasAnyRole($roles)) {
            abort(403, 'Unauthorized action.');
        }

        return $next($request);
    }
}

ステップ 6: ミドルウェアを使用してルーティング アクセスを制限する
最後に、指定したルートまたはルーティング グループにミドルウェアを適用して、ユーザー アクセスを制限できます。以下はルート例のコードです:

<?php

use AppHttpMiddlewareRoleMiddleware;

Route::get('/admin/dashboard', function () {
    // 管理员和编辑者才能访问
})->middleware(RoleMiddleware::class . ':admin,editor');

概要:
Laravel のデータベース、モデル、関係、戦略、ミドルウェア機能を通じて、ロールベースのアクセス制御を簡単に実装できます。上記は、Laravel でロールベースのアクセス制御を実装する方法の詳細な手順とコード例です。この記事が、Laravel のアクセス制御機能の理解と使用に役立つことを願っています。

以上がLaravelでロールベースのアクセス制御を実装する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。