README

This package provides a set of powerful and flexible Artisan commands to streamline your development. It's especially suited for DDD (Domain-Driven Design) or modular architectures in laravel. This simple and customizable package enables you to rapidly scaffold modules with repository-service pattern in a Laravel application using a clean structure that includes Models, Traits, Controllers, Services, Repositories, Events, Listeners, and more — all following your custom directory conventions.

🧰 Features

Create modular components with a single command Automatically generates layered architecture (API, Backend, Frontend) Supports Events, Listeners, Repositories, Services, Requests, Policies, Views Minimal configuration needed Fully customizable module path and namespace

📦 Requirements

Minimum PHP ^8.1 Laravel ^9.0 or ^10.0

🚀 Installation

Install via Composer:

You can install the package via composer for latest version

composer require mzaman/laravel-simple-module

Then publish the config file (⚠️ must be published for proper usage):

php artisan vendor:publish --provider="LaravelSimpleModule\LaravelSimpleModuleServiceProvider" --tag="simple-module-config"

This will create a config/simple-module.php file, where you can set default module paths, namespaces, and component settings.

⚙️ Configuration (config/simple-module.php)

return [
    "request_directory" => "app/Requests",
    "request_namespace" => "App\Requests",

    "module_directory" => "app/Modules",
    "module_namespace" => "App\Modules",

    "interface_directory" => "app/Interfaces",
    "interface_namespace" => "App\Interfaces",

    "abstract_directory" => "app/Abstracts",
    "abstract_namespace" => "App\Abstracts",

    "model_directory" => "app/Models",
    "model_namespace" => "App\Models",

    "policy_directory" => "app/Policies",
    "policy_namespace" => "App\Policies",

    "repository_directory" => "app/Repositories",
    "repository_namespace" => "App\Repositories",

    "service_directory" => "app/Services",
    "service_namespace" => "App\Services",
];

🧪 Example Usage

🎯 Generate a Complete Module

php artisan make:module Blog

You will be prompted to:

Select layers (API, Backend, Frontend)
Enter model names (e.g., Post, Comment)
Choose which components to generate (Models, Events, Listeners, Controllers, Requests, etc.)

The module will be generated at:

app/Modules/Blog/
├── Events/
├── Http/
│   └── Controllers/
├── Listeners/
├── Models/
├── Policies/
├── Repositories/
├── Requests/
├── Services/
├── Traits/
└── Views/

⚙️ Optional Flags

You can customize the generation path or force overwrite existing files:

php artisan make:module Blog --path=custom/modules --force

🧱 What It Generates

Given a model Post and choosing API layer, you will get:

Models/Post.php
Repositories/PostApiRepository.php
Services/PostApiService.php
Http/Controllers/Api/PostApiController.php
Requests/StorePostRequest.php, UpdatePostRequest.php
Events/PostCreated.php, PostUpdated.php, etc.
Listeners/PostEventListener.php
Migrations, Seeders, Factories if selected

🔄 Auto-Binding

The package automatically binds:

PostApiRepositoryInterface => PostApiRepository
PostApiServiceInterface    => PostApiService

So you can type-hint interfaces in your controllers and services.

📘 Example Controller Usage

<?php

namespace App\Modules\Blog\Services\Api;

use Illuminate\Database\Eloquent\ModelNotFoundException;
use Illuminate\Database\QueryException;
use App\Modules\Blog\Repositories\Api\PostApiRepository;
use \Exception;

/**
 * Class PostApiService.
 * 
 * @extends \App\Services\BaseApiService
 * @implements PostApiServiceInterface
 */
class PostApiService extends \App\Services\BaseApiService implements PostApiServiceInterface { 

    /**
     * Set message api for CRUD
     * @param string $title
     * @param string $create_message
     * @param string $update_message
     * @param string $delete_message
     */
     protected $title = "";
     protected $create_message = "";
     protected $update_message = "";
     protected $delete_message = "";

     /**
     * Don't change $this->repository variable name
     * because used in extends service class
     */
     protected $repository;

    public function __construct(PostApiRepository $repository)
    {
      $this->repository = $repository;
    }

