Search by

lomkit / laravel-access-control

GautierDele

A Laravel package that declares in one control who can see and change each Eloquent model: its perimeters drive the policies, the query scopes and the Scout searches.

Package info

github.com/Lomkit/laravel-access-control

Homepage

Documentation

pkg:composer/lomkit/laravel-access-control

Fund package maintenance!

GautierDele

Statistics

Installs: 22 775

Dependents: 0

Suggesters: 0

Stars: 5

Open Issues: 0

v0.7.0 2026-11-09 08:30 UTC

README

Social Card of Laravel Access Control

Laravel Access Control

Laravel Access Control allows you to fully secure your application in two key areas: Policies and Queries. Manage everything in one place!

Requirements

PHP 8.2+ and Laravel 12+

Documentation, Installation, and Usage Instructions

See the documentation for detailed installation and usage instructions.

What it does

You first need to define the perimeters concerned by your applications (php artisan make:perimeter, in app/Access/Perimeters).

Create the model control (php artisan make:control). Controls are discovered in app/Access/Controls:

class PostControl extends Control
{
    protected string $model = Post::class;

    protected function perimeters(): array
    {
        return [
            GlobalPerimeter::new()
                ->allowed(function (Model $user, Ability $ability): bool {
                    return $user->can("{$ability} global models");
                })
                ->unrestricted(),
            ClientPerimeter::new()
                ->allowed(function (Model $user, Ability $ability): bool {
                    return $user->can("{$ability} client models");
                })
                ->should(function (Model $user, Model $model) {
                    return $model->client()->is($user->client);
                })
                ->query(function (Builder $query, Model $user): void {
                    $query->where('client_id', $user->client->getKey());
                }),
            // ...
        ];
    }
}

Add the HasControl trait to your model, it resolves the control whose $model matches:

class Post extends Model
{
    use HasControl;
}

Then set up your policy:

class PostPolicy extends ControlledPolicy
{
    protected string $control = PostControl::class;
}

and you are ready to go !

App\Models\Post::controlled()->get() // Apply the Control to the query

$user->can('view', App\Models\Post::first()) // Check if the user can view the post according to the policy

A controlled query run without an authenticated user returns no rows.