Extra useful functional for Laravel >=5.5
Clone or download

README.md

Laravel Lodash

Build Status Code Coverage Code Quality Latest Stable Version Total Downloads Downloads Month License

This package adds lot of useful functionality to the Laravel >=5.5 project

Table of Contents

Installation

Install this package through Composer.

Edit your project's composer.json file to require longman/laravel-lodash

Create composer.json file:

{
    "name": "yourproject/yourproject",
    "type": "project",
    "require": {
        "longman/laravel-lodash": "~0.8"
    }
}

And run composer update

Or run a command in your command line:

composer require longman/laravel-lodash

Copy the package config to your local config with the publish command:

php artisan vendor:publish --provider="Longman\LaravelLodash\LaravelLodashServiceProvider"

Usage

General

Enable Debug Mode depending on visitor's IP Address

Add Longman\LaravelLodash\Debug\DebugServiceProvider::class in to config/app.php and specify debug IP's in your config/lodash.php config file:

    . . .
    'debug' => [
        'ips' => [ // IP list for enabling debug mode
            //'127.0.0.1',
        ],
    ],
    . . .

Add created_by, updated_by and deleted_by to the eloquent models

Sometimes we need to know who created, updated or deleted entry in the database.

For this just add Longman\LaravelLodash\Eloquent\UserIdentities trait to your model and also update migration file adding necessary columns:

    $table->unsignedInteger('created_by')->nullable();
    $table->unsignedInteger('updated_by')->nullable();
    $table->unsignedInteger('deleted_by')->nullable();

Use UUID in the Eloquent Models

For this just add Longman\LaravelLodash\Eloquent\UuidAsPrimary trait to your model and also update related migration file:

    $table->uuid('id')->primary();

Also there is possible to specify uuid version via defining uuidVersion property in the model class.

Eager loading of limited many to many relations via subquery or union

Eager load many to many relations with limit via subquery or union. For using this feature, add Longman\LaravelLodash\Eloquent\ManyToManyPreload trait to the models. After that you can use methods limitPerGroupViaUnion() and limitPerGroupViaSubQuery(). For example you want to select users and 3 related user photos per user.

    $items = (new User)->with([
        'photos' => function (BelongsToMany $builder) {
            // Select via union. There you should pass pivot table fields array
            $builder->limitPerGroupViaUnion(3, ['user_id', 'photo_id']);
            // or
            // Select via subquery
            $builder->limitPerGroupViaSubQuery(3);
        }, 'other.relation1', 'other.relation2'
    ]);
    $items = $items->get();

Now each user model have 3 photos model selected via one query. You can specify additional where clauses or order by fields before the group method call.

Redis using igbinary

Igbinary is a drop in replacement for the standard php serializer. Igbinary stores php data structures in compact binary form. Savings are significant when using Redis or similar memory based storages for serialized data. Via Igbinary repetitive strings are stored only once. Collections of Eloquent objects benefit significantly from this.

By default Laravel does not provide an option to enable igbinary serializer for PhpRedis connection and you have to use LaravelLodash implementation for this.

First of all, make sure you enabled PhpRedis driver by this guide https://laravel.com/docs/5.5/redis#phpredis

After that include Cache and Redis service providers in the app.php before your App providers:

    . . .
    Longman\LaravelLodash\Cache\CacheServiceProvider::class,
    Longman\LaravelLodash\Redis\RedisServiceProvider::class,
    . . .

You can remove Laravel's Cache and Redis service providers from the config, because LaravelLodash providers are extended from them and therefore implements entire functional.

Now you can specify the serializer in your database.php under config folder:

    . . .
    'redis' => [
        'client' => 'phpredis',
        
        'default' => [
            'host'       => env('REDIS_HOST', '127.0.0.1'),
            'password'   => env('REDIS_PASSWORD', null),
            'port'       => env('REDIS_PORT', 6379),
            'database'   => 0,
            'serializer' => 'igbinary', // igbinary, php, null
        ],
    ],
    . . .

Also, you can specify other options like scan or etc. See https://github.com/phpredis/phpredis#setoption

AWS SQS Fifo Queue

Laravel by default does not supports AWS FIFO queues and this package fixes it.

You have to add QueueServiceProvider service provider in the app.php before your App providers:

    . . .
    Longman\LaravelLodash\Queue\QueueServiceProvider::class,
    . . .

You can remove Laravel's Queue service provider from the config, because LaravelLodash provider are extended from that and therefore implements entire functional.

