The Laravel team released 8.23 yesterday with a new
sole() query builder method, enhancements to
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’
DB::table('products')->where('ref', '#123')->sole()will return the only record that matches the criteria, if no records found a
RecordsNotFoundExceptionwill be thrown, and if multiple records were found a
MultipleRecordsFoundExceptionwill 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);
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:
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 extra space on blade class components that are inline (#35874)
- Fixed serialization of rate limited middleware (f3d4dcb, #35916)
Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.