PHPackages                             voyager-inc/permission-role - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. voyager-inc/permission-role

ActiveLibrary

voyager-inc/permission-role
===========================

Permission role

09PHP

Since May 22Pushed 1y ago1 watchersCompare

[ Source](https://github.com/phutd-voyager/permission-role)[ Packagist](https://packagist.org/packages/voyager-inc/permission-role)[ RSS](/packages/voyager-inc-permission-role/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Simple block blacklist and whitelist IP
=======================================

[](#simple-block-blacklist-and-whitelist-ip)

[`PHP v8.2`](https://php.net)

[`Laravel v11.x`](https://github.com/laravel/laravel)

Installation
------------

[](#installation)

```
composer require voyager-inc/permission-role
```

- Publish provider

```
php artisan vendor:publish --provider="VoyagerInc\PermissionRole\ServiceProvider"
```

- Run migration

```
php artisan migrate
```

- Install example code if you want

```
php artisan permission-role:install-example
```

and now the package will generate `Controller` and `Route`

- `PermissionRoleController.php`
- `permission_role.php`

Usage
-----

[](#usage)

- We have a middleware alias with name `permission-role:`Example: `permission-role:admin` or `permission-role:user`
- We can enable/disable middleware with config `enable_middleware` in `permission_role.php` file with value is `true` to enable or `false` to disable.
- For example:
- In `web.php` or `api.php` add this line below to load `permission_role` route of package

```
require __DIR__.'/permission_role.php';
```

- `permission_role.php` file route with content:

```
Route::middleware(['permission-role:admin'])->get('/permission-role/admin', [\App\Http\Controllers\PermissionRoleController::class, 'admin']);
Route::middleware(['permission-role:user'])->get('/permission-role/user', [\App\Http\Controllers\PermissionRoleController::class, 'user']);
Route::get('/permission-role/everyone', [\App\Http\Controllers\PermissionRoleController::class, 'everyone']);
```

###  Health Score

14

—

LowBetter than 2% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity18

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/88914573f9e40f76c57e972ca786b9d384bd7fd7739381145acdbdb5e537fa72?d=identicon)[silz.it94](/maintainers/silz.it94)

![](https://www.gravatar.com/avatar/22c1d050d1c65dc15bfa55bdb69582bdc32b181e2f3dbe8e7bd5c95d39c74af5?d=identicon)[sonnn@voyager-hcm.com](/maintainers/sonnn@voyager-hcm.com)

---

Top Contributors

[![phutd-voyager](https://avatars.githubusercontent.com/u/167964846?v=4)](https://github.com/phutd-voyager "phutd-voyager (10 commits)")

### Embed Badge

![Health badge](/badges/voyager-inc-permission-role/health.svg)

```
[![Health](https://phpackages.com/badges/voyager-inc-permission-role/health.svg)](https://phpackages.com/packages/voyager-inc-permission-role)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)