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

masteringlaravel logo
Laravel Code Review

Get expert guidance in a few days with a Laravel code review

Visit Laravel Code Review

The latest

View all →
Mastering Laravel Testing: A Video Course on Laravel Tests image

Mastering Laravel Testing: A Video Course on Laravel Tests

Read article
NativePHP Mobile Security Advisories: Update to 4.6.1 image

NativePHP Mobile Security Advisories: Update to 4.6.1

Read article
Volker Dusch on the PHP RCE Vulnerabilities and Disclosure image

Volker Dusch on the PHP RCE Vulnerabilities and Disclosure

Read article
Decide with Jev: Turn AI Answers into Decisions with PHP Rules image

Decide with Jev: Turn AI Answers into Decisions with PHP Rules

Read article
Skuul: Open-Source School Management Built on Laravel image

Skuul: Open-Source School Management Built on Laravel

Read article
Laravel Read Replicas: Prevent Stale Reads After a Write image

Laravel Read Replicas: Prevent Stale Reads After a Write

Read article