🐩 🐂 👱🏿 Sistem otorisasi sumber daya canggih di Laravel. Bagian 2. Gateways, Kebijakan 👩🏽‍🍳 🏁 👵🏻

pengantar

Halo, Khabrovchane sayang.
Saya melanjutkan seri artikel saya tentang otorisasi sumber daya tingkat lanjut di Laravel. Untuk lebih memahami apa yang akan dibahas dalam artikel ini - Anda perlu membaca bagian pertama .

Untuk mulai dengan, saya akan mengulangi pernyataan masalah secara singkat: Ada sejumlah besar model. Penting untuk merancang sistem yang fleksibel dan mudah diperluas untuk mengotorisasi tindakan pengguna tergantung pada perannya.
Pada bagian ini, kita akan berbicara tentang mengonfigurasi Kebijakan tautan <=> Gateway. Dan juga salah satu opsi untuk menulis hak pengguna ke database diusulkan.

Dan tentu saja, saya akan segera mengklarifikasi bahwa materi tersebut dirancang untuk berlatih programmer, dan akan sulit untuk dipahami oleh pengembang pemula.

Bagian 3. Kebijakan, Gateways

Bagian teoretis

Cukup banyak materi di Internet dapat ditemukan pada topik - "Apa yang harus memilih Kebijakan atau Gerbang ?". Untuk waktu tertentu, saya juga tiba di kesalahan yang sama bahwa Anda perlu memilih sesuatu. Tetapi pada akhirnya saya sampai pada kesimpulan - ini adalah dua mata rantai yang sama, yang paling efektif digunakan bersama.
Di Laravel, ada dua arah utama untuk menentukan bundel ini - manual dan otomatis. Saya tidak akan mempertimbangkan manual, karena dukungan jenis bundel ini akan membutuhkan upaya programmer yang lebih banyak daripada menyiapkan yang otomatis.

— , () . (Gate) — . — , . , . , app. . app/Models.

Gate::guessPolicyNamesUsing('callback'). , boot() App\Providers\AuthServiceProvider( ).

Gate

(callback), guessPolicyNamesUsing() , . . : Policy . , , Laravel ( ). SuperAdmin , , — super-admin . — .
PHP 7.4 . 7.4 .

<?php

namespace App\Providers;

use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
use Illuminate\Support\Facades\Gate;

class AuthServiceProvider extends ServiceProvider
{
    public function boot()
    {
        $this->defineSuperAdmin();
        $this->defineAutoDiscover();
    }

    private function defineAutoDiscover()
    {
        Gate::guessPolicyNamesUsing(function ($class) {
            return str_replace("\\Models\\", "\\Policies\\" , $class) . 'Policy';
        });
    }

    private function defineSuperAdmin()
    {
        Gate::before(function($user) {
            return $user->hasRole('super-admin') ? true : null;
        });
    }
}

Policy

, , . . :

    php artisan make:policy PostPolicy --model=Models/Post

. . , DRY,- , . , . , getModelClass() . , ( ). . (import export — )

<?php
protected function resourceAbilityMap()
{
    return [
        'index' => 'viewAny',
        'show' => 'view',
        'create' => 'create',
        'store' => 'create',
        'edit' => 'update',
        'update' => 'update',
        'destroy' => 'delete',
        'import' => 'import',
        'export' => 'export',
    ];
}

— , . , . . Spatie. laravel-permission. , — , , . , , . — , $user->can() $user->hasRole(), Spatie\Permission\Traits\HasRoles

(Models\User)

<?php

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use Notifiable;
    use HasRoles;

    /**     */
}

, (Admin User, ) — HasRoles, .
.

(ModelPolicy)

<?php

namespace App\Policies;

use App\Models\User;
use App\Models\Post;
use Illuminate\Auth\Access\HandlesAuthorization;
use Illuminate\Database\Eloquent\Model;

abstract class ModelPolicy
{
    use HandlesAuthorization;

    abstract protected function getModelClass(): string;

