Download the PHP package desmart/laravel-money without Composer
On this page you can find all versions of the php package desmart/laravel-money. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-money
Laravel Money 💶
Package provides a simple wrapper around \Money\Money objects creation and formatting.
Minimum Laravel version is 8.12.0
Installation
To install the package via Composer, simply run the following command:
Usage
Package provides three main elements:
- money objects factory,
- money objects formatter,
- money objects casting class.
Factory
Factory streamlines \Money\Money objects instantiation. \Money\Money objects can be created using either integer or
float values.
Default currency
In case application does not handle multiple currencies, it is recommended to set up default currency to the required one. It speeds up coding and make code less error prone. Default currency can be set up in a very easy way:
Formatter
To pretty print money value, simply call \DeSmart\Larvel\Money\MoneyFormatter::prettyPrint($money). prettyPrint
method accepts also a second parameter that indicates if the formatted value should contain html entities -
effectively, every space in the formatted value will be replaced with  .
\DeSmart\Larvel\Money\MoneyFormatter behind the scenes uses registered formatter class. If no custom class is
registered, default \Money\Formatter\DecimalMoneyFormatter formatter will be used.
This package ships with an additional formatter, \DeSmart\Larvel\Money\Formatters\IntlDecimalMoneyFormatter, which
allows defining a particular format in which money value should be presented. There are few defaults (as consts):
- display only amount (
{AMOUNT}), - display currency code and amount (
{CURRENCY}{AMOUNT}), - display currency code and amount, separated with space (
{CURRENCY}{SPACE}{AMOUNT}), - display amount and currency code(
{AMOUNT}{CURRENCY}), - display amount and currency code, separated with space (
{AMOUNT}{SPACE}{CURRENCY}). - display currency symbol and amount (
{CURRENCY_SYMBOL}{AMOUNT}), - display currency symbol and amount, separated with space (
{CURRENCY_SYMBOL}{SPACE}{AMOUNT}), - display amount and currency symbol (
{AMOUNT}{CURRENCY_SYMBOL}), - display amount and currency symbol, separated with space (
{AMOUNT}{SPACE}{CURRENCY_SYMBOL}).
Any other format can be used, as long as it utilizes four keywords: {AMOUNT}, {CURRENCY}, {CURRENCY_SYMBOL}, {SPACE}.
Along with the format, decimal and thousands separators can be defined.
Registering formatter is fairly easy:
Credits to PruvoNet/price-extractor for the currency symbols list.
Laravel model attribute casting
Package provides also a custom casting class that allows to use \Money\Money objects with Laravel models.
By default, while casting value to money object, currency attribute will be used as a currency (or default application
currency if there is no currency attribute in the model). If there is a need for custom attribute name from which
currency is taken, such an attribute can be defined in model's $casts array, like this:
Casting class gets/sets money-like value from/to the model and also has a method for serializing \Money\Money objects
to an array (when toArray or toJson methods are used on the model):
Changelog
Please see CHANGELOG for more information what has changed recently.
License
The MIT License (MIT). Please see License File for more information.
