Download the PHP package jkniest/hue-it without Composer
On this page you can find all versions of the php package jkniest/hue-it. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package hue-it
PHP wrapper for the Phillips Hue API
Installation
Simply install this package via composer:
Documentation
The full documentation can be found here.
Getting started
You can use the hue-it wrapper for both local network connections or using the cloud.
Usage (Local bridge)
First, you'll need to figure out the IP address of your bridge. You can find the IP address in your router.
Also, you need physical access to your bridge.
Below is an example of how we might connect to a bridge with the
IP address 123.456.78.9. After calling the authenticate method
the application waits until you press the LINK button
on your bridge.
Of course, you can reuse the generated username. See Local authentication for more information.
Usage (Cloud)
Using the hue cloud is a little more complex than the local network. First, you'll need to create a Phillips hue app.
After creating the app you'll have access to client credentials (id and secret) and an app ID. We need both to connect via the cloud. The device id and name can be chosen as you like.
We recommend that you'll read the basics of OAuth2 before continuing.
For more information see Cloud authentication.
Testing
If you are writing tests while using hue-it, there are two possibilities if you don't want to make api requests each time your test suite runs:
- Mock the PhillipsHue instance
- Create your own Fake PhillipsHueGateway.
Currently we don't have documentation for this, but each Gateway extends from an abstract class and has its own client (Cloud Client VS Local client). You could create a new Gateway class and / or client class which returns mocked or fake data.
Generally it is planned to provide a full test mode.
PHP compatibility
Please use the following table to check which version can be used for your PHP version
| PHP Version | Newest hue-it version | Supported |
|---|---|---|
| v8.2 | v0.3.* | ✅ |
| v8.1 | v0.3.* | ✅ |
| v8.0 | v0.3.* | ✅ |
| v7.4 | v0.2.* | ❌ |
Roadmap
- Test mode
- Creating / Deleting / Editing groups and lights
- Capabilities API
- Update handling (Bridge & Light Updates)
- Implement more entities: Schedules, Scenes, Sensors, Rules, etc.
- Configure transition times
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Jordan Kniest
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of hue-it with dependencies
symfony/http-client Version ^6.0
ozdemirburak/iris Version ^3.0
illuminate/collections Version ^9.0