Laravel News Laravel News
News

Locale-aware Number Parsing in Laravel 12.15

Published
Locale-aware Number Parsing in Laravel 12.15 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v12.15.0, with Locale-aware number parsing, a string hash() helper method, inject contextual attribute values, and more:

Locale-aware Number Parsing

Mbungu Ngoma contributed three methods to the Number class to parse a localized number string to its numeric value. These methods use the Intl extension's NumberFormatter class to parse and define the format type:

use Illuminate\Support\Number;
 
Number::parse($string);
Number::parseInt($string);
Number::parseFloat($string);
 
// Pass locale
Number::parseFloat(string: $string, locale: 'de');
 
// It is also possible to pass the type to the parse method
Number::parse(
    string: $string,
    type: NumberFormatter::TYPE_INT64,
    locale: 'de',
);

See Pull Request #55725 for details.

Default Option When Retrieving an Enum

@elbojoloco contributed by passing a default Enum option when retrieving an enum via the InteractsWithData.php trait. For example, this update includes classes like Request:

// Before
$chartType = request()->enum('chart_type', ChartTypeEnum::class) ?: ChartTypeEnum::Bar;
 
// After
$chartType = request()->enum('chart_type', ChartTypeEnum::class, ChartTypeEnum::Bar);

TestResponse method to Assert a Client Error

@shane-zeng contributed the assertClientError() method on a test response:

// Before
$this->assertTrue($response->isClientError());
 
// After
$response->assertClientError();

String hash Helper Method

Istiak Tridip contributed a hash() method to the Stringable class to simplify fluent string hashing:

$appId = str('secret-unique-key')
    ->hash('xxh3')
    ->take(10)
    ->prepend('app-');
// app-0fb8aac18c

Before Laravel v12.15 you might use the ->pipe() method, which hash() simplifies for this use-case:

// Before you would pipe the string to the hash method manually
$appId = str('secret-unique-key')
    ->pipe(fn(Stringable $str) => hash('xxh3', (string) $str))
    ->take(10)
    ->prepend('app-');

See Pull Request #55767 for implementation details.

Add current_page_url to the Paginator

Mario Juárez contributed adding current_page_url to the Paginator:

$paginator->toArray()['current_page_url'];

Assert Redirect to Action

Volodya Kurshudyan contributed an assertRedirectToAction() method to assert a response redirects to a specific controller action:

$this->get('redirect-to-index')
    ->assertRedirectToAction([TestActionController::class, 'index']);

Use Context Values as a Contexual Attribute

Martin Bean contributed a #[Context()] contextual attribute you can use to inject a context value. The pull request example demonstrates reusing a seeded value defined in the context:

use App\Models\User;
use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\Context;
 
class UserSeeder extends Seeder
{
    public function run(): void
    {
        $user = User::factory()->create();
 
        // Store context data for subsequent seeders...
        Context::add('user', $user);
    }
}
 
//Reuse the `$user` context in the ChannelSeeder
use App\Models\Channel;
use App\Models\User;
use Illuminate\Container\Attributes\Context;
use Illuminate\Database\Seeder;
 
class ChannelSeeder extends Seeder
{
    public function run(
        // Retrieve context data with added type-hinting...
        #[Context('user')] User $user,
    ): void {
        $channel = Channel::factory()->create();
 
        $channel->users()->attach($user);
    }
}

See Pull Request #55760 for implementation details.

Release notes

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

v12.15.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

laravelcloud logo
Laravel Cloud

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

Visit Laravel Cloud

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article