shetabit/transform-request

Transform laravel requests

v1.0 2019-08-27 09:21 UTC

This package is auto-updated.

Last update: 2024-10-21 21:12:11 UTC


README

Transform laravel requests

you can normalize or change request data structure with transformers.

lets normalize our data in transformers and let controllers to be much more cleaner and smaller.

List of contents

Install

Via Composer

$ composer require shetabit/transform-request

How to use

Create a new data transformer

we use transformers to transform request data.

you can run the below command in your console in order to create a new data transformer named TestTransformer.

$ composer php artisan make:transformer TestTransformer

all transformers will be created in App\Http\Transformers path.

Transformer example:

in all transformers, the transform method will transform your data into your ideal one. for example we can write the below code in it:

namespace App\Http\Transformers;

use Shetabit\Transformer\Contracts\TransformerInterface;

class TestTransformer implements TransformerInterface
{
    /**
     * transform given data
     *
     * @param array $data
     * @return array
     */
    public function transform(array $data) : array {
        /*
            input data :		
            [
                'n' => 'mahdi',
                'f' => 'khanzadi'
            ]

            transformed data:
            [
                'name' => 'mahdi',
                'family' => 'khanzadi',
                'username' => 'mahdikhanzadi'
            ]
        */

        return [
            'name' => $data['n'] ?? null,
            'family' => $data['f'] ?? null,
            'username' => ($data['n'] ?? null).($data['f'] ?? null)
        ];
    }
}

Transform requests

we can use a transformer to transform requests like the below:

namespace App\Http\Controllers;

use App\Http\Transformers\TestTransformer;
use Illuminate\Http\Request;

class TestController extends Controller
{
    public function __invoke(Request $request) {
        $data = $request->transform()->get(new TestTransformer());
        
        print_r($data)
    }
}

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email khanzadimahdi@gmail.com instead of using the issue tracker.

Credits

License

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