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.2 or higher
• Laravel 10.0 to 13.x
• 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.

Publish configuration and migrations

Before running migrations, publish the configuration and migration files used by both Spatie's Laravel Permission package and this package:

Then run the migrations to set up Spatie's permission tables and this package's grouped-permission support:

If you are upgrading an existing installation, publishing enum-permission-migrations and running migrations will add the group column to your existing permissions table.

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 builds on the database tables created by Spatie Laravel-Permission and ships an additional publishable migration under the enum-permission-migrations tag to add a group column to the permissions table.

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 for easier filtering, grouping, and display in admin UIs.

Generated permission enums already include the HasPermissionGroup trait. By default, that trait derives the group name from the enum class name by removing the Permission suffix, so UserPermission becomes User, PostPermission becomes Post, and so on.

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 and stored in the group column added by the published enum-permission-migrations migration. Generated enums already use HasPermissionGroup, which makes grouping work out of the box:

This feature uses the group column added to the permissions table by this package's migration. During permission:sync, the package calls getPermissionGroup() and stores the returned value in that column:

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.