Laravel 8.23 Released
Published on by Paul Redmond
The Laravel team released 8.23 yesterday with a new sole()
query builder method, enhancements to throw_if
and throw_unless
, and the latest changes in the 8.x branch:
Add Sole to the Query Builder
Sole was added to the query builder, which was described in the initial pull request as follows:
Similar to Django’s
get()
https://docs.djangoproject.com/en/3.1/topics/db/queries/#retrieving-a-single-object-with-get and Rails’.sole
andfind_sole_by
https://github.com/rails/rails/blob/master/activerecord/CHANGELOG.md.
DB::table('products')->where('ref', '#123')->sole()
will return the only record that matches the criteria, if no records found aRecordsNotFoundException
will be thrown, and if multiple records were found aMultipleRecordsFoundException
will be thrown.
This feature was initially contributed by Mohamed Said, and also received other updates by Mior Muhammad Zaki and Rodrigo Pedra Brum. See the release notes for full details on the commits and pull requests related to this feature.
Added Default Parameter to throw_if and throw_unless
Sjors Ottjes contributed the ability to pass a message as a second parameter:
// Currently:throw_if( $sometingIsWrong, new RuntimeException('something wrong with user '.$user->id)); // With this PR:throw_if( $sometingIsWrong, 'something wrong with user '.$user->id); // If the message is an existing class, that will be used as the exceptionthrow_if($somethingIsWrong, LogicException::class);
Release Notes
You can see the full list of new features and updates below and the diff between 8.22.0 and 8.23.0 on GitHub. The following release notes are directly from the changelog:
v8.23.0
Added
- Added
Illuminate\Database\Concerns\BuildsQueries::sole()
(#35869, 29c7dae, #35908, #35902, #35912) - Added default parameter to throw_if / throw_unless (#35890)
- Added validation support for TeamSpeak3 URI scheme (#35933)
Fixed
- Fixed extra space on blade class components that are inline (#35874)
- Fixed serialization of rate limited middleware (f3d4dcb, #35916)