Laravel 8.23 Released

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 and find_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 a RecordsNotFoundException will be thrown, and if multiple records were found a MultipleRecordsFoundException 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 exception
throw_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)

Changed

• Allow a specific seeder to be used in tests in Illuminate\Foundation\Testing\RefreshDatabase::migrateFreshUsing() (#35864)
• Pass $key to closure in Collection and LazyCollection’s reduce method as well (#35878)