Laravel Feature Flags

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

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

• PHP ^8.2
• Laravel ^11.0 or ^12.0

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

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

Publish and run the migration (database driver only)

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

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

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

Global check:

@feature('new-checkout')
    <x-checkout-v2 />
@endfeature

With an else branch (plain PHP @else):

@feature('new-checkout')
    <x-checkout-v2 />
@else
    <x-checkout-v1 />
@endfeature

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

@feature('checkout-v3')
    <x-checkout-v3 />
@elsefeature('new-checkout')
    <x-checkout-v2 />
@endfeature

Per-user check (respects rollout):

@featurefor('beta-dashboard', auth()->user())
    <x-beta-dashboard />
@endfeaturefor

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

# 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

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

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:

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

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

Feature Facade

Blade Directives

Development

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

License

MIT