Databázová schéma a typy kľúčov

Balík používa sedem tabuliek — päť z verzie 2.0 a dve tabuľky priradení, ktoré pridala verzia 2.1 spolu s vlastníkom rolí. Ich názvy pochádzajú z table_names; názvy stĺpcov sú pevné:

Väzby na držiteľov sú polymorfné (model_type + model_id), takže roly a oprávnenia môže držať akýkoľvek Eloquent model — nielen používateľ. Vlastné aliasy z morph mapy sa v pivotoch ukladajú rovnako ako kdekoľvek inde v Laraveli.

Typ kľúča držiteľov

key_type opisuje modely, ktoré držia roly a oprávnenia — nikdy nie vlastné tabuľky balíka, tie majú vždy autoinkrementálny kľúč. Určuje typ stĺpca model_id v dvoch polymorfných pivotoch:

Nastavte ho pred publikovaním a spustením migrácií — schéma sa vydaním zmrazí:

PERMISSIONS_KEY_TYPE=uuid

use Illuminate\Database\Eloquent\Concerns\HasUuids;
use Illuminate\Foundation\Auth\User as Authenticatable;
use RoundlyConsulting\Permissions\Concerns\HasRoles;

class User extends Authenticatable
{
    use HasRoles;
    use HasUuids; // pairs with PERMISSIONS_KEY_TYPE=uuid
}

Nenastavený alebo prázdny kľúč znamená bigint; neznáma hodnota vyhodí InvalidConfigurationException z toolkitu, namiesto toho, aby potichu vytvorila kľúče bigint.

Typ kľúča rozsahov

assignments.scope_key_type robí to isté pre modely rozsahov a vlastníkov rolí: určuje typ scope_id v oboch tabuľkách priradení a roles.owner_id. Ak nie je nastavený, platí key_type. Jediný stĺpec scope_id nesie kľúč každého modelu rozsahu, takže všetky vaše rozsahy zdieľajú jeden typ kľúča. Stĺpce okna sú dateTime, nie timestamp — ukladajú sa v UTC na sekundy, bez posunu podľa časového pásma MySQL session a bez limitu roku 2038.

Zámerne bez soft deletes

Roly a oprávnenia nepoužívajú soft deletes: unikátny index na name by kolidoval so soft-zmazanými riadkami a každý pivot sa pri zmazaní kaskáduje — odstránením roly či oprávnenia zmiznú aj jeho priradenia.