Now you can add the new connection in the queue.php under config folder:

    . . .
    'sqs_fifo' => [
        'driver'  => 'sqs.fifo',
        'version' => 'latest',
        'key'     => env('AWS_ACCESS_KEY_ID'),
        'secret'  => env('AWS_SECRET_ACCESS_KEY'),
        'prefix'  => env('AWS_SQS_URL'),
        'queue'   => env('AWS_SQS_DEFAULT_QUEUE'),
        'region'  => env('AWS_REGION'),
        'options' => [
            'type'      => 'fifo', // fifo, normal
            'polling'   => 'long', // long, short
            'wait_time' => 20,
        ],
    ],
    . . .

ElasticSearch Integration

First of all you have to install official elasticsearch php sdk:

composer require elasticsearch/elasticsearch

After add ElasticSearchServiceProvider service provider in the app.php before your App providers:

    . . .
    Longman\LaravelLodash\ElasticSearch\ElasticSearchServiceProvider::class,
    . . .

Now you can add the configuration in the services.php under config folder:

    . . .
    'elastic_search' => [
        'enabled'          => env('ELASTICSEARCH_ENABLED', false),
        'log_channel'      => ['daily'],
        'hosts'            => [
            [
                'host' => env('ELASTICSEARCH_HOST', 'localhost'),
                'port' => env('ELASTICSEARCH_PORT', 9200),
            ],
        ],
        'connectionParams' => [
            'client' => [
                'timeout'         => env('ELASTICSEARCH_TIMEOUT', 3),
                'connect_timeout' => env('ELASTICSEARCH_TIMEOUT', 3),
            ],
        ],
    ],
    . . .

You can use ElasticSearch integration via

    $elasticsearch_manager = app(ElasticSearchManagerContract::class);
    
    // Call wrapped methods
    $elasticsearch_manager->createIndex('some-index');
    
    // Or get native client and access their methods
    $client = $elasticsearch_manager->getClient();
    $client->indices()->create($params);

Also you can perform search via searchable query object. Just create class and implement ElasticSearchQueryContract and you can pass object to performSearch method


    $elasticsearch_manager = app(ElasticSearchManagerContract::class);
    $results = $elasticsearch_manager->performSearch($query); 

Helper Functions

Function Description
p(...$values): void Add debug messages to the debugbar
get_db_query(): ?string Get last executed database query
get_db_queries(): ?array Get all executed database queries

Extended Classes

For this fuctional you should add Longman\LaravelLodash\LodashServiceProvider::class in the config/app.php file.

There is an extended classes via Laravel's builtin macros functionality

Request class

Method Description
getInt(string $name, int $default = 0): int Return request field value as a integer
getBool(string $name, bool $default = false): bool Return request field value as a boolean
getFloat(string $name, float $default = 0): float Return request field value as a float
getString(string $name, string $default = ''): string Return request field value as a string

Artisan Commands

For this fuctional you should add Longman\LaravelLodash\LodashServiceProvider::class in the config/app.php file.

Command Description
php artisan clear-all Clear entire cache and all cached routes, views, etc.
php artisan db:clear Drop all tables from database. Options:
--database= : The database connection to use.
--force : Force the operation to run when in production.
--pretend : Dump the SQL queries that would be run.
php artisan db:dump Dump database to sql file using mysqldump CLI utility. Options:
--database= : The database connection to use.
--path= : Folder path for store database dump files.
php artisan db:restore {file} Restore database from sql file using mysqldump CLI utility. Options:
--database= : The database connection to use.
--force : Force the operation to run when in production
php artisan log:clear Clear log files from storage/logs recursively. Options:
--force : Force the operation to run when in production.
php artisan user:add {email} {password?} Create a new user. Options:
--guard= : The guard to use.
php artisan user:password {email} {password?} Update/reset user password. Options:
--guard= : The guard to use.

Middlewares

Middleware Description
AllowCorsRequests Allows cross origin requests. Can be configured allowed hosts, methods and headers in the configuration file
XssSecurity Sets XSS Security headers. Can be configured excluded URI-s, etc.

Blade Directives

For this fuctional you should add Longman\LaravelLodash\LodashServiceProvider::class in the config/app.php file.

Directive Description
@datetime($date); Display relative time. Example:
$date = Carbon\Carbon::now();
@datetime($date);
@plural($count, $word) Pluralization helper. Example:
@plural(count($posts), 'post')
Produces '1 post' or '2 posts', depending on how many items in $posts there are

TODO

write more tests and add more features

Troubleshooting

If you like living on the edge, please report any bugs you find on the laravel-lodash issues page.

Contributing

Pull requests are welcome. See CONTRIBUTING.md for information.

License

Please see the LICENSE included in this repository for a full copy of the MIT license, which this project is licensed under.

Credits

Full credit list in CREDITS