Download the PHP package hatchyu/laravel-modular-lite without Composer

Laravel Modular Lite

A lightweight, zero-ceremony Modular Architecture package for Laravel applications. Designed for developers who want the organizational benefits of feature-based modules without the cognitive overhead of complex enterprise abstractions.

[!TIP] Building an Enterprise Application?
If you are building large-scale, complex enterprise platforms (ERP, CRM, Banking, Multi-domain systems) requiring strict Domain-Driven Design (DDD) 4-layer boundaries, CQRS (Actions/Queries/Data), and architectural testing, check out our flagship enterprise package:
👉 hatchyu/laravel-modular (composer require hatchyu/laravel-modular)

🎯 Design Philosophy: Stay Close to Laravel

If you are building an MVP, SaaS, eCommerce store, or internal tool, you don't always need 7 architectural layers (Domain Model, Contract, Repository, DTO, Action, Request, Resource, Controller) for a simple database record.

Laravel Modular Lite gives you:

• 🚀 Familiar Laravel Structure: Put your Models, Controllers, Requests, Resources, and Services in clean module folders.
• ⚡ Compiled Module Discovery: Eliminate runtime filesystem scanning in production with compiled manifest caching (php artisan module:cache).
• 🛠️ Frictionless CRUD: Generate an entire vertical CRUD slice (Model, Migration, Factory, Requests, Resource, Controller, Routes, and Tests) in a single command.
• 🩺 Self-Healing Diagnostics: Built-in php artisan module:doctor to verify PSR-4 mappings, check route syntax, and repair missing directories automatically with --fix.
• 🔌 Module Enable / Disable: Toggle modules on or off dynamically without deleting code (php artisan module:enable / module:disable).
• 🕸️ Dependency Graph & Topological Booting: Declare dependencies in module.json. Prerequisite modules boot before dependent ones automatically.
• 🛡️ Fail-Safe Dependency Guardrails: Runtime checks and CLI guardrails prevent broken states when dependencies are disabled or missing.
• 🔄 Safe Module Renaming: Rename modules and refactor namespaces, routes, views, providers, and other modules' dependency declarations.
• 🔒 Security Hardened: Path traversal immunity, migration table name sanitization, and strict regex module validation.

📂 Module Structure

When you create a module with php artisan module:make Shop, it generates a clean, conventional directory tree:

📦 Installation

Install the package via Composer:

Add the modules PSR-4 namespace to your root composer.json:

Then regenerate Composer's autoloader:

(Optional) Publish the configuration file:

🔌 Module Lifecycle & Dependencies

Every module includes a lightweight module.json manifest located at modules/{ModuleName}/module.json (auto-generated by php artisan module:make):

Enabling & Disabling Modules

Easily disable modules during maintenance or feature rollout without altering codebase structure:

When disabled, all of the module's routes, providers, migrations, views, config, and commands are automatically excluded from the application lifecycle.

Topological Boot Ordering

When modules declare dependencies, Laravel Modular Lite automatically sorts them topologically using Kahn's algorithm so that prerequisite modules (e.g., Inventory) are registered and booted before dependent modules (e.g., Shop).

How Disabled or Missing Dependencies Are Handled

If a module depends on another module that is disabled or missing:

1. At Application Boot Time: If Shop is active but depends on disabled Inventory, the system raises an explicit, actionable exception:

2. At CLI Level (Dependency Protection):

   • Protection Against Breaking Dependents: You cannot disable a prerequisite module if active modules depend on it:

   • Validation on Enable: Enabling a module validates that all required dependencies are present and enabled:
3. Health Diagnostics (php artisan module:doctor): Displays module status and flags disabled or missing dependencies directly in the health table.

🚀 Usage & Artisan Commands

1. Module Management

2. Instant CRUD Generation

Generate an entire vertical slice in one command:

This generates:

1. Models/Product.php
2. Database/Migrations/xxxx_create_products_table.php
3. Database/Factories/ProductFactory.php
4. Requests/StoreProductRequest.php & UpdateProductRequest.php
5. Resources/ProductResource.php
6. Controllers/Api/ProductController.php (pure Eloquent queries)
7. Tests/Feature/ProductControllerTest.php
8. Appends Route::apiResource('products', ProductController::class); to Routes/api.php

3. Granular Generators

⚡ Production Optimization

In production environments, avoid scanning the filesystem on every request by compiling a discovery manifest:

To clear the compiled cache:

(Integrated with native php artisan optimize and php artisan optimize:clear).

⚖️ When to Choose Lite vs Enterprise

🧪 Testing

🎨 Code Style

📄 License

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