Laravel Collection Stable Sort

Stable sort macro for Laravel Collection
Also supports sort by multiple fields

Installation

This package DOES NOT support install as a Composer Dependency.
You have to install this package manually.

1. Copy CollectionStableSortServiceProvider.php file to your Laravel Application's app/Providers directory.
2. Register service provider by adding a line below in config/app.php file's providers array. App\Providers\CollectionStableSortServiceProvider::class
   or check this to how to register a service provider.

Requirements

• PHP >= 7.0
• Laravel >= 5.5

Usage

Sort by value (ascending order)

$collection->stableSort();

Sort by single field (ascending order)

$collection->stableSort('field_name');

or

$collection->stableSort(['field_name']);

or

$collection->stableSort(['field_name' => 'asc']);

Sort by single field (descending order)

$collection->stableSort(['field_name' => 'desc']);

Sort by value compare function

$collection->stableSort(function ($a, $b) { ... });

Sort by multiple fields

$collection->stableSort([
    'first',
    'second' => 'desc',
    function ($a, $b) { ... },
]);

Explanation

1. sort by 'first' field in ascending order first
2. if 'first' field is equal, then sort by 'second' field in descending order
3. if 'second' field is also same, then sort by the callback function (same as PHP's usort() function)

License

Copyright 2020 Jongmin Choe

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.