README

一个 Laravel Nova 工具，允许您分组权限并将其分配给用户。它使用 Spatie 的 laravel-permission。

我们提供了一个迁移、种子、策略和资源，以提供良好的授权体验。

安装
带有分组的权限
自定义
致谢

安装

您可以通过 composer 在使用 Nova 的 Laravel 应用中安装此包。

composer require sereny/nova-permissions

使用以下命令发布迁移

php artisan vendor:publish --provider="Sereny\NovaPermissions\ToolServiceProvider" --tag="migrations"

迁移数据库

php artisan migrate

接下来，您必须在 Nova 中注册此工具。这通常在 NovaServiceProvider 的 tools 方法中完成。

// in app/Providers/NovaServiceProvider.php

// ...

public function tools()
{
    return [
        // ...
        new \Sereny\NovaPermissions\NovaPermissions(),
    ];
}

如果您想隐藏工具以供某些用户使用，您可以编写自定义逻辑以显示工具的能力

// in app/Providers/NovaServiceProvider.php

// ...

public function tools()
{
    return [
        // ...
        (new \Sereny\NovaPermissions\NovaPermissions())->canSee(function ($request) {
            return $request->user()->isSuperAdmin();
        }),
    ];
}

最后，将 MorphToMany 字段添加到您的 app/Nova/User 资源中

// ...
use Laravel\Nova\Fields\MorphToMany;

public function fields(Request $request)
{
    return [
        // ...
        MorphToMany::make('Roles', 'roles', \Sereny\NovaPermissions\Nova\Role::class),
        MorphToMany::make('Permissions', 'permissions', \Sereny\NovaPermissions\Nova\Permission::class),
    ];
}

将 Spatie\Permission\Traits\HasRoles 特性添加到您的用户模型中

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

class User extends Authenticatable
{
    use HasRoles;

    // ...
}

安装此包后，您的 Nova 应用中会出现一个新的菜单项 角色 & 权限。

带有分组的权限

索引视图

详情视图

编辑视图

数据库种子

使用以下命令发布我们的种子器

php artisan vendor:publish --provider="Sereny\NovaPermissions\ToolServiceProvider" --tag="seeders"

以下是一个示例，说明您如何使用种子器将角色和权限种入数据库。请在 database/seeders 中的 RolesAndPermissionsSeeder.php 中修改。在 $collection 数组中列出您想要为其设置权限的所有模型，并更改超级管理员的电子邮件地址。

<?php

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

class RolesAndPermissionsSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        // Reset cached roles and permissions
        app()[\Spatie\Permission\PermissionRegistrar::class]->forgetCachedPermissions();

        $collection = collect([
            'Invoice',
            'Client',
            'Contact',
            'Payment',
            'Team',
            'User',
            'Role',
            'Permission'
            // ... your own models/permission you want to crate
        ]);

        $collection->each(function ($item, $key) {
            // create permissions for each collection item
            Permission::create(['group' => $item, 'name' => 'viewAny' . $item]);
            Permission::create(['group' => $item, 'name' => 'view' . $item]);
            Permission::create(['group' => $item, 'name' => 'update' . $item]);
            Permission::create(['group' => $item, 'name' => 'create' . $item]);
            Permission::create(['group' => $item, 'name' => 'delete' . $item]);
            Permission::create(['group' => $item, 'name' => 'destroy' . $item]);
        });

        // Create a Super-Admin Role and assign all permissions to it
        $role = Role::create(['name' => 'super-admin']);
        $role->givePermissionTo(Permission::all());

        // Give User Super-Admin Role
        $user = \App\Models\User::where('email', 'your@email.com')->first(); // enter your email here
        $user->assignRole('super-admin');
    }
}

现在您可以种入数据库了。将 $this->call(RolesAndPermissionsSeeder::class); 添加到 DatabaseSeeder。

注意：如果不起作用，请运行 composer dumpautoload 以自动加载种子器。

创建模型策略

您可以通过扩展 Sereny\NovaPermissions\Policies\BasePolicy 来扩展模型策略，并使其与 Nova 一起工作。

例如：使用以下代码创建一个新的 Contact 策略 php artisan make:policy ContactPolicy

<?php

namespace App\Policies;

use Sereny\NovaPermissions\Policies\BasePolicy;

class ContactPolicy extends BasePolicy
{
    /**
     * The Permission key the Policy corresponds to.
     *
     * @var string
     */
    public $key = 'contact';
}

现在它应该按预期工作。只需创建一个角色，修改其权限，策略就会处理其余部分。

注意：不要忘记将您的策略添加到 App\Providers\AuthServiceProvider 的 $policies。

注意：只有当您根据我们的种子示例创建了权限时，才扩展策略。否则，请确保在您的表中具有 viewAnyContact, viewContact, createContact, updateContact, deleteContact, restoreContact, destroyContact 作为权限。

超级管理员

超级管理员可以做任何事情。如果您扩展了我们的策略，请确保在您的 App\User 模型中添加一个 isSuperAdmin() 函数。

<?php

namespace App;

class User {

    /**
     * Determines if the User is a Super admin
     * @return null
    */
    public function isSuperAdmin()
    {
        return $this->hasRole('super-admin');
    }
}

自定义

// in app/Providers/NovaServiceProvider.php

use App\Nova\Permission;
use App\Nova\Role;
use App\Policies\PermissionPolicy;
use App\Policies\RolePolicy;

// ...

public function tools()
{
    return [
        // ...
        \Sereny\NovaPermissions\NovaPermissions::make()
            ->roleResource(Role::class)
            ->permissionResource(Permission::class)
            ->rolePolicy(RolePolicy::class)
            ->permissionPolicy(PermissionPolicy::class)
            ->disablePermissions()
            ->disableMenu();
            ->hideFieldsFromRole([
                'id',
                'guard_name'
            ])
            ->hideFieldsFromPermission([
                'id',
                'guard_name',
                'users',
                'roles'
            ])
            ->resolveGuardsUsing(function($request) {
                return [ 'web' ];
            })
            ->resolveModelForGuardUsing(function($request) {
                /** @var App\Auth\CustomGuard $guard */
                $guard = auth()->guard();
                return $guard->getProvider()->getModel();
            })
    ];
}

重要

要自定义 Role 模型，您需要使用 Sereny\NovaPermissions\Traits\SupportsRole 特性

// Role using UUID primary key

namespace App\Models;

use Illuminate\Database\Eloquent\Concerns\HasUuids;
use Illuminate\Support\Str;
use Sereny\NovaPermissions\Traits\SupportsRole;
use Spatie\Permission\Models\Role as BaseRole;

class Role extends BaseRole
{
    use HasUuids,
        SupportsRole; // REQUIRED TRAIT
}

致谢

此包受到了 eminiarts/nova-permissions 的启发。

向 Spatie spatie/laravel-permission 表示衷心的感谢，他们的工作非常出色！

sereny / nova-permissions

维护者

详情