garak / money-bundle
Bundle to use a single mapped currency with moneyphp/money
Installs: 232
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Type:symfony-bundle
Requires
- php: ^8.1
- doctrine/dbal: ^3.2 || ^4.0
- moneyphp/money: ^3.0 || ^4.0
- symfony/config: ^5.4 || ^6.0 || ^7.0
- symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
- symfony/form: ^5.4 || ^6.4 || ^7.0
- symfony/http-kernel: ^5.4 || ^6.4 || ^7.0
- twig/twig: ^3.4
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.42
- phpunit/phpunit: ^10.5
README
The purpose of this bundle is very simple: using the moneyphp/money
library with a single currency.
The typical use is when you need to map an amount of money to a database field. You could embed the Money object in your entity, but this is not perfectly working, because Doctrine doesn't support nullable embeddable objects.
Moreover, you probably want to use a single currency in your project, so you don't want to use a useless column for the currency itself.
With this bundle, you can just use "money" as type. It's up to you to choose if your property is nullable or not (as for any other Doctrine mapping, the default option is being not nullable). You're done: your property will be mapped to a Money EUR object (see below for customizations).
Installation
Execute composer require garak/money-bundle
.
Mapping example
<?php namespace App\Entity; use Money\Money; class Foo { public __construct( public int $id, public \DateTimeImmutable $date, public ?string $notes, public Money $payment, ) { } }
<?xml version="1.0" encoding="utf-8"?> <doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://doctrine-project.org/schemas/orm/doctrine-mapping https://doctrine-project.org/schemas/orm/doctrine-mapping.xsd" > <entity name="App\Entity\Foo"> <id name="id"/> <field name="date" type="date_immutable"/> <field name="notes" type="text" length="65535" nullable="true"/> <field name="payment" type="money"/> </entity> </doctrine-mapping>
Form type extension
This bundle configures a form type extension for the Symfony MoneyType, which does two things:
- set the default option of
divisor
to100
(which should be the value to use with most currencties) - cast the submitted value to integer, which is the format expected by
moneyphp/money
You don't need to do anything to use this extension, which is automatically applied.
Twig extension
This bundle exposes a Twig filter called "money". It's useful to format the value of your money property.
Example:
{# if the value in the database is 5099, this will display "€50,99" #} {{ foo.payment|money }}
Customizations
You can use a currency different from EUR. Also, you can customize the separators used by the Twig extension, and have the symbol after the amount:
money: currency: CHF # default "EUR" decimal: "." # default "," thousands: "," # default "." after: true # default false