PHPackages zlt/lara-calls - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. zlt/lara-calls ActiveLibrary[Utility & Helpers](/categories/utility) zlt/lara-calls ============== A bunch of useful methods for laravel v0.0.2.5(4y ago)112MITPHPPHP ^7.3|^8.0 Since Aug 31Pushed 4y ago1 watchersCompare [ Source](https://github.com/w99910/lara-calls)[ Packagist](https://packagist.org/packages/zlt/lara-calls)[ RSS](/packages/zlt-lara-calls/feed)WikiDiscussions master Synced today READMEChangelogDependencies (1)Versions (8)Used By (0) A bunch of useful methods for Laravel ===================================== [](#a-bunch-of-useful-methods-for-laravel) Table Of Contents ----------------- [](#table-of-contents) - [Installation](#installation) - [Available Methods](#available-methods) - [Collection Macros](#collection-macros) - [onlyValues](#onlyvalues) - [pluckMultiple](#pluckmultiple) - [sortInValue](#sortinvalue) - [sortInValueDesc](#sortinvaluedesc) - [groupAndSortBy](#groupandsortby) - [groupAndSortByDesc](#groupandsortbydesc) - [validation](#validation) - [Builder Macros](#builder-macros) - [updateOrCreateWhen](#updateorcreatewhen) - [Global Helpers](#global-helpers) - [Calculate Execution Time](#calculate-execution-time) Installation ------------ [](#installation) ### Requirements [](#requirements) - php : ^7.3 or ^8.0 - laravel : ^8.0 Install via composer ``` composer require zlt/lara-calls ``` Publish config file. ``` php artisan vendor:publish --provider="Zlt\LaraCalls\LaraCallsServiceProvider" ``` Config file will contain ``` return [ /* * Define your eloquent builder class so that you can use custom Eloquent macros provided by package. */ 'builder' => \Illuminate\Database\Eloquent\Builder::class, /* * You may customize which macros you don't want to use. * Only macros provided below will not be registered. * Available Macros are 'onlyValues','pluckMultiple','updateOrCreateWhen','sortInValue','sortInValueDesc','groupAndSortBy','groupAndSortByDesc','calc_exec_time','validation'. */ 'exclude_macros' => [], ]; ``` > Note: If you've already published config, update your 'macros' in 'laravel-macros' config to use the latest methods. Available Methods ----------------- [](#available-methods) ### Collection Macros [](#collection-macros) - #### OnlyValues [](#onlyvalues) This method can be used on `Collection` instance. This will return only values and will discard first level array keys. ``` $collection = collect([ [ 'a' => 123, 'b' => 12, ], [ 'a' => 12, 'b' => 31, ] ]); dd($collection->onlyValues()->toArray()); // [ [123,12],[12,31] ]; ``` - #### PluckMultiple [](#pluckmultiple) This method can be used on `Collection` instance. This method is similar to `get()` on Eloquent Builder. You can pluck columns and their values that you only want. You can also pluck nested attributes if exists. ``` // $collection->pluckMultiple(array $keys); $collection = collect([ [ 'a' => 123, 'b' => 12, ], [ 'a' => 12, 'b' => 31, 'c' => 32, ] ]); dd($collection->pluckMultiple(['a', 'b'])); /* Illuminate\Support\Collection { all: [ [ "a" => 123, "b" => 12,], [ "a" => 12, "b" => 31,], ], } */ $collection = collect([ [ 'a' => 123, 'b' => 12, 'c' => [ 'x' => 1, ] ], [ 'a' => 12, 'b' => 31, 'c' => [ 'x' => 2, ], ] ]); //pluck nested attribute dd($collection->pluckMultiple(['a', 'c.x'])); /* Illuminate\Support\Collection { all: [ [ "a" => 123, "c.x" => 1,], [ "a" => 12, "c.x" => 2,], ], } */ ``` - #### SortInValue [](#sortinvalue) This method will sort values of certain attribute in ascending order. You can also specify key to sort values of that attribute. To sort in descending order, use [`sortInValueDesc`](#sortinvaluedesc) ``` // $collection->sortInValue(string $attributeToSort); // Sometimes you may sort attribute values by key of that attribute values. Then use $collection->sortInValue(string $attributeToSort,string $someKeyOfThatAttribute); $collection = collect([ [ 'a' => [4,5,1,3] ], [ 'a' => [5,6,1,8] ] ]); $collection->sortInValue('a'); /* Illuminate\Support\Collection {#4325 all: [ [ "a" => Illuminate\Support\Collection {#4328 all: [ 2 => 1, 3 => 3, 0 => 4, 1 => 5, ], }, ], [ "a" => Illuminate\Support\Collection {#4322 all: [ 2 => 1, 0 => 5, 1 => 6, 3 => 8, ], }, ], ], } */ $collection = collect([ [ 'a' => [ ['b' => 4], ['b' => 5], ['b' => 1], ['b' => 3]] ], [ 'a' => [ ['b' => 5], ['b' => 2], ['b' => 6], ['b' => 1]] ] ]); $collection->sortInValue('a','b'); // sort 'a' values by 'b' key of 'a' /* Illuminate\Support\Collection {#4348 all: [ [ "a" => Illuminate\Support\Collection {#4347 all: [ 2 => [ "b" => 1, ], 3 => [ "b" => 3, ], 0 => [ "b" => 4, ], 1 => [ "b" => 5, ], ], }, ], [ "a" => Illuminate\Support\Collection {#4346 all: [ 3 => [ "b" => 1, ], 1 => [ "b" => 2, ], 0 => [ "b" => 5, ], 2 => [ "b" => 6, ], ], }, ], ], } */ ``` - #### SortInValueDesc [](#sortinvaluedesc) This method is similar to [`sortInValue`](#sortinvalue) but will sort in descending order. - #### GroupAndSortBy [](#groupandsortby) This method is similar to `groupBy` but you can sort the returned collection. You can also provide a callback to modify the returned collection as you like. In order to sort the returned collection in descending order, you may use [`groupAndSortByDesc`](#groupandsortbydesc) method. ``` //$collection->groupAndSortBy(string $attributeKeyToGroup,string $attributeKeyToSortAfterGroup,Closure $closureToAdjustSortedCollection); $collection = collect([ [ 'name' => 'James', 'age' => 20, ], [ 'name' => 'Watson', 'age' => 24, ], [ 'name' => 'James', 'age' => 15, ] ]); dd($collection->groupAndSortBy('name','age')); /* Illuminate\Support\Collection^ {#4321 #items: array:2 [ "James" => Illuminate\Support\Collection^ {#4322 #items: array:2 [ 1 => array:2 [ "name" => "James" "age" => 15 ] 0 => array:2 [ "name" => "James" "age" => 20 ] ] } "Watson" => Illuminate\Support\Collection^ {#4325 #items: array:1 [ 0 => array:2 [ "name" => "Watson" "age" => 24 ] ] } ] } */ $collection = collect([ [ 'name' => 'James', 'age' => 20, ], [ 'name' => 'Watson', 'age' => 24, ], [ 'name' => 'James', 'age' => 15, ] ]); dd($collection->groupAndSortBy('name','age',function($collection){ return $collection->where('age','>=',24); })); // after group and sorted, adjust the sorted collection /* Illuminate\Support\Collection^ {#4313 #items: array:2 [ "James" => Illuminate\Support\Collection^ {#4311 #items: [] } "Watson" => Illuminate\Support\Collection^ {#4309 #items: array:1 [ 0 => array:2 [ "name" => "Watson" "age" => 24 ] ] } ] } */ ``` - #### GroupAndSortByDesc [](#groupandsortbydesc) The `groupAndSortByDesc` method is similar to [`groupAndSortBy`](#groupandsortby) but the returned collection is sorted in descending order. - #### Validation [](#validation) Validate the collection and perform subsequent `onSuccess` or `onError` processes. In order to validate, you may provide **array of validation rules or closure**. If you provide validation rules, you can provide a parameter inside closure in `onError` and that parameter would be an instance of `\Illuminate\Support\MessageBag`. ``` //$collection->validation(array|Closure $rulesOrClosure)->onSuccess(Closure $closure)->onError(Closure $closure); $collection = collect(['name'=>'John','email'=>'email@mail.com']); $collection->validation(['name'=>'string','email'=>'email']) ->onSuccess(function($collection){ // This will be processed return $collection; })->onError(function($messageBag){ // This will be skipped return $messageBag->toArray(); }); $collection = collect(['name'=>'John','email'=>'email']); $collection->validation(['name'=>'string','email'=>'email']) ->onSuccess(function($collection){ //This step will be skipped. return $collection; })->onError(function($messageBag){ return $messageBag->toArray(); }); // [ "email" => [ "The email must be a valid email address.", ], ] $collection->validation(function($collection){ return false; //Return type must be 'boolean'.Otherwise, it will always return false.}) ->onSuccess(function($collection){ //This step will be skipped. return $collection; })->onError(function(){ //Perform some process after failing validation }); ``` Builder Macros -------------- [](#builder-macros) - #### updateOrCreateWhen [](#updateorcreatewhen) This method is like Laravel's `updateOrCreate` method, but it accepts closure whether it should update or not if value is already existed. You can use this method with Eloquent. ``` $food = Food::updateOrCreateWhen(['name' => 'sushi',], [ 'price' => 100, ]); dd($food->price); //100 $food = Food::updateOrCreateWhen(['name' => 'sushi'], [ 'price' => 200 ], function ($oldValue, $newValue) { return true; }); dd($food->price); //200; $food = Food::updateOrCreateWhen(['name' => 'sushi'], [ 'price' => 300 ], function ($oldValue, $newValue) { return false; }); dd($food->price); //200; ``` Global Helpers -------------- [](#global-helpers) - #### Calculate Execution Time [](#calculate-execution-time) Calculate your function execution time in seconds. ``` $time = calc_exec_time(function(){ sleep(5); return 'test'; }); dd($time); //"5.0008" ``` ### Health Score 23 — LowBetter than 27% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~13 days Recently: every ~19 days Total 7 Last Release 1631d ago PHP version history (2 changes)v0.0.1.1PHP ^7.3|^8.0 v0.0.2.2PHP ^7.0|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/8cc3500e43c9d8366ea5b2b974176026c785ee56a3f93445a5262f155e9d37c9?d=identicon)[zawlintun](/maintainers/zawlintun) --- Top Contributors [![w99910](https://avatars.githubusercontent.com/u/65523475?v=4)](https://github.com/w99910 "w99910 (26 commits)") --- Tags laravelmacrolaravel-helpersmacroslaravel macroslaravel callablelara-calls ### Embed Badge ![Health badge](/badges/zlt-lara-calls/health.svg) ``` [![Health](https://phpackages.com/badges/zlt-lara-calls/health.svg)](https://phpackages.com/packages/zlt-lara-calls) ``` ### Alternatives [livewire/volt An elegantly crafted functional API for Laravel Livewire. 4195.3M84](/packages/livewire-volt)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers)[forxer/laravel-gravatar A library providing easy gravatar integration in a Laravel project. 4235.6k](/packages/forxer-laravel-gravatar)[werxe/laravel-collection-macros Custom Laravel Collection macros. 2625.8k](/packages/werxe-laravel-collection-macros)[appstract/laravel-response-macros Extra Response Macro's for Laravel 321.5k](/packages/appstract-laravel-response-macros) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)