FeatureFlagBundle

The FeatureFlagBundle is a bundle to manage features flags in your Symfony applications.

⚠️ You're currently reading the documentation for the next major version. Refer to the 2.x documentation to read the stable version documentation.

Compatibility

This bundle is tested with at least all maintained Symfony version.

Documentation

Install it

Install extension using composer:

composer require novaway/feature-flag-bundle

If you don't use Flex, enable the bundle in your config/bundles.php file:

<?phpreturn [
// ...Novaway\Bundle\FeatureFlagBundle\NovawayFeatureFlagBundle::class => ['all' => true],
];

Configuration

To configure and register a feature manager you need a factory service. You may also need to change some options to the factory.

# ...novaway_feature_flag:
default_manager: defaultmanagers:
default:
factory: 'novaway_feature_flag.factory.array'options:
features:
my_feature_1: falsemy_feature_2: truemy_feature3: '%env(bool:FEATURE_ENVVAR)%'

The factories that come with this bundle can be found in the table below.

Factory service id	Options
novaway_feature_flag.factory.array	features

Example configuration

# ...novaway_feature_flag:
default_manager: defaultmanagers:
default:
factory: novaway_feature_flag.factory.arrayoptions:
features:
my_feature_1:
enabled: falsedescription: MyFeature1 description textmy_feature_2:
enabled: truedescription: MyFeature2 description textmy_feature3:
enabled: '%env(bool:FEATURE_ENVVAR)%'description: MyFeature3 description text

You can declare multiple managers. Multiple providers is useful if you want to use different storage providers or to isolate your features flags.

# ...novaway_feature_flag:
default_manager: manager_foomanagers:
manager_foo:
factory: novaway_feature_flag.factory.arrayoptions:
features:
my_feature_1:
enabled: falsedescription: MyFeature1 description textmy_feature_2:
enabled: truedescription: MyFeature2 description textmy_feature3:
enabled: '%env(bool:FEATURE_ENVVAR)%'description: MyFeature3 description textmanager_bar:
factory: novaway_feature_flag.factory.arrayoptions:
features:
my_feature_4:
enabled: falsedescription: MyFeature4 description textmy_feature_5: []my_feature_6: ~my_feature_7: false

When several managers are defined, they are registered in the Symfony dependency injection container as services with the following naming convention: novaway_feature_flag.manager.<manager_name>.

For example, the manager_bar is accessible with the following service name: novaway_feature_flag.manager.manager_bar.

Manager storage are also registered in the Symfony dependency injection container as services with the following naming convention: novaway_feature_flag.storage.<manager_name>.

Use it as a service

The bundle adds a global novaway_feature_flag.manager (also bind to FeatureManager) service you can use in your PHP classes.

In the case you have defined several managers, the service use the ChainedFeatureManager class to chain all declared managers.

useNovaway\Bundle\FeatureFlagBundle\Manager\FeatureManager;
// ...class MyController extends Controller
{
publicfunctionmyAction(FeatureManager$featureManager): Response
{
if ($featureManager->isEnabled('my_feature_1')) {
// my_feature_1 is enabled
}
if ($featureManager->isDisabled('my_feature_2')) {
// my_feature_2 is not enabled
}
// ...
}
}

In your Twig templates

You can also check a flag in your templates:

{% if isFeatureEnabled('my_feature_1') %}
{% include'feature1_template.html.twig' %}
{% endif %}
{% if isFeatureDisabled('my_feature_2') %}
{% include'feature2_template.html.twig' %}
{% endif %}

In the routing configuration

The package allows you to restrict a controller access by adding some configuration in your routing definition.

# app/config/routing.ymlmy_first_route:
path: /my/first/routedefaults:
_controller: AppBundle:Default:index_features:
- { feature: my_feature_key, enabled: false } # The action is accessible if "my_feature_key" is disabledmy_second_route:
path: /my/second-routedefaults:
_controller: AppBundle:Default:second_features:
- { feature: foo } # The action is accessible if "foo" is enabled ...
- { feature: bar, enabled: true } # ... and "bar" feature is also enabled
- { feature: feature-42, enabled: true, exceptionClass: Symfony\Component\HttpKernel\Exception\BadRequestHttpException } # will throw a BadRequestHttpException if "feature-42" is disabled
- { feature: feature-44, enabled: true, exceptionFactory: Symfony\Component\HttpKernel\Exception\BadRequestHttpExceptionFactory } # will use the BadRequestHttpExceptionFactory registered factory class to create the exception to be thrown

As a controller attribute

You can also restrict a controller access with attributes, two attributes are available:

• Novaway\Bundle\FeatureFlagBundle\Attribute\FeatureEnabled
• Novaway\Bundle\FeatureFlagBundle\Attribute\FeatureDisabled

#[FeatureEnabled(name: "foo")]
class MyController extends Controller
{
#[FeatureEnabled(name: "foo", exceptionClass: BadRequestHttpException::class)]
publicfunctionannotationFooEnabledAction(): Response
{
returnnewResponse('MyController::annotationFooEnabledAction');
}
#[FeatureDisabled(name: "foo", exceptionFactory: MyExceptionFactory::class)]
publicfunctionannotationFooDisabledAction(): Response
{
returnnewResponse('MyController::annotationFooDisabledAction');
}
}

Implement your own storage provider

1. First your need to create your storage provider class which implement the Novaway\Bundle\FeatureFlagBundle\Storage\StorageInterface interface
2. Register it in the Symfony dependency injection container
3. Specify the storage you want to use in a manager configuration

novaway_feature_flag:
manager:
manager_name:
storage: your.custom.service.nameoptions:
# arguments need to create the storage service

When you create a storage, the static method create is called to create the storage instance.

License

This library is published under MIT license