hellofresh/feature-toggle

This package is abandoned and no longer maintained. No replacement package was suggested.

A simple feature toggle mechanism

dev-master 2016-07-11 18:08 UTC

Requires

• php: >=5.4.0
• easyframework/collections: ^5.0

Requires (Dev)

• phpunit/phpunit: ~4.8
• symfony/expression-language: ~3.0
• symfony/yaml: ~3.0

MIT

• Ítalo Lelis de Vietro

• flags
• feature
• toggle
• switch

README

A simple feature toggle mechanism for PHP.

If you don't know the feature toggle pattern please read this

Install

$ composer require hellofresh/feature-toogle

Usage

Let's define a new feature toggle list

  use HelloFresh\FeatureToggle\FeatureManager;
  use HelloFresh\FeatureToggle\Feature;
  use HelloFresh\FeatureToggle\OperatorCondition;
  use HelloFresh\FeatureToggle\Context;
  use Collections\ArrayList;
  
  $operator = new LessThan(42);
  $conditions = new ArrayList([new OperatorCondition('user_id', $operator)]);

  $manager = new FeatureManager();
  $manager
      ->addFeature(new Feature('feature1', $conditions))
      ->addFeature(new Feature('feature2', $conditions))
      ->addFeature(new Feature('feature3', $conditions))
      ->addFeature(new Feature('feature4', $conditions))
  ;

  $context = new Context([
      'user_id' => 42
  ]);
          
  if ($manager->isActive('feature2', $context)) {
       // The feature is active \o/ 
  }

Loading features from yaml files

    use HelloFresh\FeatureToggle\Context;
    use HelloFresh\FeatureToggle\FeatureManager;
    use HelloFresh\FeatureToggle\Serializer\Serializer;
    use Symfony\Component\Yaml\Yaml;
  
    $yaml = <<<YML
features:
  - name: some-feature
    conditions:
     - name: operator-condition
       key: user_id
       operator:
           name: greater-than
           value: 41
       status: conditionally-active
  - name: some-feature2
    conditions:
     - name: operator-condition
       key: user_id
       operator:
           name: greater-than
           value: 42
       status: conditionally-active
YML;

    $serializer = new Serializer();

    $features = $serializer->deserialize(Yaml::parse($yaml)['features']);
    $manager = new FeatureManager($features);

    $context = new Context();
    $context->set('user_id', 42);

    if ($manager->isActive('feature2', $context)) {
           // The feature is active \o/ 
    }

What about using an expression?

use HelloFresh\FeatureToggle\FeatureManager;
use HelloFresh\FeatureToggle\Feature;
use HelloFresh\FeatureToggle\ExpressionCondition;
use HelloFresh\FeatureToggle\Context;
use Collections\ArrayList;
use Symfony\Component\ExpressionLanguage\ExpressionLanguage;

$language   = new ExpressionLanguage();
$expression = new ExpressionCondition('user["active"] and product["price"] / 100 >= 0.2', $language);

$manager = new FeatureManager();
$manager->addFeature(new Feature('feature1', $expression));

// Create and check a new context and condition using symfony expression
$context = new Context();
$context->set('user', [
    'active' => true
]);

$context->set('product', [
    'price' => 30
]);
      
if ($manager->isActive('feature2', $context)) {
   // The feature is active \o/ 
}

Contributing

Please see CONTRIBUTING for details.

License

The MIT License (MIT). Please see License File for more information.