hellofresh/launchdarkly-php

Official LaunchDarkly SDK for PHP

LaunchDarkly SDK for PHP

, _(*1)

, _(*2)

Requirements

1. PHP 5.5 or higher.

Quick setup

1. Install the PHP SDK and monolog for logging with Composer, _(*3)

   php composer.phar require launchdarkly/launchdarkly-php

2. After installing, require Composer's autoloader:, _(*4)

   require 'vendor/autoload.php';

3. Create a new LDClient with your SDK key:, _(*5)

   $client = new LaunchDarkly\LDClient("your_sdk_key");

Your first feature flag

1. Create a new feature flag on your dashboard, _(*6)

2. In your application code, use the feature's key to check whether the flag is on for each user:, _(*7)

   $user = new LaunchDarkly\LDUser("user@test.com");
   if ($client->variation("your.flag.key", $user)) {
       # application code to show the feature
   } else {
       # the code to run if the feature is off
   }

Fetching flags

There are two approaches to fetching the flag rules from LaunchDarkly:, _(*8)

• Making HTTP requests (using Guzzle)
• Setting up the ld-daemon to store the flags in Redis

Using Guzzle

To use Guzzle it must be required as a dependency:, _(*9)

php composer.phar require "guzzlehttp/guzzle:6.2.1"
php composer.phar require "kevinrob/guzzle-cache-middleware:1.4.1"

It will then be used as the default way of fetching flags., _(*10)

Using Redis

1. Require Predis as a dependency:, _(*11)

   php composer.phar require "predis/predis:1.0.*", _(*12)

2. Create the LDClient with the Redis feature requester as an option:, _(*13)

   $client = new LaunchDarkly\LDClient("your_sdk_key", ['feature_requester_class' => 'LaunchDarkly\LDDFeatureRequester']);, _(*14)

Learn more

Check out our documentation for in-depth instructions on configuring and using LaunchDarkly. You can also head straight to the complete reference guide for this SDK., _(*15)

Contributing

We encourage pull-requests and other contributions from the community. We've also published an SDK contributor's guide that provides a detailed explanation of how our SDKs work., _(*16)

About LaunchDarkly

• LaunchDarkly is a continuous delivery platform that provides feature flags as a service and allows developers to iterate quickly and safely. We allow you to easily flag your features and manage them from the LaunchDarkly dashboard. With LaunchDarkly, you can:
  • Roll out a new feature to a subset of your users (like a group of users who opt-in to a beta tester group), gathering feedback and bug reports from real-world use cases.
  • Gradually roll out a feature to an increasing percentage of users, and track the effect that the feature has on key metrics (for instance, how likely is a user to complete a purchase if they have feature A versus feature B?).
  • Turn off a feature that you realize is causing performance problems in production, without needing to re-deploy, or even restart the application with a changed configuration file.
  • Grant access to certain features based on user attributes, like payment plan (eg: users on the ‘gold’ plan get access to more features than users in the ‘silver’ plan). Disable parts of your application to facilitate maintenance, without taking everything offline.
• LaunchDarkly provides feature flag SDKs for
  • Java
  • [JavaScript] (http://docs.launchdarkly.com/docs/js-sdk-reference "LaunchDarkly JavaScript SDK")
  • [PHP] (http://docs.launchdarkly.com/docs/php-sdk-reference "LaunchDarkly PHP SDK")
  • [Python] (http://docs.launchdarkly.com/docs/python-sdk-reference "LaunchDarkly Python SDK")
  • [Python Twisted] (http://docs.launchdarkly.com/docs/python-twisted-sdk-reference "LaunchDarkly Python Twisted SDK")
  • [Go] (http://docs.launchdarkly.com/docs/go-sdk-reference "LaunchDarkly Go SDK")
  • [Node.JS] (http://docs.launchdarkly.com/docs/node-sdk-reference "LaunchDarkly Node SDK")
  • [.NET] (http://docs.launchdarkly.com/docs/dotnet-sdk-reference "LaunchDarkly .Net SDK")
  • [Ruby] (http://docs.launchdarkly.com/docs/ruby-sdk-reference "LaunchDarkly Ruby SDK")
  • [iOS] (http://docs.launchdarkly.com/docs/ios-sdk-reference "LaunchDarkly iOS SDK")
  • [Android] (http://docs.launchdarkly.com/docs/android-sdk-reference "LaunchDarkly Android SDK")
• Explore LaunchDarkly
  • [launchdarkly.com] (http://www.launchdarkly.com/ "LaunchDarkly Main Website") for more information
  • [docs.launchdarkly.com] (http://docs.launchdarkly.com/ "LaunchDarkly Documentation") for our documentation and SDKs
  • [apidocs.launchdarkly.com] (http://apidocs.launchdarkly.com/ "LaunchDarkly API Documentation") for our API documentation
  • [blog.launchdarkly.com] (http://blog.launchdarkly.com/ "LaunchDarkly Blog Documentation") for the latest product updates
  • [Feature Flagging Guide] (https://github.com/launchdarkly/featureflags/ "Feature Flagging Guide") for best practices and strategies