Laravel 11.2 Released

Via: Laravel News

This week, the Laravel team released v11.2, which includes a fluent() support helper, a context() helper, improved handling of a missing database during a migrate operation, and more.

Fluent Helper

Philo Hermans contributed a fluent() helper function when working with multi-dimensional arrays. The Fluent class has been in the Laravel framework for quite a while; however, this PR introduces a helper convenience method to create a fluent object instance:

$data = [
    'user' => [
        'name' => 'Philo',
        'address' => [
            'city' => 'Amsterdam',
            'country' => 'Netherlands',
        ]
    ],
    'posts' => [
        [
            'title' => 'Post 1',
        ],
        [
            'title' => 'Post 2',
        ]
    ]
];

collect($data)->get('user');
fluent($data)->user;

collect($data)->get('user')['name'];
fluent($data)->get('user.name');

collect(collect($data)->get('posts'))->pluck('title');
fluent($data)->collect('posts')->pluck('title');

json_encode(collect($data)->get('user')['address']);
fluent($data)->scope('user.address')->toJson();

Context Helper

Michael Nabil contributed a convenience context() helper function for managing Context. Depending on the arguments passed, you can either add to context, get the context object, or retrieve it (with an optional custom default):

// Add user information to the context
context(['user' => auth()->user()]);

// Retrieve the context object
$context = context();

// Retrieve user information from the context
$user = context('user');

// Optional custom default value if not found.
$some_key = context('key_that_does_not_exist', false);

Default Value for Context Getters

Michael Nabil contributed support for a default value on Context getters:

// Before: Returns null if not found
Context::get('is_user');
Context::getHidden('is_user');

// After: Returns `false` if not found
Context::get('is_user', false); // false
Context::getHidden('is_user', false); // false
Context::get('is_user'); // null

Job Chain Test Assertion Methods

Günther Debrauwer contributed assertHasChain() and assertDoesntHaveChain() methods:

public function test_job_chains_foo_bar_job(): void
{
    $job = new TestJob();

    $job->handle();

    $job->assertHasChain([
        new FooBarJob();
    ]);

    // $job->assertDoesntHaveChain();
}

Better database creation/wipe handling

Dries Vints contributed better database failure handing (#50836) when running migrate when a database isn't created yet, as well as updating the migrate:fresh command to streamline the process when a database does not exist #50838:

If the migrate:fresh command is called while there isn't any database created yet, it'll fail when it tries to wipe the database. This PR fixes this by first checking if the migrations table exists and if not, immediately go to the migrate command by skipping the db:wipe command. This will invoke the migrate command flow and subsequently will reach the point where the command will ask the user to create the database.

In combination with #50836 this will offer a more seamless experience for people attempting to install Jetstream through the Laravel installer and choosing to not create the database.

The above description is taken from Pull Request #50838.

String Trim Removes Invisible Characters

Dasun Tharanga contributed an update to the framework TrimStrings middleware, where invisible characters are not trimmed during an HTTP request, which can cause issues when submitting forms. See Pull Request #50832 for details.

Release notes

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