pinoox/numera-laravel

Laravel integration for pinoox/numera

2.1.0 2026-05-25 19:36 UTC

Requires

• php: ^8.0
• illuminate/support: ^9.0|^10.0|^11.0
• pinoox/numera: ^2.1

Requires (Dev)

• orchestra/testbench: ^7.0|^8.0|^9.0
• phpunit/phpunit: ^10.5

MIT

• Pinoox

README

Laravel integration for pinoox/numera — number-to-words with Facade and config.

Who should use this?

Project type	Install
Laravel 9 / 10 / 11	composer require pinoox/numera-laravel
Plain PHP, other frameworks	pinoox/numera only

pinoox/numera is installed automatically as a dependency. You do not need composer require pinoox/numera separately in Laravel apps.

Requirements

• PHP ^8.0
• Laravel 9, 10, or 11
• illuminate/support ^9.0 | ^10.0 | ^11.0

Installation

composer require pinoox/numera-laravel

Laravel auto-discovers:

• Pinoox\Numera\Laravel\NumeraServiceProvider
• Facade alias Numera → Pinoox\Numera\Laravel\Facades\Numera

Configuration

Publish config once:

php artisan vendor:publish --tag=numera-config

config/numera.php:

Key	Description
default_locale	Locale on boot (e.g. en, fa, fa-IR)
fallback_locale	Used when a translation key is missing

return [
    'default_locale' => 'en',
    'fallback_locale' => 'en',
];

Usage

use Pinoox\Numera\Laravel\Facades\Numera;

echo Numera::n2w(2024);
echo Numera::toYear(2024);
echo Numera::toCurrency(1500, 'USD');

Numera::setLocale('fa');
echo Numera::n2w('۱۲۳۴');

All public methods on Pino\Numera work on the facade (n2w, w2n, toOrdinal, toFraction, toPhone, toIp, …).

Service container

Singleton binding key: numera

/** @var \Pino\Numera $numera */
$numera = app('numera');

Core library documentation

• pinoox/numera README — API reference, locales, strategies
• CHANGELOG (numera)

Development

composer install
vendor/bin/phpunit

License

MIT — see LICENSE.