Download the PHP package open-feature/flagd-provider without Composer
On this page you can find all versions of the php package open-feature/flagd-provider. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download open-feature/flagd-provider
More information about open-feature/flagd-provider
Files in open-feature/flagd-provider
Package flagd-provider
Short Description The Flagd provider package for open-feature
License Apache-2.0
Informations about the package flagd-provider
OpenFeature Flagd Provider for PHP
Overview
Flagd is a simple command line tool for fetching and presenting feature flags to services. It is designed to conform to OpenFeature schema for flag definitions. This repository and package provides the client side code for interacting with it via the OpenFeature PHP SDK.
This package 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).
Installation
Usage
The FlagdProvider
client constructor takes a single optional argument with 3 fields, their default values correspond to the default arguments supplied to the flagd server:
- protocol: "http" (defaults to http)
- host: string (defaults to "localhost")
- port: number (defaults to 8013)
- secure: true | false (defaults to false)
- http: An array or
HttpConfig
object, providing implementations for PSR interfaces- client: a
ClientInterface
implementation - requestFactory: a
RequestFactoryInterface
implementation - streamFactory: a
StreamFactoryInterface
implementation
- client: a
gRPC vs HTTP
The Flagd server is gRPC but offers gRPC Web endpoints that can be accessed over HTTP. The latter is used by the current implementation of the Flagd provider, with future development planned to implement a gRPC native provider option. There are certain flexibilities around HTTP with PHP available, whereas gRPC is an opinionated code-generation strategy, but they are both useful and gRPC native may provide better performance over certain sync/async scenarios. An additional goal will be to provide benchmarking of the Flagd provider's protocol for various scenarios so this decision can be made more easily by consumers of the provider.
Development
PHP Versioning
This library targets PHP version 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
.
All versions of flagd-provider with dependencies
open-feature/sdk Version ^2.0
php-http/httplug Version ^2.3.0
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^2.0
psr/log Version ^2.0 || ^3.0