    // Additional methods specific to PostApiService
    // New methods for the Api Service
}

📁 File Structure

Below is the standard directory structure generated by the command tools:

app
 └── Domains
     └── V1
         └── ${Module}
             ├── Events
             │   └── ${Module}
             │       ├── ${Model}Created.php
             │       ├── ${Model}Deleted.php
             │       └── ${Model}Updated.php
             ├── Http
             │   ├── Controllers
             │   │   ├── Api
             │   │   │   └── ${Module}/${Model}Controller.php
             │   │   ├── Backend
             │   │   │   └── ${Module}/${Model}Controller.php
             │   │   └── Frontend
             │   │       └── ${Module}/${Model}Controller.php
             │   ├── Middleware
             │   └── Requests
             │       ├── Backend/${Module}
             │       │   ├── Delete${Model}Request.php
             │       │   ├── Edit${Model}Request.php
             │       │   ├── Store${Model}Request.php
             │       │   └── Update${Model}Request.php
             │       └── Frontend/${Module}
             │           └── Get${Model}Request.php
             ├── Listeners
             │   └── ${Model}EventListener.php
             ├── Models
             │   ├── Traits
             │   │   ├── Attribute/${Model}Attribute.php
             │   │   ├── Method/${Model}Method.php
             │   │   ├── Relationship/${Model}Relationship.php
             │   │   └── Scope/${Model}Scope.php
             │   └── ${Model}.php
             ├── Notifications
             │   └── Frontend
             │       └── Get${Module}Notification.php
             ├── Observers
             │   └── ${Model}Observer.php
             ├── Rules
             │   └── ${Model}Rule.php
             ├── Repository
             │   └── ${Model}Repository.php
             └── Services
                 └── ${Model}Service.php

Modules
 └── BaseModule.php

🚀 Artisan Commands

🔧 Service Generator

php artisan make:service App\Domains\V1\Analytics\Services\ChannelBackendService

🧱 Model Generator

With optional generators:

php artisan make:model Channel --path=App\Domains\V1\Analytics\Models --trait --service --repository --requests --policy --force

Examples:

php artisan make:model App\Domains\V1\Test\Models\Dummy --trait --service --repository
php artisan make:model App\Domains\V1\Test\Models\Dummy --all
php artisan make:model App\Domains\V1\Test_a\Models\Dummy --service=DemoService --repository=DemoRepository

🧬 Trait Generator

php artisan make:trait App\Domains\V1\Test_a\Models\Traits\Dummy_testApiTrait

📦 Module Generator

php artisan make:module App\Domains\V1\Subscription

🧠 Interface Generator

php artisan make:interface App\Domains\V1\Test_a\Models\Traits\Dummy_testApi

📂 View Generator

php artisan make:view backend/plan/show

🎮 Controller Generator

php artisan make:controller App\Domains\V1\Test\Http\Controllers\Api\DummyApiController --requests --repository --service --policy

With model:

php artisan make:controller App\Domains\V1\Test\Http\Controllers\Api\DummyApiController --model=App\Domains\V1\Test\Models\Dummy --api --requests --repository --service --policy

🧩 Flags Reference

Flag	Description
`--trait`	Generate trait structure for Attribute, Scope, etc.
`--service`	Create a Service class for the model
`--repository`	Create a Repository class for the model
`--requests`	Generate request classes (Store, Update, etc.)
`--policy`	Generate a Policy file
`--api`	Generate a REST-style API controller
`--resource`	Include resource methods in controller
`--plain`	Generate plain class without extra logic
`--all`	Generate everything (trait, service, repository, etc.)
`--force`	Overwrite existing files
`--model`	Specify model class for controller
`--path`	Override the default path for file generation

📌 Notes

All generation paths/namespaces are configurable in config/simple-module.php
Designed to support modular and scalable Laravel architecture
Compatible with Laravel's service-repository and policy-driven design

🧪 Testing

rm -rf vendor composer.lock && composer install && composer exec -- testbench test

License

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

mzaman / laravel-simple-module

Maintainers

Details