library lifx-client

phlak/lifx-client

PHP client library for the LIFX API (v1)

, _(*1)

, _(*2)

PHP client library for the LIFX API (v1) -- by, Chris Kankiewicz (@PHLAK) , _(*3)

Introduction

LIFX Client is a LIFX API client library for PHP built with GuzzleHttp., _(*4)

Refer to the full LIFX API documentation for more information about each method and it's available parameters., _(*5)

Requirements

• PHP >= 7.1

Install with Composer

composer require phlak/lifx-client

Initializing the Client

First, import LIFX:, _(*6)

use PHLAK\LIFX;

Then instantiate the class with your LIFX OAuth 2 access token. You can generate an access token from your account settings page:, _(*7)

$lifx = new LIFX\Client('YOUR_APP_TOKEN');

Usage

List one or more lights via a selector:, _(*8)

$lifx->listLights($selector = 'all');

Set the state of one or more lights via a selector:, _(*9)

$lifx->setState($selector, array $params);

Set multiple states across multiple selectors:, _(*10)

$lifx->setStates(array $states, array $defaults = []);

Toggle the power of one or more lights via a selector:, _(*11)

$lifx->togglePower($selector, $duration = 1);

Cause one or more lights to breathe via a selector:, _(*12)

$lifx->breatheEffect($selector, $color, array $params = []);

Cause one or more lights to pulse via a selector:, _(*13)

$lifx->pulseEffect($selector, $color, array $params = []);

Make the light(s) cycle to the next or previous state in a list of states:, _(*14)

$lifx->cycle($selector, array $states, array $params = []);

Get a list of available scenes:, _(*15)

$lifx->listScenes();

Activate a scene:, _(*16)

$lifx->activateScene($sceneUuid, $duration = 1.0);

Validate a color string:, _(*17)

$lifx->validateColor($string);

Handling Exceptions

use GuzzleHttp\Exception\ClientException;

try {
    $lifx->togglePower('id:123456789abcd');
} catch (ClientException $exception) {
    // Handle this exception here...
}

See the GuzzleHttp exceptions documentation for more details., _(*18)

Changelog

A list of changes can be found on the GitHub Releases page., _(*19)

Troubleshooting

For general help and support join our [Spectrum Community](https://spectrum.chat/phlaknet or reach out on Twitter., _(*20)

Please report bugs to the GitHub Issue Tracker., _(*21)

Copyright

This project is licensed under the MIT License., _(*22)