PHPackages                             philiprehberger/laravel-feature-flags - 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. [Utility & Helpers](/categories/utility)
4. /
5. philiprehberger/laravel-feature-flags

ActiveLibrary[Utility & Helpers](/categories/utility)

philiprehberger/laravel-feature-flags
=====================================

Lightweight feature flags with config and database drivers, percentage rollout, and scheduling

v1.0.4(1mo ago)15[1 PRs](https://github.com/philiprehberger/laravel-feature-flags/pulls)MITPHPPHP ^8.2CI passing

Since Mar 9Pushed 1mo agoCompare

[ Source](https://github.com/philiprehberger/laravel-feature-flags)[ Packagist](https://packagist.org/packages/philiprehberger/laravel-feature-flags)[ Docs](https://github.com/philiprehberger/laravel-feature-flags)[ RSS](/packages/philiprehberger-laravel-feature-flags/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (8)Versions (6)Used By (0)

Laravel Feature Flags
=====================

[](#laravel-feature-flags)

[![Tests](https://github.com/philiprehberger/laravel-feature-flags/actions/workflows/tests.yml/badge.svg)](https://github.com/philiprehberger/laravel-feature-flags/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/b3a3b069b63e208e2e45ed26073871927bed39023d1962a4347f938793fe8b20/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068696c69707265686265726765722f6c61726176656c2d666561747572652d666c6167732e737667)](https://packagist.org/packages/philiprehberger/laravel-feature-flags)[![License](https://camo.githubusercontent.com/1645ab93f6385e550b895da8f9259e7b526b57787cb8be3d5aa04469abd040fe/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7068696c69707265686265726765722f6c61726176656c2d666561747572652d666c616773)](LICENSE)

Lightweight feature flags with config and database drivers, percentage rollout, and scheduling.

### Features

[](#features)

- Two drivers: **config** (deploy with code) and **database** (toggle at runtime)
- **Percentage rollout** — expose a feature to a deterministic percentage of users
- **Scheduling** — activate features between `enabled_from` and `enabled_until` timestamps
- **Blade directives** — `@feature` / `@featurefor` for template-level gating
- **Route middleware** — `feature:{name}` returns 403 for inactive features
- **Artisan commands** — `feature:list`, `feature:enable`, `feature:disable`
- **Facade** — `Feature::active()`, `Feature::for($user)->active()`
- Laravel package auto-discovery

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11 or 12

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

[](#installation)

Install via Composer:

```
composer require philiprehberger/laravel-feature-flags
```

The service provider and `Feature` facade are registered automatically via Laravel's package auto-discovery.

### Publish the config

[](#publish-the-config)

```
php artisan vendor:publish --tag=feature-flags-config
```

### Publish and run the migration (database driver only)

[](#publish-and-run-the-migration-database-driver-only)

```
php artisan vendor:publish --tag=feature-flags-migrations
php artisan migrate
```

### Configuration

[](#configuration)

`config/feature-flags.php`:

```
return [

    // 'config' reads flags from the 'features' array below.
    // 'database' reads flags from the feature_flags table.
    'driver' => env('FEATURE_FLAGS_DRIVER', 'config'),

    'features' => [
        // Simple on/off flag
        'new-checkout' => true,

        // Partial rollout — 25% of users will see this feature
        'beta-dashboard' => ['active' => true, 'rollout' => 25],

        // Scheduled flag — only active between the two dates
        'holiday-banner' => [
            'active'        => true,
            'enabled_from'  => '2026-12-01',
            'enabled_until' => '2026-12-31',
        ],

        // Combined: rollout + scheduling
        'early-access' => [
            'active'       => true,
            'rollout'      => 10,
            'enabled_from' => '2026-06-01',
        ],
    ],

];
```

Set the driver via your `.env`:

```
FEATURE_FLAGS_DRIVER=database
```

Usage
-----

[](#usage)

### Facade

[](#facade)

```
use PhilipRehberger\FeatureFlags\Facades\Feature;

// Global check (no user context)
if (Feature::active('new-checkout')) {
    // ...
}

// Per-user check (respects rollout percentage)
if (Feature::for($request->user())->active('beta-dashboard')) {
    // ...
}

// List all defined flags
$flags = Feature::allFeatures();

// Enable / disable at runtime (database driver only)
Feature::enable('new-checkout');
Feature::disable('new-checkout');
```

### Blade Directives

[](#blade-directives)

Global check:

```
@feature('new-checkout')

@endfeature
```

With an else branch (plain PHP `@else`):

```
@feature('new-checkout')

@else

@endfeature
```

Conditional on a second feature (`@elsefeature` is the elseif variant):

```
@feature('checkout-v3')

@elsefeature('new-checkout')

@endfeature
```

Per-user check (respects rollout):

```
@featurefor('beta-dashboard', auth()->user())

@endfeaturefor
```

### Route Middleware

[](#route-middleware)

Protect a route so it returns 403 when the feature is inactive:

```
Route::get('/checkout/v2', CheckoutV2Controller::class)
    ->middleware('feature:new-checkout');
```

When the request has an authenticated user, the per-user rollout check is applied. Otherwise the global active state is used.

### Artisan Commands

[](#artisan-commands)

```
# List all feature flags with status, rollout, and schedule
php artisan feature:list

# Enable a flag (database driver only)
php artisan feature:enable new-checkout

# Disable a flag (database driver only)
php artisan feature:disable new-checkout
```

Example `feature:list` output:

```
+------------------+---------+------------+-----------+-------------+
| Name             | Status  | Rollout    | Schedule  | Description |
+------------------+---------+------------+-----------+-------------+
| new-checkout     | active  | all users  | always    | —           |
| beta-dashboard   | active  | 25%        | always    | —           |
| holiday-banner   | active  | all users  | 2026-12-01 → 2026-12-31 | — |
+------------------+---------+------------+-----------+-------------+

```

### Drivers

[](#drivers)

#### Config Driver

[](#config-driver)

Flags are defined in `config/feature-flags.php`. Changes require a deployment. This is the default driver and ideal for flags that are tied to your release cycle.

#### Database Driver

[](#database-driver)

Flags are stored in the `feature_flags` table and can be toggled at runtime via Artisan commands, the facade, or any database tooling. Run the migration before using this driver.

The migration creates the following columns:

ColumnTypeDescription`id`bigintPrimary key`name`string (unique)Flag identifier`description`string (nullable)Optional description`active`booleanMaster on/off switch`rollout_percentage`tinyint (nullable)Percentage of users (0–100)`enabled_from`timestamp (nullable)Activation start`enabled_until`timestamp (nullable)Activation end`created_at` / `updated_at`timestampsStandard Laravel timestamps### Rollout Logic

[](#rollout-logic)

Percentage rollout uses a deterministic hash to ensure the same user always receives the same result:

```
$hash = abs(crc32($featureName . $user->getAuthIdentifier()));
$active = ($hash % 100) < $rolloutPercentage;
```

A user in the 25% bucket for `beta-dashboard` will always be in that bucket — they will not flip between requests, and adding new flags will not affect their bucket for existing flags.

### Scheduling

[](#scheduling)

When `enabled_from` or `enabled_until` are set, the flag is only active during the configured window. Dates are parsed with Carbon, so any format Carbon accepts is valid (e.g. `'2026-12-01'`, `'2026-12-01 09:00:00'`).

API
---

[](#api)

### `Feature` Facade

[](#feature-facade)

MethodDescription`Feature::active(string $name): bool`Check if a feature is active (global check)`Feature::for(Authenticatable $user): static`Set a user context for rollout checks`Feature::allFeatures(): array`Return all defined feature flags`Feature::enable(string $name): void`Enable a flag at runtime (database driver only)`Feature::disable(string $name): void`Disable a flag at runtime (database driver only)### Blade Directives

[](#blade-directives-1)

DirectiveDescription`@feature('name') ... @endfeature`Render block when feature is active`@feature('name') ... @else ... @endfeature`Render alternate block when feature is inactive`@elsefeature('name') ... @endfeature`Else-if variant for a second feature check`@featurefor('name', $user) ... @endfeaturefor`Per-user feature check respecting rolloutDevelopment
-----------

[](#development)

```
composer install
vendor/bin/phpunit
vendor/bin/pint --test
vendor/bin/phpstan analyse
```

License
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance89

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~2 days

Total

5

Last Release

53d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cfd7d24cbbf32400fa13ce0bbe7a31edd2d66a6d4488eafdb3d64c5337bf0435?d=identicon)[philiprehberger](/maintainers/philiprehberger)

---

Top Contributors

[![philiprehberger](https://avatars.githubusercontent.com/u/8218077?v=4)](https://github.com/philiprehberger "philiprehberger (22 commits)")

---

Tags

laravelrolloutfeature-flagsfeature-togglesab-testing

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/philiprehberger-laravel-feature-flags/health.svg)

```
[![Health](https://phpackages.com/badges/philiprehberger-laravel-feature-flags/health.svg)](https://phpackages.com/packages/philiprehberger-laravel-feature-flags)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[spatie/laravel-enum

Laravel Enum support

3655.4M31](/packages/spatie-laravel-enum)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[laracraft-tech/laravel-useful-additions

A collection of useful Laravel additions!

58109.4k](/packages/laracraft-tech-laravel-useful-additions)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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