README

Laravel Design is the library that allows you to quickly generate the architecture you desire.

Requirements

• PHP ^8.2
• Laravel > 11

Installation

composer require gianlu-api/laravel-design

Publish Resources

php artisan vendor:publish --tag=gianlu-api:laravel-design:config

It is not mandatory to publish the config; you can create your own and specify it when running the command.

Usage

First, you will need to fill out the configuration as explained below. Once the configuration file is ready, if you are using the laravel-design configuration file run:

php artisan design

Otherwise, if you are using your own configuration file:

php artisan design --config={your_config_name}

Configurations

it is possible to generate the following types of files:

• migrations => 'migrations'
• classes => 'classes'
• interfaces => 'interfaces'
• abstract classes => 'abstract_classes'
• models => 'models'
• controllers => 'controllers'
  • options: type
• requests => 'requests'
• middlewares => 'middlewares'
• vue components => 'vue_components'
  • options: type
• react components => 'react_components'
• blade components => 'blade_views'

you can choose between these types of configuration, you can also mix them if you need

• name and path configuration

'key' => [
   [
       'name' =>'UserService',
       'path' => '/Domains/User/Domain/Services',
   ]
]

'key' => [
    'name' =>'UserService',
    'path' => '/Domains/User/Domain/Services',
]

• path and names configuration

'key' => [
    'path' => '/Domains/User/Domain/Services',
    'names' => [
        'UserRetrieverService',
        'UserDataAccessService',
    ]
]

'key' => [
    [
        'path' => '/Domains/User/Domain/Services',
        'names' => [
            'UserRetrieverService',
            'UserDataAccessService',
        ]
    ],
    [
        'path' => '/Domains/User/Domain/Dtos',
        'names' => [
            'CreateUserData',
            'UpdateUserData',
        ]
    ]
]

• name configuration

'key' => [
    'name' =>'/Domains/User/Domain/Services/UserService',
]

• mixed configuration example

'classes' => [
     [
       'name' =>'UserType',
       'path' => '/Domains/User/Domain/Enums',
    ],
    [
        'path' => '/Domains/User/Domain/Services',
        'names' => [
            'UserRetrieverService',
            'UserDataAccessService',
        ]
    ],
    [
        'path' => '/Domains/User/Domain/Dtos',
        'names' => [
            'CreateUserData',
            'UpdateUserData',
        ]
    ]
    'name' =>'/Domains/User/Domain/Repositories/UserRepository',
]

Migrations configruration

'migrations' => [
    'table' => 'test_domain',
]

'migrations' => [
    'tables' => ['test_domain', 'test_domain_2']
]

Controllers configruration

it is possible for controllers to choose whether api or resource methods should be created as allowed by Laravel, by adding to the configuration array 'type' => api for api or type => resource for resources

Vue Components Configuration

it is possible for vue components to choose options between composition_api 'type' => 'compositions' and 'type' => 'options', by default a compositions component is created

Name Passed by Command

If you want, you can also pass the domain name directly to the command, so you never have to change your config structure once it’s defined like this.

[
    "migrations" => [
        "table" => "&"
    ],
    'models' => [
        'name' => '/Domains/&/Domain/Models/&',
    ],
    "classes" => [
        [
            "path" =>"/Domains/&/Domain/Services",
            "names" => ["&RetrieverService", "&DataAccessService"]
        ],
        [
            "path" =>"/Domains/&/Domain/Repositories",
            "name" => "&Repository",
        ]
    ],
    "interfaces" => [
        "path" =>"/Domains//&/DOmain/Interfaces",
        "names" => ["&ServiceRetrieverInterface", "&DataAccessServiceInterface", "&RepositoryInterface"]
    ],
    "abstract_classes" => [
        [
            "path" =>"/Domains/&/Domain/Abstracts",
            "name" => "&Abstract",
        ]
    ],
    "requests" => [
        "name" =>"../../App/Http/&/Requests/&Request",
    ],
    "middlewares" => [
        "name" =>"../../App/Http/&/Middlewares/&Middleware",
    ],
    "resources" => [
        "name" =>"../../App/Http/&/Resources/&Resource",
    ],
    "controllers" => [
        "name" =>"../../App/Http/&/Controllers/&Controller",
    ],
];

Now you can run the command like this

php artisan design {name}

Configuration Example

First, you will need to fill out the configuration file as follows.

[
    "migrations" => [
        "table" => "users"
    ],
    'models' => [
        'name' => '/Domains/User/Domain/Models/User',
    ],
    "classes" => [
        [
            "path" =>"/Domains/User/Domain/Services",
            "names" => ["UserRetrieverService", "UserDataAccessService"]
        ],
        [
            "path" =>"/Domains/User/Domain/Repositories",
            "name" => "UserRepository",
        ]
    ],
    "interfaces" => [
        "path" =>"/Domains/User/Domain/Interfaces",
        "names" => ["UserServiceRetrieverInterface", "UserDataAccessServiceInterface", "UserRepositoryInterface"]
    ],
    "abstract_classes" => [
        [
            "path" =>"/Domains/User/Domain/Abstracts",
            "name" => "UserAbstract",
        ]
    ],
    "requests" => [
        "name" =>"../../App/Http/User/Requests/UserRequest",
    ],
    "middlewares" => [
        "name" =>"../../App/Http/User/Middlewares/UserMiddleware",
    ],
    "resources" => [
        "name" =>"../../App/Http/User/Resources/UserResource",
    ],
    "controllers" => [
        "name" =>"../../App/Http/User/Controllers/UserController",
    ],
    "blade_views" => [
         "name" => "UserPage",
    ],
    "vue_components" => [
        "name" => "UserPage",
         "path" => "js/Pages",
    ],
    "react_components" => [
        "name" => "UserPage",
        "path" => "js/Pages",
    ]
];

If you want to create only specific components, simply leave the unwanted arrays empty. For example, if you need to create only a migration, model, service, and repository.

[
    "migrations" => [
        "table" => "users"
    ],
    'models' => [
        'name' => '/Domains/User/Domain/Models/User',
    ],
    "classes" => [
        [
            "path" =>"/Domains/User/Domain/Services",
            "names" => ["UserRetrieverService", "UserDataAccessService"]
        ],
        [
            "path" =>"/Domains/User/Domain/Repositories",
            "name" => "UserRepository",
        ]
    ],
    "interfaces" => [],
    "abstract_classes" => [],
    "requests" => [],
    "middlewares" => [],
    "resources" => [],
    "controllers" => [],
    "blade_views" => [],
    "vue_components" => [],
    "react_components" => []
];

Laravel Commands

Add ../../ before the path where you want to create the class; otherwise, the class will be created following Laravel's default path. For example, for the Controller: name => ../../App/Http/User/Controllers/UserController, the Controller will be created in app/App/Http/User/Controllers/UserController. On the other hand, if we use name => UserController, it will be created in app/Http/Controllers/UserController.

Other Commands

php artisan design:class {class_name} {class_path}

php artisan design:interface {interface_name} {interface_path}

php artisan design:class:abstract {abstarct_class_name} {abstract_class_path}

php artisan design:view:vue {vue_component_name} {vue_component_path} {--type=options || compositions}

Default type for Vue components is composition api.

php artisan design:view:react {react_component_name} {react_component_path}