Laravel News Laravel News
News

Laravel 10.19 Released

Published
Laravel 10.19 Released image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v10.19 with a collection percentage method, custom event discovery class resolution, dynamic queue listener delay, and more:

Word wrap string method

Josh Bonnick contributed a wordWrap method to the Laravel String API, which splits strings within a string using a character limit. This method is a wrapper for PHP's wordwrap function:

use Illuminate\Support\Str;

$text = "A very long woooooooooooord."

// Str
Str::wordWrap(string: $text, characters: 8);
/*
A very
long
wooooooo
ooooord.
*/

// Stringable
str($text)->wordWrap(string: $text, characters: 8);

Add percentage method to collections

Wendell Adriel contributed a percentage() method to collections that allows you to calculate a percentage based on custom logic using a truth test:

$collection = new $collection([
    ['name' => 'Taylor', 'foo' => 'foo'],
    ['name' => 'Nuno', 'foo' => 'bar'],
    ['name' => 'Dries', 'foo' => 'bar'],
    ['name' => 'Jess', 'foo' => 'baz'],
]);

$collection->percentage(fn ($value) => $value['foo'] === 'foo'); // 25.00
$collection->percentage(fn ($value) => $value['foo'] === 'bar'); // 50.00
$collection->percentage(fn ($value) => $value['foo'] === 'baz'); // 25.00
$collection->percentage(fn ($value) => $value['foo'] === 'test'); // 0.00

Ability to customize class resolution in Event discovery

@bastien-phi contributed the ability to customize class resolution for Event discovery:

This PR adds the ability to customize the way the translation is done and unlocks event discovery in such DDD structures.

Here's an example of a custom callback in Pull Request #48031's tests, which illustrates how this can be used:

use Illuminate\Foundation\Events\DiscoverEvents;

DiscoverEvents::guessClassNamesUsing(function (SplFileInfo $file, $basePath) {
    return Str::of($file->getRealPath())
        ->after($basePath.DIRECTORY_SEPARATOR)
        ->before('.php')
        ->replace(DIRECTORY_SEPARATOR, '\\')
        ->ucfirst()
        ->prepend('Illuminate\\')
        ->toString();
});

Specify listener delay dynamically

@CalebW contributed support for listeners to define a withDelay() method that can determine queue listener delay:

class Listener implements ShouldQueue
{
    public function __invoke(Event $event): void
    {
        // ...
    }

    public function withDelay(Event $event): int
    {
        return $event->fooBar
            ? <short_delay>
            : <long_delay>;
    }
}

Add dynamic return types to the rescue helper

Choraimy Kroonstuiver contributed a PHPDoc update to help static analysis tools understand the generic return types of the rescue() helper. There are no code examples to see here, but the updated Docblock looks as follows after this update:

/**
 * Catch a potential exception and return a default value.
 *
 * @template TRescueValue
 * @template TRescueFallback
 *
 * @param  callable(): TRescueValue  $callback
 * @param  (callable(\Throwable): TRescueFallback)|TRescueFallback  $rescue
 * @param  bool|callable  $report
 * @return TRescueValue|TRescueFallback
 */
function rescue(callable $callback, $rescue = null, $report = true)
{
     // ...
}

// Examples:

assertType('int|null', rescue(fn () => 123));
assertType('int', rescue(fn () => 123, 345));
assertType('int', rescue(fn () => 123, fn () => 345));

You can learn more about Generics By Examples on the PHPStan blog.

Add count argument to createMany and createManyQuietly

Jordan Welch contributed the ability to pass an integer to createMany() and createManyQuietly() on model factories to create that number of models:

// Before:
$users = User::factory()->createMany([[], [], []]);

// After:
$users = User::factory()->createMany(3);

$this->assertCount(3, $users);
$this->assertInstanceOf(Eloquent\Collection::class, $users);

Release notes

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

v10.19.0

Paul Redmond photo

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

X X Github Github
Filed in
News Laravel Releases

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
Insert Middleware Before or After Existing Laravel Middleware image

Insert Middleware Before or After Existing Laravel Middleware

Read article
Laravel Herd 2: Coding Agents, Workspaces, and Cloud Deploys image

Laravel Herd 2: Coding Agents, Workspaces, and Cloud Deploys

Read article
Strict Request Input Casting in Laravel image

Strict Request Input Casting in Laravel

Read article
Prevent Duplicate File Uploads With Laravel Storage Dedupler image

Prevent Duplicate File Uploads With Laravel Storage Dedupler

Read article
Slow Job Alerts and Replica Commit IDs in Laravel 13.40 image

Slow Job Alerts and Replica Commit IDs in Laravel 13.40

Read article
Flock: A Free, Native Herd Alternative for Laravel image

Flock: A Free, Native Herd Alternative for Laravel

Read article