🚱 🌍 🖥️ लारवेल में उन्नत संसाधन प्राधिकरण प्रणाली। भाग 2. गेटवे, नीतियां 👨🏿‍🎨 🕺🏼 👎

परिचय

नमस्कार प्रिय खाबरोवचने।
मैं लारवेल में उन्नत संसाधन प्राधिकरण पर अपनी लेख श्रृंखला जारी रखता हूं। इस लेख में क्या चर्चा की जाएगी, यह समझने के लिए - आपको पहले भाग को पढ़ने की आवश्यकता है ।

शुरू करने के लिए, मैं संक्षेप में समस्या के बयान को दोहराऊंगा: बड़ी संख्या में मॉडल हैं। उनकी भूमिका के आधार पर उपयोगकर्ता कार्यों को अधिकृत करने के लिए एक लचीली और आसानी से एक्स्टेंसिबल प्रणाली को डिजाइन करना आवश्यक है।
इस भाग में, हम लिंक नीति <=> गेटवे को कॉन्फ़िगर करने के बारे में बात करेंगे। और डेटाबेस के लिए उपयोगकर्ता अधिकारों को लिखने का एक विकल्प भी प्रस्तावित है।

और हां, मैं तुरंत स्पष्ट कर दूंगा कि सामग्री प्रोग्रामर्स को अभ्यास करने के लिए डिज़ाइन की गई है, और एक नौसिखिया डेवलपर के लिए समझना मुश्किल होगा।

भाग 3. नीतियां, गेटवे

सैद्धांतिक हिस्सा

इंटरनेट पर बहुत सारी सामग्री इस विषय पर मिल सकती है - " नीति या गेट का चयन करने के लिए क्या है ?"। एक निश्चित समय के लिए, मैं भी इसी तरह की त्रुटि में आया था कि आपको कुछ चुनने की आवश्यकता है। लेकिन अंत में मैं निष्कर्ष पर आया - ये एक ही श्रृंखला के दो लिंक हैं, जो संयोजन में सबसे प्रभावी रूप से उपयोग किए जाते हैं।
लारवेल में, इस बंडल को निर्धारित करने के लिए दो मुख्य दिशाएं हैं - मैनुअल और स्वचालित। मैं मैनुअल पर विचार नहीं करूंगा, क्योंकि इस प्रकार के बंडल के समर्थन के लिए स्वचालित रूप से स्थापित करने की तुलना में अधिक प्रोग्रामर प्रयासों की आवश्यकता होगी।

— , () . (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) (. ).

अभी के लिए इतना ही। आशा है कि यह लेख मददगार रहा है। और अगर किसी को उपयोगकर्ताओं के अधिकारों और प्रतिबंधों के समरूप ट्यूनिंग में रुचि है, अर्थात्, उपयोगकर्ता के मॉडल के एक विशिष्ट गुण को देखने / बदलने का अधिकार - यह
तीसरे भाग में चर्चा की गई है ।

लारवेल में उन्नत संसाधन प्राधिकरण प्रणाली। भाग 2. गेटवे, नीतियां