Tiny Blocks

Currency

tiny-blocks/currency

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

composer require tiny-blocks/currency
  • Version 2.3.3, released Aug 7, 2026
  • PHP ^8.5
  • License MIT
  • Downloads 20 a month
  • Source
  • Packagist
On this page

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.

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