Laravel 8.59 Released

News

September 8th, 2021

laravel8.jpg

The Laravel team released 8.59 with new morph convenience methods, disallowing class morphs, merging defaults to validated inputs, quiet model factory creation, and the latest changes in the v8.x branch.

"whereMorphedTo()" Convenience Method

Toby Zerner contributed a whereMorphedTo and orWhereMorphedTo methods to the Eloquent builder:

1$feedback = Feedback::query()
2 ->where('subject_type', $model->getMorphClass())
3 ->where('subject_id', $model->getKey())
4 ->get();
5 
6// Can be written as
7$feedback = Feedback::whereMorphedTo('subject', $model)->get();

Check out Pull Request #38668 for more details.

Disallow Class Morphs

Oliver Nybroe contributed a new prevention flag for models that disallows morphs without a morph map:

1Relation::enforceMorphMap([
2 'user' => User::class,
3]);

When a model does not have a morph map registered, a ClassMorphViolationException will be thrown.

Merge Validated Input

Mohamed Haj contributed a merge() method to merge items to validated inputs:

1$validator = Validator::make(
2 ['name' => 'Taylor'],
3 ['name' => 'required']
4);
5 
6$validator->safe()->merge(['role' => 'Admin']);
7 
8User::create($validator->safe()->all());

Assertable JSON Each Method

Tom Witkowski contributed an each() method (similar to first()) on the AssertableJson to assert on each element of the current JSON. Here's an example of how it works from the pull request tests:

1$assert = AssertableJson::fromArray([
2 'foo' => [
3 'key' => 'first',
4 ],
5 'bar' => [
6 'key' => 'second',
7 ],
8]);
9 
10$assert->each(function (AssertableJson $item) {
11 $item->whereType('key', 'string');
12});

Quiet Factory Creation

Taylor Otwell contributed a createOneQuietly and createManyQuietly method for model factories that can create one or many models and persist them to the database without model events. See allow quiet creation ยท laravel/framework@e9cd94c for more details.

Release Notes

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

v8.59.0

Added

  • Allow quiet creation (e9cd94c)
  • Added merge() function to ValidatedInput (#38640)
  • Added support for disallowing class morphs (#38656)
  • Added AssertableJson::each() method (#38684)
  • Added Eloquent builder whereMorphedTo method to streamline finding models morphed to another model (#38668)

Fixed

  • Silence Validator Date Parse Warnings (#38652)

Changed

  • Remove mapWithKeys from HTTP Client headers() methods (#38643)
  • Return a new or existing guzzle client based on context in Illuminate/Http/Client/PendingRequest::buildClient() (#38642)
  • Show a pretty diff for assertExactJson() (#38655)
  • Lowercase cipher name in the Encrypter supported method (#38693)

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.