Laravel 9.14 Released

The Laravel team released 9.14 with migration table comments for MySQL and Postgres, a dynamic trashed factory state, a new array key helper, bootable/setup test traits, and more:

Today's Laravel release supports adding comments to tables as well as a new built-in "trashed" factory state 🎁 Enjoy! pic.twitter.com/nKuWjzUcuw

— Taylor Otwell 🪐 (@taylorotwell) May 24, 2022

Migration table comments for MySQL and Postgres

Andrew Broberg contributed the ability to add table comments for MySQL and Postgres migrations:

Schema::table('posts', function (Blueprint $table) {
    $table->comment('This is a comment');
});

The author of this PR describes further:

This feature is useful for us so that our Business Intelligence team can better understand our database schema. We can already add comments on columns, adding comments on the table itself will also be beneficial in helping describe it.

Dynamic "trashed" factory state

Jason McCreary contributed dynamic support of a "trashed" factory state for models using soft deletes:

// in Factory class
public function trashed()
{
    return $this->state([
        'deleted_at' => now()->subDay(),
    ]);
}

Array prependKeysWith() helper

David Heremans contributed a new array helper to prepend all key names in an associative array quickly:

Arr::prependKeysWith(['key' => 'value'], 'prefix.');

// ['prefix.key' => 'value']

Bootable traits in tests

Pascal Baljet contributed a "bootable" trait feature from Eloquent to the base TestCase class (see also Pull Request #39883 for prior art related to this feature). This feature works by using a trait on a test case that has a method prefixed with setUp combined with the trait's name (i.e., Foo trait with a method setUpFoo()):

trait RefreshSomeService
{
    public function setUpRefreshSomeService()
    {
        SomeService::refresh();
    }
}

class SomeServiceTest extends TestCase
{
    use RefreshDatabase;
    use RefreshSomeService;
}

Release Notes

You can see the complete list of new features and updates below and the diff between 9.13.0 and 9.14.0 on GitHub. The following release notes are directly from the changelog

v9.14.0 - 2022-05-24

Added

• Added ability to add table comments for MySQL and Postgres (#42401)
• Added dynamic trashed factory state (#42414)
• Added Illuminate/Collections/Arr::prependKeysWith() (#42448)
• Added bootable traits to TestCase (#42394)

Fixed

• Fix clone issue on updateOrCreate and firstOrCreate (#42434)
• Prevent double sanitized key in RateLimiter@tooManyAttempts (#42462)
• Add flush handler to output buffer for streamed test response (bugfix) (#42481)

Changed

• Adds attaches a concise error message to SES exceptions (#42426)
• Use duplicate instead of createFromBase to clone request when routes are cached (#42420)
• Use model route key when route parameter does not specifiy custom binding field but a different parameter does (#42425)
• Adds ability to have paginate() $perPage parameter as callable with access to $total (#42429)
• Extract ServeCommand env list to static property (#42444)
• Use route parameters in view (#42461)