tourane/codetags

A simple PHP module for feature toggle.

0.1.2 2019-02-19 04:33 UTC

Requires

• php: ^5.3.2 || ^7.0
• composer/semver: ^1.4.2

Requires (Dev)

• phpunit/phpunit: ^4.8
• phpunit/phpunit-mock-objects: 2.3.0 || ^3.0
• theseer/phpdox: ^0.11.2

MIT

• feature-toggle
• tourane

README

Installation

Install the latest version with:

$ composer require tourane/codetags

Basic usage

Requirements

• PHP 5.3.2 is required but using the latest version of PHP is highly recommended.

Default instance

Example source code examples/default-instance.php:

use Tourane\Codetags\TagManager;

$default = TagManager::instance();

// ...

if ($default->isActive('new-version')) {
  // do somethings
}

if ($default->isActive('mongodb', 'couchdb')) {
  // at least one of 'mongodb' and 'couchdb' is available
}

if ($default->isActive(['foo', 'bar'])) {
  // both 'foo' and 'bar' are available
}

Multiple instances

Example source code examples/multiple-instances.php:

use Tourane\Codetags\TagManager;

$default = TagManager::instance();

$oldFlow = TagManager::getInstance("oldflow");
$newFlow = TagManager::getInstance("current", array(
  "namespace" => "newflow"
));

if ($default->isActive("new-version")) {
  echo sprintf("%s is activated\n", "new-version");
}

if ($default->isActive(["foo", "bar"])) {
  echo sprintf("Both %s are activated\n", implode(",", ["foo", "bar"]));
}

if ($newFlow->isActive("couchdb", "mongodb")) {
  echo sprintf("One of %s is activated\n", implode(",", ["couchdb", "mongodb"]));
}

if ($newFlow->isActive(["couchdb", "mongodb"])) {
  echo sprintf("All of %s are activated\n", implode(",", ["couchdb", "mongodb"]));
}

Setting environment variables

Setting environment variables in php-fpm

Find your php-fpm pool config file (usually /etc/php/7.2/fpm/pool.d/www.conf, but could be in other place or have a different name - /etc/php/7.2/fpm/php-fpm.conf for example).

Find this line and uncomment it (remove the ‘;’):

;clear_env = no

Add environment variables declaration like this:

env[CODETAGS_INCLUDED_TAGS] = 'mongodb,foo,bar'
env[CODETAGS_EXCLUDED_TAGS] = 'couchdb'

Restart the php-fpm process with:

sudo service php7.2-fpm restart

License

MIT

See LICENSE to see the full text.