Laravel Tutorials

Accessing Locale and Currency Defaults in Laravel

Published
Accessing Locale and Currency Defaults in Laravel image

Laravel's Number facade has been enhanced with convenient methods for retrieving default locale and currency settings, simplifying internationalization in your applications. These additions streamline the process of handling regional settings and currency formatting, particularly useful when building applications that serve users across different regions.

use Illuminate\Support\Number;
// Quick access to defaults
$locale = Number::defaultLocale();
$currency = Number::defaultCurrency();

Let's explore a practical example of an international order processing system:

<?php
 
namespace App\Services;
 
use App\Models\Order;
use Illuminate\Support\Number;
use App\Events\OrderProcessed;
 
class OrderProcessor
{
public function formatOrderSummary(Order $order, ?string $userLocale = null)
{
$locale = $userLocale ?? Number::defaultLocale();
$currency = $order->currency ?? Number::defaultCurrency();
return [
'order_number' => $order->reference,
'subtotal' => Number::currency($order->subtotal, in: $currency),
'tax' => Number::currency($order->tax, in: $currency),
'total' => Number::currency($order->total, in: $currency),
'formatted_date' => $order->created_at->locale($locale)->isoFormat('LLLL'),
'meta' => [
'display_locale' => $locale,
'currency' => $currency,
'exchange_rate' => $this->getExchangeRate(
from: Number::defaultCurrency(),
to: $currency
)
]
];
}
 
protected function getExchangeRate(string $from, string $to): float
{
// Exchange rate calculation logic
return 1.0;
}
}

These new helper methods simplify access to your application's default regional settings, making it easier to handle international formatting and currency display.

Harris Raftopoulos photo

Senior Software Engineer • Staff & Educator @ Laravel News • Co-organizer @ Laravel Greece Meetup

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