flagception/flagception-bundle

Feature toggle bundle on steroids.

5.0.1 2024-08-05 08:04 UTC

Requires

• php: ^8.0
• doctrine/annotations: ^1.7 | ^2.0
• flagception/flagception: ^1.5
• symfony/config: ^4.4 | ^5.0 | ^6.0 | ^7.0
• symfony/dependency-injection: ^4.4 | ^5.0 | ^6.0 | ^7.0
• symfony/http-kernel: ^4.4 | ^5.0 | ^6.0 | ^7.0
• symfony/yaml: ^4.4 | ^5.0 | ^6.0 | ^7.0
• twig/twig: ^1.18|^2.0|^3.0

Requires (Dev)

• flagception/database-activator: ^1.0
• php-coveralls/php-coveralls: ^2.0
• squizlabs/php_codesniffer: ^3.3.1
• symfony/phpunit-bridge: ^5.0 | ^6.0 | ^7.0
• symfony/twig-bridge: ^4.4 | ^5.0 | ^6.0 | ^7.0

Suggests

• flagception/database-activator: Fetch feature flags from a database.

MIT

• Michel Chowanski

• symfony
• bundle
• flags
• feature
• toggle
• rollout
• feature-flags
• feature-toggle
• flagception

README

Feature toggle bundle on steroids! Flagception is a simple and powerful feature toggle system for php. This bundle integrates the Flagception PHP Library for symfony 2.7 to 6.* (and php 5.6 to php 8.*).

$ composer require flagception/flagception-bundle

Documentation

• Installation
• Upgrade from 2.x
• Upgrade from 3.x
• Upgrade from 4.x
• Usage
• Twig flags
• Route flags
• Route condition flags
• Attribute flags
• Annotation flags
• Constraints
• Environment variables
• Cookies
• Database
• Activators
• Profiler

Quick example

Set some feature in your config (or use your own activator for fetching features from wherever you want) ...

flagception:

    # Your Features (optional you left it empty)
    features:
    
        # Feature name as key
        feature_123:
            # Default flag if inactive or active (default: false)
            default: true
            
        # Feature state from an environment variable
        feature_abc:
            env: FEATURE_ENV_ABC
            
        # Feature with constraint (active if user id is 12 OR it is between 8 am and 6 pm)
        feature_def:
            constraint: 'user_id == 12 or (date("H") > 8 and date("H") < 18)'
                    
        # All togther (chain)
        feature_def:
            default: false
            env: FEATURE_ENV_ABC
            constraint: 'user_id == 12 or (date("H") > 8 and date("H") < 18)'

... and use it in controller, services or twig:

{% if feature('feature_123') %}
    {# Execute if feature is active ... #}
{% endif %}

See usage documentation for detailed examples.

Profiler

This bundle ships a profiler tab, where you can see how often a feature was requested, which results it returns (active or inactive) and the given context.

Credits

Profiler icon from https://github.com/ionic-team/ionicons