Lua SDK reference

Overview

This topic documents how to get started with the Lua SDK, and links to reference information on all of the supported features. We also provide documentation for running the SDK in NGINX and HAProxy.

Get started

After you complete the Getting Started process, follow these steps to get started using the LaunchDarkly SDK in your Lua application.

The Lua server-side SDK is implemented using a foreign function interface that calls the C++ server-side SDK. You need to install the C++ server-side SDK dynamic library somewhere accessible by the linker.

To learn more, read C++ SDK reference (server-side).

Install the SDK

First, include the library:

1
local ld = require("launchdarkly_server_sdk")

Initialize the client

After you install and import the SDK, create a single, shared instance of LDClient. Specify your SDK key here to authorize your application to connect to a particular environment within LaunchDarkly.

Calling clientInit initiates a remote call to the LaunchDarkly service to fetch feature flags. This call blocks up for the time that you provide in milliseconds. If you request a feature flag before the client completes initialization, you will receive the default flag value.

Here is an example:

1
-- This will block for 1 second
2
local client = ld.clientInit("YOUR_SDK_KEY", 1000, config)

To learn more about the specific configuration properties that are available in this SDK, read clientInit.

Evaluate a context

You can use client to check which variation a particular context will receive for a given feature flag.

Here’s how:

1
if client:boolVariation(context, "example-flag-key", false) then
2
    print "feature is enabled"
3
else
4
    print "feature is disabled"
5
end

Supported features

This SDK supports the following features:

• Aliasing users
• Anonymous contexts and users
• Configuration, including
  • Application metadata configuration
  • Service endpoint configuration
• Context configuration
• Evaluating flags
• Flag evaluation reasons
• Flushing events
• Getting all flags
• Identifying and changing contexts
• Logging
• Offline
• Private attributes
• Relay Proxy configuration
  • Using proxy mode
  • Using daemon mode
• Sending custom events
• Storing data