Download the PHP package mohamedhekal/laravel-featurebox without Composer

Laravel FeatureBox

A simple, flexible feature toggle system for Laravel — control the visibility of features across environments, users, and conditions.

📋 Table of Contents

• Introduction
• Features
• Requirements
• Quick Start
• Installation
• Usage
• API Reference
• Feature Conditions
• Artisan Commands
• Configuration
• Database Schema
• Security
• Testing
• Roadmap
• Support
• Examples

🚀 Introduction

Laravel FeatureBox is a lightweight Laravel package that helps you manage feature flags in your application.

Whether you're rolling out features gradually, testing beta features for specific users, or disabling features in production — FeatureBox gives you full control.

Inspired by tools like LaunchDarkly, but made for Laravel.

✨ Features

• 🚀 Simple & Lightweight - Easy to install and use
• 🔧 Flexible Conditions - Support for environments, user roles, dates, and custom conditions
• ⚡ High Performance - Built-in caching support
• 🛠️ Artisan Commands - Manage features from the command line
• 🔒 Secure - No external API calls, all logic is local
• 📊 Database Storage - Features stored in your database
• 🧪 Testable - Comprehensive test suite included
• 🌍 Multi-language - Documentation in English and Arabic

📋 Requirements

• PHP >= 8.1
• Laravel >= 10.0
• MySQL/PostgreSQL/SQLite

🚀 Quick Start

📦 Installation

Install via Composer:

Then publish the config and migration files:

⚙️ Usage

Enable or disable features from the database or using Artisan commands.

Basic Usage

With Context

You can pass context to evaluate conditions:

In Blade Templates

In Controllers

📚 API Reference

Core Methods

FeatureBox::isEnabled(string $feature, array $context = []): bool

Check if a feature is enabled for the given context.

FeatureBox::isDisabled(string $feature, array $context = []): bool

Check if a feature is disabled (opposite of isEnabled).

FeatureBox::enable(string $feature, array $conditions = []): bool

Enable a feature with optional conditions.

FeatureBox::disable(string $feature): bool

Disable a feature.

FeatureBox::get(string $feature): ?array

Get detailed information about a feature.

FeatureBox::all(): array

Get all features with their status.

🧠 Feature Conditions

Each feature can include optional conditions like:

• ✅ Environments (local, staging, production)
• 👤 User roles or specific user IDs
• 📅 Start/end dates
• 🔧 Custom JSON conditions

Example Conditions

Conditions will be evaluated dynamically before enabling any feature.

🧪 Artisan Commands

Enable a Feature

Disable a Feature

List All Features

🔧 Configuration

The package configuration is located at config/featurebox.php:

Environment Variables

📊 Database Schema

The package creates a features table with the following structure:

🔐 Security

All logic is scoped locally; no external API calls or tracking. You can optionally cache the features for performance using Laravel's cache system.

🧪 Testing

Example Test

✅ Roadmap

• [x] Feature toggle logic
• [x] JSON-based conditions
• [x] Artisan commands
• [x] Caching support
• [ ] Web UI dashboard
• [ ] A/B testing support
• [ ] Redis driver
• [ ] Feature analytics

🆘 Support

• Documentation: GitHub Wiki
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: [email protected]

🧑‍💻 Developed by Mohamed Hekal

Feel free to submit issues, ideas, or pull requests.

🤝 Contributing

Please see CONTRIBUTING.md for details.

📄 License

This package is open-sourced under the MIT license.

📚 Examples

E-commerce Example

Beta Testing Example

Environment-Specific Features

Gradual Rollout