magetech/laravel-feature-flags

Controlled feature rollout and feature management for Laravel.

dev-main 2026-08-25 14:55 UTC

Requires

• php: ^8.2
• illuminate/cache: ^11.0|^12.0|^13.0
• illuminate/database: ^11.0|^12.0|^13.0
• illuminate/events: ^11.0|^12.0|^13.0
• illuminate/http: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• larastan/larastan: ^2.0|^3.0
• laravel/pint: ^1.0
• mockery/mockery: ^1.6
• orchestra/testbench: ^8.0|^9.0|^10.0
• pestphp/pest: ^2.0|^3.0
• phpunit/phpunit: ^10.0|^11.0|^12.0

MIT

• MageTech Solutions

• laravel
• release
• toggle
• rollout
• feature-flags
• targeting

Published on Packagist.org on 2026-08-25 14:56 UTC

README

Controlled feature rollout and feature management for Laravel.

Developed by MageTech Solutions

Features

• Boolean feature flags
• Percentage rollouts
• Variant/A/B testing
• Configuration flags
• User targeting (ID, email, role, permission)
• Team & organization targeting
• Environment-specific configuration
• Percentage-based deterministic rollouts
• User-specific overrides with precedence rules
• Scheduling (start/end dates)
• Blade directives
• Middleware
• Artisan commands
• REST API
• Cache support
• Events
• Extensible rule engine

Requirements

• PHP 8.2+
• Laravel 11.x, 12.x, or 13.x

Installation

composer require magetech/laravel-feature-flags
php artisan mts:feature-flags:install
php artisan migrate

Configuration

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

Published to config/mts-feature-flags.php.

Basic Usage

Facade

use MageTech\FeatureFlags\Facades\Feature;

if (Feature::enabled('new-dashboard')) {
    // Feature is enabled
}

if (Feature::disabled('legacy-mode')) {
    // Feature is disabled
}

// With user context
$user = auth()->user();
if (Feature::for($user)->enabled('premium-features')) {
    // User has access
}

// Get variant
$variant = Feature::variant('checkout-ui', $user);

// Get value
$value = Feature::value('color-theme', $user);

Helper Functions

if (feature_enabled('new-checkout')) {
    // Feature is enabled
}

$variant = feature_variant('checkout-ui', $user);
$value = feature_value('config-key', $user);

Blade Directives

@feature('new-dashboard')
    <div>New Dashboard Content</div>
@endfeature

@unlessfeature('legacy-mode')
    <div>Modern interface</div>
@endunlessfeature

@featureVariant('checkout', 'v2')
    <div>Version 2 of checkout</div>
@endfeatureVariant

Middleware

Route::middleware('feature:new-dashboard')->group(function () {
    // Routes only accessible when feature is enabled
});

Artisan Commands

php artisan mts:feature-flags:list
php artisan mts:feature-flags:create
php artisan mts:feature-flags:enable feature-name
php artisan mts:feature-flags:disable feature-name
php artisan mts:feature-flags:check feature-name
php artisan mts:feature-flags:clear-cache
php artisan mts:feature-flags:export --output=flags.json
php artisan mts:feature-flags:import flags.json

API

Enable in config:

'api' => [
    'enabled' => true,
],

Endpoints:

GET    /api/feature-flags
GET    /api/feature-flags/{key}
POST   /api/feature-flags
PUT    /api/feature-flags/{key}
DELETE /api/feature-flags/{key}
POST   /api/feature-flags/{key}/enable
POST   /api/feature-flags/{key}/disable
POST   /api/feature-flags/{key}/evaluate

Targeting Rules

User ID Targeting

$flag->rules()->create([
    'rule_type' => 'user_id',
    'operator' => 'equals',
    'attribute' => 'id',
    'value' => '1001',
]);

Role Targeting

$flag->rules()->create([
    'rule_type' => 'role',
    'operator' => 'equals',
    'attribute' => 'role',
    'value' => 'admin',
]);

Email Targeting

$flag->rules()->create([
    'rule_type' => 'email',
    'operator' => 'ends_with',
    'attribute' => 'email',
    'value' => '@company.com',
]);

Environment Targeting

$flag->rules()->create([
    'rule_type' => 'environment',
    'operator' => 'equals',
    'attribute' => 'environment',
    'value' => 'production',
]);

Percentage Rollouts

$flag = Feature::create([
    'key' => 'new-checkout',
    'name' => 'New Checkout',
    'type' => 'percentage',
    'enabled' => true,
    'rollout_percentage' => 25,
]);

The same user will always get the same result (deterministic hashing).

Variants

$flag = Feature::create([
    'key' => 'checkout-ui',
    'name' => 'Checkout UI',
    'type' => 'variant',
    'enabled' => true,
]);

$flag->variants()->create(['key' => 'control', 'name' => 'Control', 'weight' => 50]);
$flag->variants()->create(['key' => 'treatment', 'name' => 'Treatment', 'weight' => 50]);

$variant = Feature::variant('checkout-ui', $user);

Scheduling

Feature::create([
    'key' => 'holiday-sale',
    'name' => 'Holiday Sale',
    'type' => 'boolean',
    'enabled' => true,
    'starts_at' => '2026-12-01 00:00:00',
    'ends_at' => '2026-12-31 23:59:59',
]);

Environment Configuration

Feature::create([
    'key' => 'new-feature',
    'name' => 'New Feature',
    'type' => 'boolean',
    'enabled' => true,
    'environment' => 'local',
]);

$flag->environments()->create(['environment' => 'production', 'enabled' => false]);
$flag->environments()->create(['environment' => 'staging', 'enabled' => true]);

Overrides

$flag->overrides()->create([
    'subject_type' => 'App\Models\User',
    'subject_id' => 1001,
    'enabled' => true,
    'expires_at' => now()->addDays(7),
]);

Precedence

Feature evaluation follows this precedence (highest to lowest):

1. Explicit user override
2. Targeting rules
3. Percentage rollout
4. Environment setting
5. Global default

Events

• FeatureCreated
• FeatureUpdated
• FeatureDeleted
• FeatureEnabled
• FeatureDisabled
• FeatureEvaluated
• FeatureOverrideCreated
• FeatureOverrideRemoved

Caching

Enabled by default. Configure in config/mts-feature-flags.php:

'cache' => [
    'enabled' => true,
    'prefix' => 'mts_feature_flags',
    'ttl' => 3600,
    'store' => null,
],

Clear cache: php artisan mts:feature-flags:clear-cache

Extensibility

Implement custom contracts:

use MageTech\FeatureFlags\Contracts\FeatureRuleContract;

class CustomRule implements FeatureRuleContract
{
    public function evaluate($rule, $subject, $operator): bool
    {
        // Custom logic
    }
}

Register via service provider:

$ruleEngine = app(MageTech\FeatureFlags\Support\RuleEngine::class);
$ruleEngine->registerRule('custom', new CustomRule());

Testing

cd packages/feature-flags
composer install
composer test

Security

Report security issues to [e-mail]

License

MIT License. See LICENSE for details.

Developed by MageTech Solutions