phpinnacle/money

Money value objects with Laravel, Livewire, and Filament integration.

1.0.0 2026-09-01 10:02 UTC

Requires

• php: ^8.4
• ext-intl: *
• codeat3/blade-phosphor-icons: ^2.4
• filament/filament: ^4.0|^5.0
• kwn/number-to-words: ^2.12
• spatie/laravel-package-tools: ^1.92
• symfony/intl: ^7.2|^8.0

MIT

• PHPinnacle Devs

• money
• currency
• laravel
• phpinnacle
• livewire
• filament

Published on Packagist.org on 2026-09-01 12:37 UTC

README

phpinnacle/money provides an integer-based Money value object together with currency metadata, locale-aware formatting, Eloquent attributes, Laravel validation, Livewire hydration, and Filament fields.

Features

• Monetary amounts stored as integer minor units.
• ISO 4217 currency validation, names, symbols, and fraction digits.
• Parsing and formatting for decimal input.
• Addition, subtraction, multiplication, percentages, allocation, and comparisons.
• Eloquent multi-column Attribute helper.
• JSON, Wireable, and Livewire synthesizer support.
• Filament MoneyInput, CurrencyPicker, MoneyColumn, and MoneyRangeFilter.
• English, Polish, and Russian translations and money formatting.

Installation

composer require phpinnacle/money

Laravel discovers MoneyServiceProvider automatically. The provider registers the Livewire synthesizer, views, translations, and built-in formatters. The package has no migrations, configuration, or frontend assets.

Creating and calculating money

use PHPinnacle\Money\Money;

$price = Money::parse('19.90', 'USD');
$total = $price
    ->mul(2)
    ->add(Money::parse('5.00', 'USD'));

$total->amount;   // 4480
$total->decimal(); // "44.80"
$total->format();

Operations combining Money values require matching currencies unless the other amount is zero.

Eloquent integration

Store the amount and currency in separate columns:

use Illuminate\Database\Eloquent\Casts\Attribute;
use PHPinnacle\Money\Money;

protected function price(): Attribute
{
    return Money::attribute('price', 'currency');
}

The model property is hydrated as Money, while writes update both columns.

Filament integration

use PHPinnacle\Money\Forms\CurrencyPicker;
use PHPinnacle\Money\Forms\MoneyInput;
use PHPinnacle\Money\Tables\MoneyColumn;

MoneyInput::make('price')
    ->currencies(['USD', 'EUR'], 'USD')
    ->required();

CurrencyPicker::make('currency');

MoneyColumn::make('price');

MoneyInput dehydrates to a Money instance, and MoneyColumn formats one using its currency and subunit. Livewire can bind nested amount and currency properties through the registered synthesizer.

Validation

use PHPinnacle\Money\Rules\CurrencyCode;
use PHPinnacle\Money\Rules\MoneyRule;

return [
    'currency' => [new CurrencyCode],
    'maximum' => ['required'],
    'amount' => [MoneyRule::lte('maximum')],
];

Testing

composer test

License

The MIT License (MIT). See License File.