Download the PHP package althinect/enum-permission without Composer

Laravel Enum Permissions

A Laravel package to easily manage Permissions with Enums and sync these permissions to your database. This package is built on top of Spatie's Laravel-Permission package, providing an enum-based approach to permission management. It's fully configured via the config file located at config/enum-permission.php.

Requirements

• PHP 8.1 or higher (required for Enums support)
• Laravel 10.0 or higher
• Spatie/Laravel-Permission package

Installation

This package automatically installs Spatie's Laravel-Permission package as a dependency, so you don't need to require it separately.

Spatie configs

You will need to run the migrations and add the necessary configs according to the Spatie Permissions documentation

After installation, publish the configuration file:

Then run the migrations to set up all required tables including the permissions tables from Spatie and the group column added by this package:

Configuration

The configuration file will be published to config/enum-permission.php. Customize your permissions, models path, and other options there.

Configuration Options

Migrations

This package relies on the database tables created by the Spatie Laravel-Permission package and automatically adds a 'group' column to the permissions table for better organization.

When you install this package and run migrations, two things happen:

1. The Spatie migrations create the core permission tables:

   • permissions - Stores all permissions
   • roles - Stores all roles
   • model_has_permissions - Maps permissions to users or other models
   • model_has_roles - Maps roles to users or other models
   • role_has_permissions - Maps permissions to roles
2. This package adds its own migration to enhance the permissions table:
   • Adds a group column to the permissions table
   • Creates an index on the group column for faster queries

The group column is used when sync_permission_group is enabled in the config, allowing permissions to be organized by model name, which is especially useful for UI-based permission management systems.

Usage

Generating Permission Enums

The permission:make command generates permission enums (and policies if requested) for your models.

Syncing Permissions to Database

The permission:sync command scans for permission enums and syncs them to the database.

Using Generated Permissions

Directory Structure

After generation, your files will be organized as follows:

If your models use domain-driven structure, permission enums will follow the same structure:

Available Commands

• permission:make {modelName?} {--P|policy} {--force} - Generate permission enums and optional policies
• permission:sync {--C|clean} {--path=} {--force} - Sync permissions to database

Examples

Generated Permission Enum

Generated Policy

Permission Groups

When sync_permission_group is enabled in the config, permissions will be grouped by model name, which is helpful for UI-based permission management:

This feature uses the group column added to the permissions table by this package's migration. The permissions are grouped automatically during the sync process:

This grouping makes it easy to:

• Create model-based permission management UIs
• Filter permissions by model in your admin panels
• Apply batch operations to all permissions of a specific model

Error Handling

The package includes comprehensive error handling:

• Database compatibility across PostgreSQL, MySQL, and other supported systems
• Graceful failure when encountering invalid classes
• File operation safeguards
• Exception reporting for debugging

Extending the Package

You can extend the package's functionality by:

1. Customizing the permission stubs in the config file
2. Adding custom permission groups
3. Creating middleware that uses the permission enums
4. Building custom UI components for managing permissions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This package is open-source software licensed under the MIT license.