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.

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
PayZephyr: One Payment API for Stripe, Paystack, and PayPal image

PayZephyr: One Payment API for Stripe, Paystack, and PayPal

Read article
Bifrost Turns One With AI Builds and New Workflows image

Bifrost Turns One With AI Builds and New Workflows

Read article
Preview Blade Templates in macOS Finder with Quick Blade image

Preview Blade Templates in macOS Finder with Quick Blade

Read article
Artisan Debugging Commands in Laravel Telescope 5.24.0 image

Artisan Debugging Commands in Laravel Telescope 5.24.0

Read article
Queue totalSize() and JobInterrupted Event in Laravel 13.31 image

Queue totalSize() and JobInterrupted Event in Laravel 13.31

Read article
Find Unexpected Test Inputs with Fuzz for Pest image

Find Unexpected Test Inputs with Fuzz for Pest

Read article