New in Symfony 6.2: Finder Improvements
Symfony 6.2 is backed by:
Warning: This post is about an unsupported Symfony version. Some of this information may be out of date. Read the most recent Symfony Docs.
The Finder component provides utilities to find files/directories via multiple filter and sort methods. In Symfony 6.2 we're adding new sorting methods to it.
Contributed by
Robert Fischer
in #46591.
The Finder component already includes methods to filter files/directories by file extension and or/size, but you couldn't sort results based on them. In Symfony 6.2 we've added new methods to sort by file extension and/or size:
1 2 3 4 5 6 7
use Symfony\Component\Finder\Finder;
$finder = (new Finder())
->in(__DIR__)
// ...
->sortByExtension()
->sortBySize();
Contributed by
Hubert Moreau
in #46126.
In Symfony 6.2 we've also added a new method to sort files/directories by their
names in a case-insensitive way. Internally, it uses the strcasecmp()
PHP
function to perform the sorting:
1 2 3 4 5 6 7 8 9 10 11 12
$finder = (new Finder())
->in(__DIR__)
// ...
// this sorts results case-insensitive and using the "machine sorting" algorithm
// e.g. "file1.txt", "File10.txt", "File2.txt", "file3.txt"
->sortByCaseInsensitiveName()
// this sorts results case-insensitive and using the "natural sorting" algorithm
// e.g. "file1.txt", "File2.txt", "file3.txt", "File10.txt"
->sortByCaseInsensitiveName(useNaturalSort: true)
;
Because of their own nature, all these new methods need to retrieve all results before sorting them, so they can impact performance.
Help the Symfony project!
As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.
Comments
Comments are closed.
To ensure that comments stay relevant, they are closed for old posts.
A quick suggestion, since Symfony 6 is using PHP 8 it would be nice to use named arguments in the examples:
->sortByCaseInsensitiveName(useNaturalSort: true);
I think that better illustrates what the "true" toggles without the more verbose comment.