danielalva / laravel-modular

dev-main 2026-10-29 17:22 UTC

Requires

• php: >=8.2
• illuminate/console: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Daniel Alva (Luis Daniel Alva Lujan)

• modules
• laravel
• modular
• architecture
• modular-monolith
• daniel-alva

Published on Packagist.org on 2026-10-29 17:29 UTC

README

Arquitectura modular profesional, elegante y ligera para Laravel (Modular Monolith) creada por Daniel Alva.

👨‍💻 Autor y Contacto

• Creador: Daniel Alva (Luis Daniel Alva Luján)
• LinkedIn: https://www.linkedin.com/in/luis-daniel-alva-lujan/
• GitHub: @luisdaniel9986

💡 ¿Por qué usar Laravel Modular?

En proyectos medianos y grandes de Laravel, las carpetas por defecto (app/Http/Controllers, app/Models, database/migrations) tienden a saturarse con cientos de archivos mezclados.

Laravel Modular resuelve esto transformando cada funcionalidad en un módulo autocontenido:

modules/
├── Productos/
│   ├── Controllers/
│   │   └── ProductoController.php
│   ├── Models/
│   │   └── Producto.php
│   ├── Migrations/
│   │   └── 2026_10_29_000000_create_productos_table.php
│   ├── Routes/
│   │   ├── web.php
│   │   └── api.php
│   ├── Views/
│   │   └── index.blade.php
│   └── Requests/
└── Ventas/
    └── ...

📦 Instalación

En tu proyecto Laravel:

composer require danielalva/laravel-modular

Gracias al Package Discovery de Laravel, el paquete se registra automáticamente.

Configurar Autoload de Composer

Añade el namespace de los módulos a tu composer.json principal:

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Modules\\": "modules/"
    }
}

Luego regenera el autoloader:

composer dump-autoload

⚡ Uso y Comandos Artisan

1. Crear un Módulo Completo

php artisan make:module Productos

Crea al instante la estructura completa del módulo con su controlador, modelo, migración base, rutas (web y api) y vista Blade.

2. Crear un Controlador en un Módulo

php artisan module:controller Productos DetalleController

3. Crear un Modelo (con migración opcional)

php artisan module:model Productos Categoria -m

4. Crear una Migración adicional

php artisan module:migration Productos add_stock_to_productos_table

🔄 Carga Automática de Componentes

• Rutas Web: Se cargan desde modules/{Modulo}/Routes/web.php con middleware web.
• Rutas API: Se cargan desde modules/{Modulo}/Routes/api.php con prefijo /api y middleware api.
• Migraciones: Se integran automáticamente a php artisan migrate.
• Vistas Blade: Se invocan usando el namespace del módulo en minúsculas:

  return view('productos::index');

⚙️ Configuración (Opcional)

Si deseas cambiar el directorio base de los módulos o deshabilitar alguna carga automática, publica la configuración:

php artisan vendor:publish --tag=modular-config

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.