Skip to content

schmeiserd/qandidate-toggle-bundle

 
 

Repository files navigation

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.

Build Status

About

Read the our blog post series about this repository at:

Installation

Add the bundle to your composer.json

$ composer require qandidate/toggle-bundle ~0.1

Add the bundle to your Kernel

$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.

<!-- services.xml -->

<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 function:

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

Or the Twig test:

{% if 'comments' is active feature %}
    {# Awesome comments #}
{% endif %}

Both are registered in the ToggleTwigExtension.

License

MIT, see LICENSE.

About

Symfony Bundle for Qandidate\Toggle

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%