    public function viewAny(User $user)
    {
        return $user->can('view-any-' . $this->getModelClass());
    }

    public function view(User $user, Post $model)
    {
        return $user->can('view-' . $this->getModelClass());
    }

    public function create(User $user)
    {
        return $user->can('create-' . $this->getModelClass());
    }

    public function update(User $user, Post $model)
    {
        return $user->can('update-' . $this->getModelClass());
    }

    public function delete(User $user, Post $model)
    {
        return $user->can('delete-' . $this->getModelClass());
    }
}

$user->can('ability') . . ''-' ', — ( ). (SoftDelete). , .
. Post getResourceName() .

(PostPolicy)

<?php

namespace App\Policies;

use App\Models\Post;
use App\Models\User;
use Illuminate\Database\Eloquent\Model;

class PostPolicy extends ModelPolicy
{
    protected function getModelClass(): string
    {
        return Post::class;
    }

    public function import(User $user)
    {
        return $user->can('import-' . $this->getModelClass());
    }

    public function export(User $user, Post $model)
    {
        return $user->can('export-' . $this->getModelClass());
    }
}

, import() , . — . . , .

, , . .

4. (Seeding)

, . .
spatie/laravel-permission, . .
:

    composer require spatie/laravel-permission
    php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"

(seeder)

    php artisan make:seeder PermissionsSeeder

run() database/seeds/DatabaseSeeder.php. PermissionsSeeder .

(DatabaseSeeder)

<?php

use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
    public function run()
    {
         $this->call(PermissionsSeeder::class);
    }
}

, — PermissionsSeeder. database/data php . :

    role => model => action

// (permissions_roles.php)

<?php

return [
    'admin' => [
        'App\\Models\\Post' => [
            'view',
            'view-any',
            'create',
            'update',
            'delete',
            'import',
            'export',
        ],
    ],
    'App\\Models\\Post' => [
        'post' => [
            'view',
            'view-any',
        ],
    ],
];

. , , — .

(PermissionsSeeder)

<?php

use Illuminate\Database\Seeder;
use Spatie\Permission\Models\Permission;
use Spatie\Permission\Models\Role;

class PermissionsSeeder extends Seeder
{
    private $data = [];

    public function run()
    {
        $this->loadData();
        $this->seedRoles();
    }

    public function loadData(): void
    {
        $this->data = require_once database_path("data/permissions_roles.php");
    }

    private function seedRoles(): void
    {
        Role::create(['name' => 'super-admin', 'guard_name' => 'api']);

        foreach ($this->data as $roleName => $perms) {
            $role = Role::create(['name' => $roleName, 'guard_name' => 'api']);
            $this->seedRolePermissions($role, $perms);
        }
    }

    private function seedRolePermissions(Role $role, array $modelPermissions): void
    {
        foreach ($modelPermissions as $model => $perms) {
            $buildedPerms = collect($perms)
                ->crossJoin($model)
                ->map(function ($item) {
                $perm = implode('-', $item); //view-post
                Permission::findOrCreate($perm, 'api');

                return $perm;
            })->toArray();

            $role->givePermissionTo($buildedPerms);
        }
    }
}

, - . , , . , , .
, :

run() .
loadData() database/data $data
seedRoles() . , $data, . 'super-admin' , , .. ( AuthServiceProvider).
seedRolePermissions() , , «» , (permission). . () — findOrCreate(), laravel-permissions. , , .

, . :

    php artisan migrate --seed

. ! , :

(Model).
(Controller) ModelController.
(Policy) ModelPolicy.
.

, (. 1) (. ).

Itu saja untuk saat ini. Semoga artikel ini bermanfaat. Dan jika seseorang tertarik pada penyetelan yang lebih halus dari hak dan batasan pengguna, yaitu, hak pengguna untuk menonton / mengubah atribut spesifik dari model - ini
dibahas di bagian ketiga .

Sistem otorisasi sumber daya canggih di Laravel. Bagian 2. Gateways, Kebijakan