tiny-blocks/currency

Models ISO-4217 currencies as a PHP enum, with per-currency fraction digit resolution.

2.3.2 2026-05-18 19:00 UTC

Requires

• php: ^8.5

Requires (Dev)

• ergebnis/composer-normalize: ^2.52
• infection/infection: ^0.33
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^13.1
• squizlabs/php_codesniffer: ^4.0

MIT

• Gustavo Freze de Araujo Santos

• currency
• enum
• value-object
• iso-4217
• tiny-blocks

README

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

Overview

Models ISO-4217 currencies as a PHP enum, covering all standard currency codes with their correct number of fraction digits. Resolves edge cases such as zero-decimal currencies (JPY, KRW), three-decimal currencies (BHD, KWD), and four-decimal currencies (CLF, UYW). Backed by a native PHP enum for zero-overhead comparison and type safety.

Installation

composer require tiny-blocks/currency

How to use

The library exposes the Currency enum. In addition to the alphabetic code, the matching number of fraction digits is available for the respective currency.

<?php

declare(strict_types=1);

use TinyBlocks\Currency\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.