phpextra / sorter
Sort arrays and objects by multiple fields with unicode characters
Installs: 62 156
Dependents: 2
Suggesters: 0
Security: 0
Stars: 29
Watchers: 3
Forks: 2
Open Issues: 1
Requires
- php: >=5.3
- ext-bcmath: *
- ext-intl: >=1.0.0
This package is not auto-updated.
Last update: 2024-11-20 14:18:01 UTC
README
##Installation
Installation is done using Composer:
composer require phpextra/sorter
You can test the library using phpunit
by running the following command (assuming that you have phpunit
command available):
phpunit ./tests
Usage
###Sort using default settings
use PHPExtra\Sorter\Sorter; $data = array('ccc', 'aaa', 'bbb'); $sorter = new Sorter(); $data = $sorter->sort($data); print_r($data); // prints array('aaa', 'bbb', 'ccc');
###Sort using a specific locale
UnicodeCIComparator
(case-insensitive) comparator is the default comparator used in this library and by default during creation it uses current system locale (from php.ini).
It's worth to notice that when using this comparator, it may produce odd-looking results for numbers. For example
-1000
is greater than-100
. If you want to compare numbers by their real value, useNumericComparator
.
use PHPExtra\Sorter\Sorter; use PHPExtra\Sorter\Strategy\SimpleSortStrategy; use PHPExtra\Sorter\Comparator\UnicodeCIComparator; $strategy = new SimpleSortStrategy(); $strategy->setComparator(new UnicodeCIComparator('pl_PL')); $sorter = new Sorter($strategy); $sorter->sort(...);
###Sorting arrays keeping the keys intact
use PHPExtra\Sorter\Sorter; use PHPExtra\Sorter\Strategy\SimpleSortStrategy; use PHPExtra\Sorter\Comparator\UnicodeCIComparator; $array = array(0 => 'a', 1 => 'c', 2 => 'b'); $strategy = new SimpleSortStrategy(); $strategy->setMaintainKeyAssociation(true); $sorter = new Sorter($strategy); $sorter->sort($array); print_r($array); // prints array(0 => 'a', 2 => 'b', 1 => 'c')
###Sorting complex objects
use PHPExtra\Sorter\Sorter; use PHPExtra\Sorter\Strategy\ComplexSortStrategy; $data = array( (object)array('name' => 'Ann', 'position' => '3', 'rating' => '3'), (object)array('name' => 'Ann', 'position' => '2', 'rating' => '2'), (object)array('name' => 'Ann', 'position' => '2', 'rating' => '1'), (object)array('name' => 'Betty', 'position' => '1', 'rating' => '2'), ); $strategy = new ComplexSortStrategy(); $strategy ->setSortOrder(Sorter::ASC) ->sortBy('position') // sort by position ->sortBy('name') // sort by name if position is equal ->sortBy(function($object){return $object->rating}) // sort by rating if name is equal ; $sorter = new PHPExtra\Sorter\Sorter(); $data = $sorter->setStrategy($strategy)->sort($data); print_r($data); // prints: // // Array // ( // [0] => stdClass Object // ( // [name] => Betty // [position] => 1 // [rating] => 2 // ) // // [1] => stdClass Object // ( // [name] => Ann // [position] => 2 // [rating] => 1 // ) // // [2] => stdClass Object // ( // [name] => Ann // [position] => 2 // [rating] => 2 // ) // // [3] => stdClass Object // ( // [name] => Ann // [position] => 3 // [rating] => 3 // ) // )
###Customizing
You can create your own strategies for more complicated data sets.
Provided ComplexSortStrategy
should cover most of your needs, and if it does not, try using your own comparators.
You can replace default comparators for a whole strategy or define your own only for specific properties:
$strategy ->setSortOrder(Sorter::ASC) ->sortBy('position') ->sortBy('name', Sorter::DESC, new MyOwnPropertyComparator()) ->sortBy('rating') ; // or set your own comparator $strategy->setComparator(new MyOwnPropertyComparator());
##Contributing
All code contributions must go through a pull request.
Fork the project, create a feature branch, and send me a pull request.
##Authors
This library was inspired by https://github.com/graze/sort.
Jacek Kobus - kobus.jacek@gmail.com