tiny-blocks/currency

Value Object representing a currency using ISO-4217 specifications.

2.3.0 2026-01-15 12:21 UTC

Requires

• php: ^8.5

Requires (Dev)

• infection/infection: ^0.32
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5
• squizlabs/php_codesniffer: ^4.0

MIT

• Gustavo Freze de Araujo Santos

• currency
• psr
• currencies
• value-object
• vo
• iso-4217
• tiny-blocks

README

• Overview
• Installation
• How to use
• License
• Contributing

Overview

Value Object representing a currency using ISO-4217 specifications.

Installation

composer require tiny-blocks/currency

How to use

The library exposes a concrete implementation through the Currency enum. Besides, the alphabetic code, you can get the default amount fraction digits for the respective currency.

$currency = Currency::USD;

$currency->name;                # USD
$currency->value;               # USD
$currency->getFractionDigits(); # 2

License

Currency is licensed under MIT.

Contributing

Please follow the contributing guidelines to contribute to the project.