README

A PHP library providing ISO 4217 data.

What is ISO 4217

ISO 4217 is a standard published by the International Organization for Standardization, which delineates currency designators, country codes (alpha and numeric), and references to minor units in three tables.

-- Wikipedia

Installing

$ composer require alcohol/iso4217

Using

Code:

<?php

$iso4217 = new Alcohol\ISO4217();

$iso4217->getByAlpha3('EUR');
// or
$iso4217->getByNumeric('978');

// also
$iso4217->getAll();

Result:

Array
(
    [name] => Euro
    [alpha3] => EUR
    [numeric] => 978
    [exp] => 2
    [country] => Array
        (
            [0] => AD
            [1] => AT
            ...
            [30] => YT
            [31] => ZW
        )
)

Excluded

The following codes have been intentionally left out:

BOV Bolivian Mvdol (funds code)
CHE WIR Euro (complementary currency)
CHW WIR Franc (complementary currency)
CLF Unidad de Fomento (funds code)
COU Unidad de Valor Real (UVR) (funds code)
MXV Mexican Unidad de Inversion (UDI) (funds code)
USN United States dollar (next day) (funds code)
UYI Uruguay Peso en Unidades Indexadas (URUIURUI) (funds code)
UYW Unidad Previsional (tracks nominal wage index)
XAG Silver (one troy ounce)
XAU Gold (one troy ounce)
XBA European Composite Unit (EURCO) (bond market unit)
XBB European Monetary Unit (E.M.U.-6) (bond market unit)
XBC European Unit of Account 9 (E.U.A.-9) (bond market unit)
XBD European Unit of Account 17 (E.U.A.-17) (bond market unit)
XDR Special drawing rights
XPD Palladium (one troy ounce)
XPT Platinum (one troy ounce)
XSU Unified System for Regional Compensation (SUCRE)
XTS Code reserved for testing purposes
XUA ADB Unit of Account (African Development Bank)
XXX No currency

Also some currencies that are deprecated:

SVC El Salvador Colon
VEF The previous Venezuelan Bolívar
ZWD/ZWN/ZWR/ZWL Zimbabwean dollar(s)

Contributing

Feel free to submit a pull request or create an issue.

License

alcohol/iso4217 is licensed under the MIT license.

Source(s)

"ISO 4217" by Wikipedia licensed under CC BY-SA 3.0 Unported License

alcohol / iso4217

Maintainers

Details