Back to Blog

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

Julian Beaujardin
Julian Beaujardin June 18th, 2024

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.

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