akaunting / laravel-money
Currency formatting and conversion package for Laravel
Installs: 3 689 830
Dependents: 11
Suggesters: 0
Security: 0
Stars: 732
Watchers: 16
Forks: 101
Open Issues: 9
Requires
- php: ^8.0
- illuminate/contracts: ^9.0|^10.0|^11.0
- illuminate/support: ^9.0|^10.0|^11.0
- illuminate/validation: ^9.0|^10.0|^11.0
- illuminate/view: ^9.0|^10.0|^11.0
- vlucas/phpdotenv: ^5.4.1
Requires (Dev)
- orchestra/testbench: ^7.4|^8.0|^9.0
- phpunit/phpunit: ^9.5|^10.0|^11.0
- vimeo/psalm: ^4.23|^5.1
This package is auto-updated.
Last update: 2024-11-26 09:07:28 UTC
README
This package intends to provide tools for formatting and conversion of monetary values in an easy, yet powerful way for Laravel projects.
Why not use the moneyphp
package?
Because it uses the intl
extension for number formatting. intl
extension isn't present by default on PHP installs and can give different results in different servers.
Getting Started
1. Install
Run the following command:
composer require akaunting/laravel-money
2. Publish
Publish config file.
php artisan vendor:publish --tag=money
3. Configure
You can change the currencies information of your app from config/money.php
file
Usage
use Akaunting\Money\Currency; use Akaunting\Money\Money; echo Money::USD(500); // '$5.00' unconverted echo new Money(500, new Currency('USD')); // '$5.00' unconverted echo Money::USD(500, true); // '$500.00' converted echo new Money(500, new Currency('USD'), true); // '$500.00' converted
Advanced
$m1 = Money::USD(500); $m2 = Money::EUR(500); $m1->getCurrency(); $m1->isSameCurrency($m2); $m1->compare($m2); $m1->equals($m2); $m1->greaterThan($m2); $m1->greaterThanOrEqual($m2); $m1->lessThan($m2); $m1->lessThanOrEqual($m2); $m1->convert(Currency::GBP(), 3.5); $m1->add($m2); $m1->subtract($m2); $m1->multiply(2); $m1->divide(2); $m1->allocate([1, 1, 1]); $m1->isZero(); $m1->isPositive(); $m1->isNegative(); $m1->format();
Helpers
money(500) money(500, 'USD') currency('USD')
Blade Directives
@money(500) @money(500, 'USD') @currency('USD')
Blade Component
Same as the directive, there is also a blade
component for you to create money and currency in your views:
<x-money amount="500" /> or <x-money amount="500" currency="USD" /> or <x-money amount="500" currency="USD" convert /> <x-currency currency="USD" />
Macros
This package implements the Laravel Macroable
trait, allowing macros and mixins on both Money
and Currency
.
Example use case:
use Akaunting\Money\Currency; use Akaunting\Money\Money; Money::macro( 'absolute', fn () => $this->isPositive() ? $this : $this->multiply(-1) ); $money = Money::USD(1000)->multiply(-1); $absolute = $money->absolute();
Macros can be called statically too:
use Akaunting\Money\Currency; use Akaunting\Money\Money; Money::macro('zero', fn (?string $currency = null) => new Money(0, new Currency($currency ?? 'GBP'))); $money = Money::zero();
Mixins
Along with Macros, Mixins are also supported. This allows merging another classes methods into the Money or Currency class.
Define the mixin class:
use Akaunting\Money\Money; class CustomMoney { public function absolute(): Money { return $this->isPositive() ? $this : $this->multiply(-1); } public static function zero(?string $currency = null): Money { return new Money(0, new Currency($currency ?? 'GBP')); } }
Register the mixin, by passing an instance of the class:
Money::mixin(new CustomMoney);
The methods from the custom class will be available:
$money = Money::USD(1000)->multiply(-1); $absolute = $money->absolute(); // Static methods via mixins are supported too: $money = Money::zero();
Changelog
Please see Releases for more information on what has changed recently.
Contributing
Pull requests are more than welcome. You must follow the PSR coding standards.
Security
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see LICENSE for more information.