README

Components это надстройка над фреймворком Laravel которая предназначена для изменения файловой архитектуры фреймворка, упрощения взаимодействия с кодом проекта и более гибкой разработки. Компонент расширяет возможности фреймворка, вносит правки в уже существующие механики, при этом не увеличивая уровень вхождения в него. С полной документацией вы можете ознакомиться перейдя по ссылке exhum4n/dev

Версии компонентов

• PHP 8.1
• Laravel 8+

Установка

Для начала вам нужно установить exhum4n/components выполнив команду из корня проекта.

composer require exhum4n/components

В файле composer.json необходимо добавить пространство имен "Components\\": "components/" в секции autoload/psr-4

    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Components\\": "components/"
        },

Быстрый старт

Для того что-бы начать пользоваться новой архитектурой, нам нужно создать новый компонент, использую команду

php artisan components:make 'Example' 

После чего в корне проекта появится новая директория components содержащая следующую структуру

Example
├─ Broadcasting
│  ├─ Events
│  └─ Listeners
├─ Commands
├─ Data
├─ Database
│  ├─ Factories
│  ├─ Migrations
│  └─ Seeds
├─ Enums
├─ Exceptions
├─ Jobs
├─ Models
│  └─ Casts
├─ Providers
│  └─ ExampleServiceProvider.php
├─ Repositories
├─ Routes
├─ Traits
└─ Services

Все директории который могут не пригодиться вы можете удалить.

Для активации компонента необходимо подключить его в файле config/app.php в секции Providers сервис провайдер который находится в директории Providers нового компонента.

    'providers' => [
        /*
         * Package Service Providers...
         */
         Components\Example\Providers\ExampleServiceProvider.php <---
    ],

Теперь компонент подключен к фреймворку и готов к использованию.