0xc / openfeature
PHP implementation of the OpenFeature SDK
Requires
- php: ^7.4 || ^8
- myclabs/php-enum: ^1.8
- psr/log: ^1.1
Requires (Dev)
- captainhook/captainhook: ^5.10
- captainhook/plugin-composer: ^5.3
- ergebnis/composer-normalize: ^2.25
- hamcrest/hamcrest-php: ^2.0
- mdwheele/zalgo: ^0.3.1
- mockery/mockery: ^1.5
- php-parallel-lint/php-console-highlighter: ^1.0
- php-parallel-lint/php-parallel-lint: ^1.3
- phpstan/extension-installer: ^1.1
- phpstan/phpstan: ~1.8.0
- phpstan/phpstan-mockery: ^1.0
- phpstan/phpstan-phpunit: ^1.1
- psalm/plugin-mockery: ^0.9.1
- psalm/plugin-phpunit: ^0.17.0
- ramsey/coding-standard: ^2.0.3
- ramsey/composer-repl: ^1.4
- ramsey/conventional-commits: ^1.3
- roave/security-advisories: dev-latest
- spatie/phpunit-snapshot-assertions: ^4.2
- vimeo/psalm: ~4.25.0
This package is auto-updated.
Last update: 2023-01-02 21:07:49 UTC
README
Alpha Checklist
- spec compliant
- contains test suite which verifies behavior consistent with spec
- contains test suite with reasonable coverage
- automated publishing
- comprehensive readme
Disclaimer
I'm throwing this project together as a potential demo-phase of OpenFeature for PHP, with future work surrounding a Split PHP provider (probably utilizing their existing package). It is not complete and is very much work in progress.
Overview
This package provides a functional SDK for an OpenFeature API and client. It also builds on various PSRs (PHP Standards Recommendations) such as the Logger interfaces (PSR-3) and the Basic and Extended Coding Standards (PSR-1 and PSR-12).
Future development may aim to allow this library to be auto-loaded by filepath (PSR-4) and optionally integrate with the container standards (PSR-11) over global $_SESSION
access.
Installation
$ composer require 0xc/openfeature // installs the latest version
Usage
While Boolean
provides the simplest introduction, we offer a variety of flag types.
use OpenFeature\OpenFeatureClient; class MyClass { private OpenFeatureClient $client; public function __construct() { $this->client = OpenFeatureAPI->getInstance()->getClient('MyClass'); } public function booleanExample(): UI { // Should we render the redesign? Or the default webpage? if ($this->client->getBooleanValue('redesign_enabled', false)) { return render_redesign(); } return render_normal(); } public function stringExample(): Template { // Get the template to load for the custom new homepage $template = $this->client->getStringValue('homepage_template', 'default-homepage.html'); return render_template($template); } public function numberExample(): List<HomepageModule> { // How many modules should we be fetching? $count = $this->client->getIntegerValue('module-fetch-count', 4); return fetch_modules($count); } public function structureExample(): HomepageModule { $obj = $this->client->getObjectValue('hero-module', $previouslyDefinedDefaultStructure); return HomepageModuleBuilder::new() ->title($obj->getValue('title')) ->body($obj->getValue('description')) ->build(); } }
Configuration
To configure OpenFeature, you'll need to add a provider to the global singleton OpenFeatureAPI
. From there, you can generate a Client
which is usable by your code. If you do not set a provider, then the NoOpProvider
, which simply returns the default passed in, will be used.
use OpenFeature\OpenFeatureAPI; use OpenFeature\Providers\Flagd\FlagdProvider; class MyApp { public function bootstrap(){ $api = OpenFeatureAPI.getInstance(); $api->setProvider(new FlagdProvider()); $client = $api->getClient(); // Now use your `$client` instance to evaluate some feature flags! } }
Development
PHP Versioning
This library targets PHP version 7.4 and newer. As long as you have any compatible version of PHP on your system you should be able to utilize the OpenFeature SDK.
This package also has a .tool-versions
file for use with PHP version managers like asdf
.
Installation and Dependencies
Install dependencies with composer install
. composer install
will update the composer.lock
with the most recent compatible versions.
We value having as few runtime dependencies as possible. The addition of any dependencies requires careful consideration and review.
Testing
Run tests with composer run test
.