Laravel News Laravel News
News

View Third-party Relations in model:show - Now Available in Laravel 11.11

Published
View Third-party Relations in model:show - Now Available in Laravel 11.11 image

This week, the Laravel team released v11.11, with support for third-party relations in the model:show command, new Collection methods, new cache events, and more.

before and after Collection Methods

Ryuta Hamasaki contributed before and after methods to Collection and LazyCollection instances

Here are examples of the before method from the pull request description:

$collection = collect([1, 2, 3, 4, 5, 'name' => 'taylor', 'framework' => 'laravel']);
 
$collection->before(2) // 1
$collection->before('taylor') // 5
$collection->before('laravel') // 'taylor'
$collection->before(fn ($value) => $value > 4) // 4
$collection->before(fn ($value) => ! is_numeric($value)) // 5
$collection->before(1) // null
$collection->before('not found') // null

Here are examples of the after method from the pull request description:

$collection = collect([1, 2, 3, 4, 5, 'name' => 'taylor', 'framework' => 'laravel']);
 
$collection->after(1) // 2
$collection->after('taylor') // 'laravel'
$collection->after(fn ($value) => $value > 4) // 'taylor'
$collection->after(fn ($value) => ! is_numeric($value)) // 'laravel'
$collection->after('laravel') // null
$collection->after('not found') // null

Cache Events

Alex Bouma contributed new cache events to the framework that applications can listen to:

use Illuminate\Cache\Events\ForgettingKey;
 
use Illuminate\Cache\Events\KeyForgetFailed;
 
use Illuminate\Cache\Events\KeyWriteFailed;
// Two public properties: `$this->value` and `$this->seconds`
 
use Illuminate\Cache\Events\RetrievingKey;
 
use Illuminate\Cache\Events\RetrievingManyKeys;
// One public property: `$this->keys`
 
use Illuminate\Cache\Events\WritingKey
// Two public properties: `$this->value` and `$this->seconds`
 
use Illuminate\Cache\Events\WritingManyKeys;
// Three public properties:
// `$this->keys`, `$this->values` and `$this->seconds`

Support Third-party Relations in model:show

Jonas Staudenmeir contributed the ability to include third-party package model relations in the model:show command:

The model:show command finds a model's relations by analyzing the code of its methods and looking for $this->hasMany( etc. This doesn't detect third-party relations (like eloquent-has-many-deep). We could build a whole system for packages to hook into, but that would be overkill, IMO.

Instead, we can check the method's return type and see if it's a subclass of the base Relation class. Not everybody uses return types, but I hope that most do nowadays.

You can learn more about this addition in Pull Request #51807.

Session ID Getter

Tim MacDonald contributed the Session::id() method to the Session facade:

Session::id();
 
// You can still use `getId()` too:
Session::getId();

Timezone and Locale Added to the about Command

Amir Khalife Soltani contributed to adding Locale and Timezone values to Laravel's about command. You can now quickly determine what the configured locale and timezone are at a glance with other important environment information:

The about command with Timezone and Locale values
The `about` command with `Timezone` and `Locale` values

422 Unprocessable Content Status Code

Dwight Watson contributed updates to the status code method for determining a 422 status code, which is now referred to as 422 Unprocessable Content instead of Unprocessable Entity. The way you interact with asserting a 422 status code hasn't changed:

$response = $this->postJson('/example', []);
$response->assertUnprocessable();

See RFC 9110: HTTP Semantics and Pull Request #51815 for details.

Add Relation::getMorphAlias() Method

Dennis Koch contributed a Relation::getMorphAlias() method

Since there is a Relation::getMorphedModel() I think it would be beneficial to add the reverse getMorphAlias.

This addition is particularly beneficial for testing, as it simplifies assertions with $this->assertDatabaseHas. Developers no longer need to recall the morph alias used:

$this->assertDatabaseHas('taskables', [
    'taskable_type' => Relation::getMorphAlias(Document::class),
    'taskable_id' => $mitigation->id,
    'task_id' => $taskB->id
]);

Release notes

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

v11.11.0

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

X X Github Github
Filed in
News

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
A simple form builder that stays out of your way image

A simple form builder that stays out of your way

Read article
Laravel AI: Trace Agent Runs With Lifecycle Events image

Laravel AI: Trace Agent Runs With Lifecycle Events

Read article
Laravel AI: Get Raw HTTP Responses and Rate Limits image

Laravel AI: Get Raw HTTP Responses and Rate Limits

Read article
Agent Run Observability in Laravel AI SDK 0.11 image

Agent Run Observability in Laravel AI SDK 0.11

Read article
Debounced Queued Event Listeners in Laravel image

Debounced Queued Event Listeners in Laravel

Read article
Statamic Mailables Viewer Previews Laravel Emails in the Control Panel image

Statamic Mailables Viewer Previews Laravel Emails in the Control Panel

Read article