1 | <?php |
||
15 | final class Currency implements CurrencyInterface |
||
16 | { |
||
17 | const DECIMAL_NUMBER_REGEXP = '(?P<amount> 0*(([1-9][0-9]*|[0-9])(\.[0-9]+)?))'; |
||
18 | const SIMPLE_CURRENCY_PATTERN = '/^'.self::DECIMAL_NUMBER_REGEXP.'$/x'; |
||
19 | const INNER_FRACTIONAL_DIGITS = 8; |
||
20 | |||
21 | /** @var Decimal */ |
||
22 | private $amount; |
||
23 | |||
24 | /** @var CurrencyType */ |
||
25 | private $currencyType; |
||
26 | |||
27 | /** |
||
28 | * @param Decimal $amount |
||
29 | * @param CurrencyType $currencyType |
||
30 | */ |
||
31 | 56 | private function __construct(Decimal $amount, CurrencyType $currencyType) |
|
40 | |||
41 | 11 | public static function fromFloat(float $amount, CurrencyType $currencyType): Currency |
|
42 | { |
||
43 | try { |
||
44 | 11 | return new self( |
|
45 | 11 | Decimal::fromFloat($amount, self::INNER_FRACTIONAL_DIGITS), |
|
46 | 8 | $currencyType |
|
47 | ); |
||
48 | 7 | } catch (InfiniteInputError $e) { |
|
49 | 2 | throw new InvalidArgumentException('Currency amounts must be finite', 0, $e); |
|
50 | 5 | } catch (NaNInputError $e) { |
|
51 | 1 | throw new InvalidArgumentException('Currency amounts must be numbers', 0, $e); |
|
52 | } |
||
53 | } |
||
54 | |||
55 | 8 | public static function fromFractionalUnits(int $amount, CurrencyType $currencyType): Currency |
|
65 | |||
66 | 64 | public static function fromString(string $amount, CurrencyType $currencyType): Currency |
|
67 | { |
||
68 | 64 | return new self( |
|
69 | 64 | self::extractNumericAmount($amount, $currencyType), |
|
70 | 32 | $currencyType |
|
71 | ); |
||
72 | } |
||
73 | |||
74 | 64 | private static function extractNumericAmount(string $amount, CurrencyType $currencyType): Decimal |
|
90 | |||
91 | /** |
||
92 | * @param CurrencyType $currencyType |
||
93 | * |
||
94 | * @return string |
||
95 | */ |
||
96 | 56 | private static function getAmountPlusIsoCodePattern(CurrencyType $currencyType): string |
|
102 | |||
103 | 48 | private static function getAmountPlusSymbolPattern(CurrencyType $currencyType): string |
|
111 | |||
112 | 8 | public static function fromDecimal(Decimal $amount, CurrencyType $currencyType): Currency |
|
113 | { |
||
114 | 8 | return new self( |
|
115 | 8 | Decimal::fromDecimal($amount, self::INNER_FRACTIONAL_DIGITS), |
|
116 | 8 | $currencyType |
|
117 | ); |
||
118 | } |
||
119 | |||
120 | 9 | public function getCurrencyType(): CurrencyType |
|
124 | |||
125 | /** |
||
126 | * {@inheritdoc} |
||
127 | */ |
||
128 | 13 | public function getAmountAsDecimal(): Decimal |
|
132 | |||
133 | /** |
||
134 | * {@inheritdoc} |
||
135 | */ |
||
136 | 24 | public function getAmountAsFractionalUnits(): int |
|
145 | |||
146 | /** |
||
147 | * {@inheritdoc} |
||
148 | */ |
||
149 | 126 | public function format(CurrencyFormatInterface $currencyFormat = null): string |
|
150 | { |
||
151 | 126 | if (is_null($currencyFormat)) { |
|
152 | 24 | $currencyFormat = CurrencyFormat::default(); |
|
153 | } |
||
154 | |||
155 | 126 | $nDecimals = $currencyFormat->getPrecision(); |
|
156 | 126 | if (is_null($nDecimals)) { |
|
157 | 110 | $nDecimals = $this->currencyType->getNumFractionalDigits() + $currencyFormat->getExtraPrecision(); |
|
158 | } |
||
159 | |||
160 | 126 | $amount = Decimal::fromDecimal($this->amount, $nDecimals); |
|
161 | |||
162 | 126 | $number = ('' === $currencyFormat->getThousandsSeparator()) |
|
163 | 110 | ? \str_replace('.', $currencyFormat->getDecimalsSeparator(), $amount->__toString()) // This is safer! |
|
164 | 16 | : \number_format( |
|
165 | 16 | $amount->asFloat(), |
|
166 | 16 | $nDecimals, |
|
167 | 16 | $currencyFormat->getDecimalsSeparator(), |
|
168 | 126 | $currencyFormat->getThousandsSeparator() |
|
169 | ); |
||
170 | |||
171 | 126 | return $this->decorate($number, $currencyFormat); |
|
172 | } |
||
173 | |||
174 | /** |
||
175 | * @param string $number |
||
176 | * @param CurrencyFormatInterface $currencyFormat |
||
177 | * |
||
178 | * @return string |
||
179 | */ |
||
180 | private function decorate(string $number, CurrencyFormatInterface $currencyFormat): string |
||
198 | |||
199 | /** |
||
200 | * {@inheritdoc} |
||
201 | */ |
||
202 | 12 | public function equals(CurrencyInterface $currency): bool |
|
209 | } |
||
210 |
Let’s assume that you have a directory layout like this:
and let’s assume the following content of
Bar.php
:If both files
OtherDir/Foo.php
andSomeDir/Foo.php
are loaded in the same runtime, you will see a PHP error such as the following:PHP Fatal error: Cannot use SomeDir\Foo as Foo because the name is already in use in OtherDir/Foo.php
However, as
OtherDir/Foo.php
does not necessarily have to be loaded and the error is only triggered if it is loaded beforeOtherDir/Bar.php
, this problem might go unnoticed for a while. In order to prevent this error from surfacing, you must import the namespace with a different alias: