Feature Toggle Bundle Laravel Package

Getting Started

Install the package via Composer:

composer require bestit/flagception-bundle

Publish the configuration (if needed):

php artisan vendor:publish --provider="BestIT\FlagceptionBundle\FlagceptionBundle" --tag="config"

Enable debug mode in config/flagception.php to leverage the new TraceableChainDecorator for debugging flag evaluation chains:

'debug' => env('FLAGCEPTION_DEBUG', false),

Use the bundle's services in your Laravel application (e.g., flag evaluation):

$flag = app('flagception')->evaluate('feature.x');

Implementation Patterns

Debugging Flag Chains

Leverage the TraceableChainDecorator in debug mode to inspect flag evaluation logic:

if (config('flagception.debug')) {
    $flag = app('flagception')->evaluate('feature.x'); // Decorator adds traceability
    dd($flag->getEvaluationTrace()); // Inspect the chain
}

Workflow:

1. Set FLAGCEPTION_DEBUG=true in .env.
2. Use getEvaluationTrace() to debug complex flag chains (e.g., A/B tests, feature toggles).
3. Disable debug mode in production (FLAGCEPTION_DEBUG=false).

Integration with Laravel Services

Extend existing flag logic (e.g., middleware, policies):

// app/Http/Middleware/FeatureFlagMiddleware.php
public function handle($request, Closure $next) {
    if (app('flagception')->evaluate('feature.admin_dashboard')) {
        return $next($request);
    }
    abort(403);
}

Gotchas and Tips

Debug Mode Overhead

• Pitfall: Enabling debug mode adds runtime overhead due to traceability. Fix: Disable in production (FLAGCEPTION_DEBUG=false).
• Tip: Use dd($flag->getEvaluationTrace()) sparingly in staging.

Traceability Scope

• The TraceableChainDecorator only works in debug mode. Ensure:

  if (config('flagception.debug')) {
      $trace = $flag->getEvaluationTrace(); // Works
  } else {
      $trace = null; // No trace available
  }
  

Configuration Quirks

• The debug setting is not a runtime toggle—it requires a config reload or environment restart.
• For dynamic toggling, use a custom decorator:

  app('flagception')->decorateWith(new class implements DecoratorInterface { ... });
  

Extension Points

• Override TraceableChainDecorator to customize trace output:

  // src/Decorators/CustomTraceDecorator.php
  class CustomTraceDecorator implements DecoratorInterface {
      public function evaluate(Flag $flag) {
          $trace = $flag->getEvaluationTrace();
          // Modify trace logic here
          return $flag;
      }
  }
  

• Register via service provider:

  $this->app->make('flagception')->decorateWith(new CustomTraceDecorator());