PHPackages macmotp/currencies - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. macmotp/currencies ActiveLibrary[Utility & Helpers](/categories/utility) macmotp/currencies ================== Curated list of currencies in PHP v0.1.3(1y ago)07.0k↓22.5%12MITPHPPHP >=8.2 Since Sep 29Pushed 1y ago2 watchersCompare [ Source](https://github.com/macmotp/currencies)[ Packagist](https://packagist.org/packages/macmotp/currencies)[ Docs](https://github.com/macmotp/currencies)[ RSS](/packages/macmotp-currencies/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (3)Versions (8)Used By (2) Curated List of Currencies in PHP ================================= [](#curated-list-of-currencies-in-php) [![Latest Version on Packagist](https://camo.githubusercontent.com/d78ac5f46bca9e7720ec0f1e34e8dcff105b2d6e1e38646ca0333d148068c69c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d61636d6f74702f63757272656e636965732e737667)](https://packagist.org/packages/macmotp/currencies)[![Total Downloads](https://camo.githubusercontent.com/5bccdeece2958c2383e16f17618caee0f933bcaec5f72415662a815018374ce7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d61636d6f74702f63757272656e636965732e737667)](https://packagist.org/packages/macmotp/currencies) **Library to Handle Currencies in PHP, simple and light** Useful for any ecommerce, fintech, or any app that requires 💰. Requirements ------------ [](#requirements) - PHP >= 8.2 Installation ------------ [](#installation) Install the package via composer: ``` composer require macmotp/currencies ``` **This package is a main dependency for other 2 packages** - [macmotp/money](https://github.com/macmotp/money); - [macmotp/locale](https://github.com/macmotp/locale); Usage ----- [](#usage) ### Create Currency objects [](#create-currency-objects) ``` use Macmotp\Currency; use Macmotp\Currencies\Support\CurrencyCode; use Macmotp\Currencies\Support\CurrencyName; // All Currencies adopt ISO 4217 standard $currencyCode = CurrencyCode::USD; // Create the object $currency = new Currency($currencyCode); // You can also input the code as string: $currency = new Currency('USD'); // Alternative methods: $currency = Currency::make($currencyCode); $currency = Currency::fromCode($currencyCode); echo $currency->toArray(); // [ // 'name' => 'United States Dollar', // 'code' => 'USD', // 'symbol' => '$', // 'flag' => 'us', // 'format' => [ // 'show_code' => false, // 'show_symbol' => true, // 'show_space' => false, // 'show_symbol_or_code_on_left' => true, // 'show_decimals' => true, // 'decimal_separator' => '.', // 'thousands_separator' => ',', // 'number_of_decimals' => 2, // 'subunit_level' => 2, // ], // ] ``` #### List of basic methods [](#list-of-basic-methods) - `getName()`: it returns the name; - `getCode()`: it returns the code; - `getSymbol()`: it returns the symbol; - `getFlag()`: it returns the flag (country code); - `getFormat()`: it returns the currency format; - `toArray()`: it converts the object into array; ### List of Currencies in the package [](#list-of-currencies-in-the-package) ``` use Macmotp\Currency; $list = Currency::all(); // This will return a Illuminate\Support\Collection ``` These are the implemented currencies: - `AED`: United Arab Emirates Dirham - `AFN`: Afghan Afghani - `ALL`: Albanian Lek - `AMD`: Armenian Dram - `ANG`: Netherlands Antillean Guilder - `AOA`: Angolan Kwanza - `ARS`: Argentine Peso - `AUD`: Australian Dollar - `AWG`: Aruban Florin - `AZN`: Azerbaijani Manat - `BAM`: Bosnia and Herzegovina Convertible Mark - `BBD`: Barbados Dollar - `BDT`: Bangladeshi Taka - `BGN`: Bulgarian Lev - `BHD`: Bahraini Dinar - `BIF`: Burundian Franc - `BMD`: Bermudian Dollar - `BND`: Brunei Dollar - `BOB`: Bolivian Boliviano - `BRL`: Brazilian Real - `BSD`: Bahamian Dollar - `BTC`: Bitcoin - `BTN`: Bhutanese Ngultrum - `BWP`: Botswana Pula - `BYN`: Belarusian Ruble - `BZD`: Belize Dollar - `CAD`: Canadian Dollar - `CDF`: Congolese Franc - `CHF`: Swiss Franc - `CLP`: Chilean Peso - `CNY`: Chinese Yuan - Renminbi - `COP`: Colombian Peso - `CRC`: Costa Rican Colón - `CUP`: Cuban Peso - `CVE`: Cape Verdean Escudo - `CZK`: Czech Koruna - `DJF`: Djiboutian Franc - `DKK`: Danish Krone - `DOP`: Dominican Peso - `DZD`: Algerian Dinar - `EGP`: Egyptian Pound - `ERN`: Eritrean Nakfa - `ETB`: Ethiopian Birr - `EUR`: Euro - `FJD`: Fijian Dollar - `FKP`: Falkland Islands Pound - `GBP`: British Pound - `GEL`: Georgian Lari - `GHS`: Ghanaian Cedi - `GIP`: Gibraltar Pound - `GMD`: Gambian Dalasi - `GNF`: Guinean Franc - `GTQ`: Guatemalan Quetzal - `GYD`: Guyanese Dollar - `HKD`: Hong Kong Dollar - `HNL`: Honduran Lempira - `HTG`: Haitian Gourde - `HUF`: Hungarian Forint - `IDR`: Indonesian Rupiah - `ILS`: Israeli New Shekel - `INR`: Indian Rupee - `IQD`: Iraqi Dinar - `IRR`: Iranian Rial - `ISK`: Icelandic Króna - `JMD`: Jamaican Dollar - `JOD`: Jordanian Dinar - `JPY`: Japanese Yen - `KES`: Kenyan Shilling - `KGS`: Kyrgyz Som - `KHR`: Cambodian Riel - `KMF`: Comorian Franc - `KPW`: North Korean Won - `KRW`: South Korean Won - `KWD`: Kuwaiti Dinar - `KYD`: Cayman Islands Dollar - `KZT`: Kazakhstani Tenge - `LAK`: Lao Kip - `LBP`: Lebanese Pound - `LKR`: Sri Lankan Rupee - `LRD`: Liberian Dollar - `LSL`: Lesotho Loti - `LYD`: Libyan Dinar - `MAD`: Moroccan Dirham - `MDL`: Moldovan Leu - `MGA`: Malagasy Ariary - `MKD`: Macedonian Denar - `MMK`: Burmese Kyat - `MNT`: Mongolian Tögrög - `MOP`: Macanese Pataca - `MRU`: Mauritanian Ouguiya - `MUR`: Mauritian Rupee - `MVR`: Maldivian Rufiyaa - `MWK`: Malawian Kwacha - `MXN`: Mexican Peso - `MYR`: Malaysian Ringgit - `MZN`: Mozambican Metical - `NAD`: Namibian Dollar - `NGN`: Nigerian Naira - `NIO`: Nicaraguan Córdoba - `NOK`: Norwegian Krone - `NPR`: Nepalese Rupee - `NZD`: New Zealand Dollar - `OMR`: Omani Rial - `PAB`: Panamanian Balboa - `PEN`: Peruvian Sol - `PGK`: Papua New Guinean Kina - `PHP`: Philippine Peso - `PKR`: Pakistani Rupee - `PLN`: Polish Złoty - `PYG`: Paraguayan Guaraní - `QAR`: Qatari Riyal - `RON`: Romanian Leu - `RSD`: Serbian Dinar - `RUB`: Russian Ruble - `RWF`: Rwandan Franc - `SAR`: Saudi Riyal - `SBD`: Solomon Islands Dollar - `SCR`: Seychellois Rupee - `SDG`: Sudanese Pound - `SEK`: Swedish Krona - `SGD`: Singapore Dollar - `SHP`: Saint Helena Pound - `SLE`: Sierra Leonean Leone - `SOS`: Somali Shilling - `SRD`: Surinamese Dollar - `SSP`: South Sudanese Pound - `STN`: São Tomé and Príncipe Dobra - `SYP`: Syrian Pound - `SZL`: Swazi Lilangeni - `THB`: Thai Baht - `TJS`: Tajikistani Somoni - `TMT`: Turkmenistani Manat - `TND`: Tunisian Dinar - `TOP`: Tongan Paʻanga - `TRY`: Turkish Lira - `TTD`: Trinidad and Tobago Dollar - `TWD`: New Taiwan Dollar - `TZS`: Tanzanian Shilling - `UAH`: Ukrainian Hryvnia - `UGX`: Ugandan Shilling - `USD`: United States Dollar - `UYU`: Uruguayan Peso - `UZS`: Uzbekistani Sum - `VES`: Venezuelan Sovereign Bolívar - `VND`: Vietnamese Đồng - `VUV`: Vanuatu Vatu - `WST`: Samoan Tālā - `XAF`: Central African CFA Franc - `XCD`: Eastern Caribbean Dollar - `XOF`: West African CFA Franc - `XPF`: CFP Franc - `YER`: Yemeni Rial - `ZAR`: South African Rand - `ZMW`: Zambian Kwacha - `ZWG`: Zimbabwe Gold *If you want to add another currency, please open an issue.* Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [changelog](changelog.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [contributing](.github/contributing.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](.github/security.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Marco Gava](https://github.com/macmotp) License ------- [](#license) The MIT License (MIT). Please see [License File](license.md) for more information. ### Health Score 32 — LowBetter than 72% of packages Maintenance36 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community13 Small or concentrated contributor base Maturity46 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 4 Last Release 586d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c7129482467168bb595e9d67a83238d174eeb67bc71ae6cc8b0f97d34c40a58d?d=identicon)[macmotp](/maintainers/macmotp) --- Top Contributors [![macmotp](https://avatars.githubusercontent.com/u/6443339?v=4)](https://github.com/macmotp "macmotp (5 commits)") --- Tags phpcurrenciesmacmotp ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/macmotp-currencies/health.svg) ``` [![Health](https://phpackages.com/badges/macmotp-currencies/health.svg)](https://phpackages.com/packages/macmotp-currencies) ``` ### Alternatives [pragmarx/countries PHP Countries and Currencies 1.9k3.3M18](/packages/pragmarx-countries)[spatie/php-structure-discoverer Automatically discover structures within your PHP application 17824.5M57](/packages/spatie-php-structure-discoverer)[cartalyst/converter A framework agnostic measurement conversion and formatting package featuring multiple types of measurements and currency conversion. 88434.4k7](/packages/cartalyst-converter)[mindtwo/native-enum Package for using native php enums. 2626.0k1](/packages/mindtwo-native-enum)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)