crixuamg/laravel-decorators

9.0.0-beta-13 2023-12-29 20:55 UTC

Requires

• php: *
• crixuamg/laravel-responsable: 0.*
• illuminate/console: *
• illuminate/contracts: *
• illuminate/database: *
• illuminate/http: *
• illuminate/pagination: *
• illuminate/support: *
• illuminate/validation: *

Requires (Dev)

• barryvdh/laravel-ide-helper: ^2.13
• friendsofphp/php-cs-fixer: ^3.14
• mockery/mockery: ^1.5
• nunomaduro/phpinsights: ^2.7
• orchestra/testbench: ^7.22
• phpmd/phpmd: ^2.13
• phpunit/phpunit: ^9.6
• squizlabs/php_codesniffer: ^3.7

MIT

• Christian Kaal

• pattern
• laravel
• decorator
• crixuamg

README

About
Installation
Usage
Customization
Commands

Installation

Put the following in your composer.json file:

    "require": {
        "crixuamg/laravel-decorators": "^6.0.0",
        // ...
    }

Usage

After publishing the config file, register your decorators as shown in the bottom of the file. Then extend the AbstractController in a controller and call $this->setup() in the __construct() using the key created in the config file.

Example:\
UserController

```php
use \CrixuAMG\Decorators\Http\Controllers\AbstractController;

class UserController extends AbstractController {
    public function __construct()
    {
        $this->setup('users', UserResource::class);
    }

    public function index() {
       return $this->forwardResourceful(__FUNCTION__);
    }
 }
```
And put the following in
config/decorators.php

```php
    'tree' => [
        'users'                => [
            'contract'  => App\Contracts\UserContract::class,
            'arguments' => [
                // First element is the deepest layer
                App\Repositories\UserRepository::class,
                App\Caches\UserCache::class,
                App\Decorators\UserDecorator::class,
            ],
        ],
    ]
```

When hitting the route linked to the index method the application will go through the UserDecorator, UserCache and UserRepository. Then it will go back through the same classes, passing the returned data and performing the required actions, like caching and firing events. After everything has been processed the data will be returned using the resource as stated in the __construct.

Customization

You can set an enabled flag within the config/decorators.php file. When this is set to false, any decorators implementing the CrixuAMG\Decorators\Caches\AbstractCache class will be ignored.

Commands

To make development even faster and easier, some commands have been created to improve ease of use.

    php artisan decorator:cache      ModelCache
    php artisan decorator:repository ModelRepository
    php artisan decorator:contract   ModelContract

Or, create all three in a single command:

    php artisan decorators:make User

For your convenience, a command has been included that automatically creates the following:

• Model
• Controller
• Contract
• Cache
• Repository
• Resource

    php artisan decorators:starter User

The following options can be used to create extra files:

• -m Creates a migration
• -d Creates a decorator
• -r Creates 4 request classes (Show, Store, Update, Delete) in app/Http/Requests/<MODEL_NAME>/