Download the PHP package oguzhantogay/philips-hue-client without Composer

Philips Hue Client for PHP

A modern, fully-featured PHP client for Philips Hue smart lights. Control lights, rooms, scenes, and schedules with an elegant API. Framework-agnostic with built-in support for Laravel, Symfony, and standalone PHP applications.

✨ Features

• 🎨 Complete Hue API v2 Support - Lights, groups, scenes, schedules, sensors
• 🔍 Auto Bridge Discovery - Automatic bridge detection using mDNS/N-UPnP
• 💡 Intuitive API - Fluent interface for natural command chaining
• 🎬 Scene Management - Create, modify, and activate scenes
• 🎭 Built-in Effects - Color loops, breathing, alerts, and custom animations
• ⚡ Event Streaming - Real-time updates via Server-Sent Events (SSE)
• 🛠️ CLI Tool - Command-line interface for quick control
• 🌐 REST API Server - Full REST API with Swagger documentation
• 📦 Framework Integration - Ready-made adapters for popular frameworks
• 🧪 Fully Tested - Comprehensive test coverage with mocked responses
• 📊 Resource Monitoring - Track energy usage and light statistics
• 🔒 Secure - Supports Hue's enhanced security mode
• 🚀 Performance - Connection pooling, caching, and retry mechanisms
• 🐳 Docker Ready - Container support for easy deployment
• 🔄 Rate Limiting - Prevents API abuse and protects bridge
• 💾 Smart Caching - Automatic caching with configurable TTL

📋 Requirements

• PHP 8.0 or higher
• Philips Hue Bridge (v2 or newer)
• Network access to Hue Bridge
• ext-json
• ext-curl (optional, for better performance)

🚀 Installation

Install via Composer:

🔧 Quick Start

Bridge Discovery & Authentication

Basic Light Control

Room/Group Control

Scenes

Advanced Effects

Schedules

Real-time Events (SSE)

🛠️ CLI Usage

The package includes a powerful CLI tool:

🌐 REST API Server

The package includes a full REST API server with Swagger documentation:

Quick Start

The API will be available at:

• API Base URL: http://localhost:8080/api
• Swagger Documentation: http://localhost:8080/docs
• Health Check: http://localhost:8080/api/health

API Endpoints

Bridge Management

• GET /api/health - Bridge connectivity status
• GET /api/bridge/info - Bridge information
• GET /api/bridge/config - Bridge configuration

Lights

• GET /api/lights - List all lights
• GET /api/lights/{id} - Get specific light
• PUT /api/lights/{id}/state - Set light state
• PATCH /api/lights/{id}/state - Update light state partially
• PUT /api/lights/{id}/name - Rename light

Groups & Rooms

• GET /api/groups - List all groups
• GET /api/rooms - List all rooms
• GET /api/zones - List all zones
• GET /api/groups/{id} - Get specific group
• POST /api/groups - Create new group
• PUT /api/groups/{id}/action - Control group
• DELETE /api/groups/{id} - Delete group

Scenes

• GET /api/scenes - List all scenes
• GET /api/scenes/{id} - Get specific scene
• POST /api/scenes - Create new scene
• PUT /api/scenes/{id}/activate - Activate scene
• DELETE /api/scenes/{id} - Delete scene

Schedules

• GET /api/schedules - List all schedules
• GET /api/schedules/{id} - Get specific schedule
• POST /api/schedules - Create new schedule
• PUT /api/schedules/{id} - Update schedule
• DELETE /api/schedules/{id} - Delete schedule

Sensors

• GET /api/sensors - List all sensors
• GET /api/sensors/{id} - Get specific sensor
• PUT /api/sensors/{id}/state - Update sensor state

Example API Usage

Environment Configuration

Create a .env file (copy from .env.example):

🔌 Framework Integration

🟠 Laravel Integration

Installation & Setup

Configuration

Environment Variables

Service Provider Registration

Usage Examples

Artisan Commands

🟡 Symfony Integration

Installation & Setup

Bundle Registration

Configuration

Environment Variables

Service Usage

Console Commands

Standalone/Vanilla PHP

🐳 Docker Development

Quick Start with Docker

Development Environment

One-Click Development

🧪 Testing

🚀 Performance Features

Connection Pooling

Caching & Retry

Rate Limiting

The REST API automatically rate limits requests to protect your bridge:

• Limit: 100 requests per minute per IP
• Headers: X-RateLimit-Limit, X-RateLimit-Remaining
• Error: HTTP 429 when exceeded

📊 Examples

Check the /examples directory for complete examples:

Basic Examples

• basic-control.php - Simple light control
• party-mode.php - Multi-room party effects
• rest-api-client.php - REST API usage examples
• working-example.php - Complete working example
• interactive-test.php - Interactive testing

Framework Integration Examples

• laravel-controller.php - Laravel controller integration
• symfony-controller.php - Symfony controller integration

Creative & Advanced Examples

• music-sync-party.php - 🎵 Music-synchronized party lighting with beat detection
• security-system.php - 🔒 Home security integration with motion alerts
• gaming-mood-lighting.php - 🎮 Gaming lighting with health bars and achievements
• weather-based-lighting.php - 🌤️ Weather-responsive ambient lighting
• biometric-health-integration.php - 💊 Health monitoring with biometric data
• smart-home-automation.php - 🏠 Complete smart home automation hub

🌟 Community Showcase

Built something awesome? Share it with us!

➕ Add your project

💬 Join the Discussion

• 🐛 Report bugs
• 💡 Request features
• 💬 General discussion
• 🆘 Get help

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

📄 License

The MIT License (MIT). Please see License File for more information.

🔗 Links

• Philips Hue API Documentation
• Report Issues
• Packagist

💖 Support

If you find this package useful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting new features
• 🍺 Buying me a coffee

Made with ❤️ by Oguzhan Togay