artkonekt / concord by konekt

Concord is a Laravel Extension for building modular Laravel Applications
825,255
213
17
Package Data
Maintainer Username: konekt
Package Create Date: 2016-08-14
Package Last Update: 2024-05-16
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-12-22 15:00:37
Package Statistics
Total Downloads: 825,255
Monthly Downloads: 19,352
Daily Downloads: 243
Total Stars: 213
Total Watchers: 17
Total Forks: 13
Total Open Issues: 3

Concord

Concord is a Laravel Extension that helps building Modules for Laravel Applications on top of Laravel's built in Service Providers.

Travis Packagist version Packagist downloads StyleCI MIT Software License

Concord at first is a Laravel 5.4+ package. It also offers some conventions that help you to better structure complex systems.

Laravel 5.6 is supported from v1.1.0 upwards

Basics

Modular Architecture is exactly what you think it is - a way to manage the complexity of a problem by breaking them down to smaller manageable modules. -- Param Rengaiah

Concord itself (this library) manages the modules.

Concord modules are isolated fractions of the business logic, built around a single topic.

There are two kinds of modules from the usage perspective:

  • in-app modules,
  • external modules.

Concord is not aware of this difference at all, but they represent two different approaches of modularization.

In-app Modules

  • They are part of the application's codebase;
  • are located in app/Modules/<ModuleName>;
  • being decoupled is a less strict requirement;
  • code reuse and customization is not an aspect.

External Modules

  • They are libraries,
  • are typically managed with composer, thus they live in the vendor/ folder;
  • should be as decoupled as possible;
  • contain basic or boilerplate functionality for applications;
  • they are designed to be used by multiple, different applications;
  • their behavior is subject to customization in the application.

Either module types are always coupled to Laravel and Concord;

Installation

Refer to the Installation Section of the Documentation.

Create Your First Module

php artisan make:module ShinyModule

This will create a very basic in-app module in the app/Modules/ShinyModule folder.

In order to activate the module add it to the config/concord.php file:

return [
    'modules' => [
        App\Modules\ShinyModule\Providers\ModuleServiceProvider::class
    ]
];

Documenatation

See the Concord Documentation for all the nasty details ;)

Plans For Version 2.0

  • Artisan Console command names will be de-branded (eg. concord:modules -> module:list)
  • The central config/concord.php file will be eliminated, or split:
    • modules can specify their own config file name (like normal Laravel packages);
    • therefore several modules can share config files (see vanilo.php);
    • if we keep concord.php, then it'll contain concord specific settings.
  • Modules will be loaded as normal packages, using auto-discovery instead of listing modules with concord.
  • Custom names for service providers eg. CartServiceProvider instead of ModuleServiceProvider.
  • Question to the prior item is how to do the same with in-app modules.
  • Re-think the concept of boxes vs. modules.
  • Remove surplus items from Documentation.
  • Remove helpers (?).
  • Remove custom view namespace support.
  • Will we ever use Controller overriding?
  • Add make:request, make:model, make:enum commands that scaffold with interface, proxy etc.
  • Fix AddressType -> address_type kind of style problem in route parameters