tsslabs/toggle-bundle

Qandidate Toggle Symfony Bundle

This Bundle provides the integration with our toggle library. It provides the services and configuration you need to implement feature toggles in your application., _(*1)

, _(*2)

About

Read the our blog post series about this repository at: - http://labs.qandidate.com/blog/2014/08/18/a-new-feature-toggling-library-for-php/ - http://labs.qandidate.com/blog/2014/08/19/open-sourcing-our-feature-toggle-api-and-ui/, _(*3)

Installation

Add the bundle to your composer.json, _(*4)

$ composer require qandidate/toggle-bundle ~0.1

Add the bundle to your Kernel, _(*5)

$bundles = array(
    // ..
    new Qandidate\Bundle\ToggleBundle\QandidateToggleBundle(),
);

Configuration

qandidate_toggle:
    persistence: in_memory|redis
    context_factory: null|your.context_factory.service.id
    redis_namespace: toggle_%kernel.environment% # default, only required when persistence = redis
    redis_client: null|your.redis_client.service.id # only required when persistence = redis

Example usage

Usage can vary on your application. This example uses the supplied UserContextFactory, but you probably need to create your own factory., _(*6)

<service id="acme.controller" class="Acme\Controller">
    <argument type="service" id="qandidate.toggle.manager" />
    <argument type="service" id="qandidate.toggle.user_context_factory" />
</service>

// Acme\Controller

public function __construct(
    /* ArticleRepository, Templating, ..*/ 
    ToggleManager $manager, 
    ContextFactory $contextFactory
) {
    // ..
    $this->manager = $manager;
    $this->context = $contextFactory->createContext();
}

// ..

public function articleAction(Request $request)
{
    $this->article = $this->repository->findBySlug($request->request->get('slug'));

    return $this->templating->render('article.html.twig', array(
        'article'        => $article,
        'enableComments' => $this->manager->active('comments', $this->context),
    ));
}

Twig usage

If you use Twig you can also use the Twig function:, _(*7)

{% if is_active('comments') %}
    {# Awesome comments #}
{% endif %}

License

MIT, see LICENSE., _(*8)