PHPackages tnkemdilim/money-to-words-converter - 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. tnkemdilim/money-to-words-converter AbandonedArchivedLibrary[Utility & Helpers](/categories/utility) tnkemdilim/money-to-words-converter =================================== A php library that converts any money value in digit in any language or numeric system to its words in any language 2.1.0(4y ago)4451.5k↓40.2%25[1 PRs](https://github.com/TNkemdilim/Money-To-Words-Converter/pulls)MITPHPPHP ^7.2 || ^8 Since Jun 19Pushed 4y ago4 watchersCompare [ Source](https://github.com/TNkemdilim/Money-To-Words-Converter)[ Packagist](https://packagist.org/packages/tnkemdilim/money-to-words-converter)[ RSS](/packages/tnkemdilim-money-to-words-converter/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (4)Dependencies (2)Versions (7)Used By (0) Money To Words Converter ======================== [](#money-to-words-converter) [![Packagist](https://camo.githubusercontent.com/2286e0cfbfa570b6fd67ba655babb76c4f863487e6bf33dee8b97b1a177fc8a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746e6b656d64696c696d2f6d6f6e65792d746f2d776f7264732d636f6e7665727465722e737667)](https://packagist.org/packages/tnkemdilim/money-to-words-converter)[![Build Status](https://camo.githubusercontent.com/56c55aa24ce23fbed580534405963ae09e444363e10e2f3f09e3e239fa0043fb/68747470733a2f2f7472617669732d63692e6f72672f544e6b656d64696c696d2f4d6f6e65792d546f2d576f7264732d436f6e7665727465722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/TNkemdilim/Money-To-Words-Converter)[![PHP from Packagist](https://camo.githubusercontent.com/fa6344ee150d070ffcfc72f67226e1c919c9b6ed0f6704cd51bdbaa040b44a8a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f746e6b656d64696c696d2f6d6f6e65792d746f2d776f7264732d636f6e7665727465722e737667)](https://packagist.org/packages/tnkemdilim/money-to-words-converter)[![Packagist](https://camo.githubusercontent.com/cbe49327b6d1d1af122169d42dc5cc3a98318d50de86da3af5604fe70a6b495e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f746e6b656d64696c696d2f6d6f6e65792d746f2d776f7264732d636f6e7665727465722e737667)](https://packagist.org/packages/tnkemdilim/money-to-words-converter) A php library that converts any money value in digit in any language or numeric system to its words in any language Caveat ------ [](#caveat) Currently, this library relies on [stichoza/google-translate-php](https://github.com/Stichoza/google-translate-php#known-limitations) which could result in periodic `400 Bad Request` as highlighted [here](https://github.com/Stichoza/google-translate-php#known-limitations) and [here](https://github.com/tnkemdilim/Money-To-Words-Converter/issues/21). If you care about reliability, kindly checkout a managed API service I run: [Tuforty](https://tuforty.com). Installation ------------ [](#installation) - Install this package via [Composer](https://getcomposer.org). ``` composer require tnkemdilim/money-to-words-converter ``` - Or edit your project's `composer.json` to require `tnkemdilim/money-to-words-converter` and then run `composer update`. ``` "require": { "tnkemdilim/money-to-words-converter": "^2" } ``` Example ------- [](#example) For working example, checkout the [Example folder](./example). Usage ----- [](#usage) > Note: You should have composer's autoloader included `require 'vendor/autoload.php'` Always include **Converter** namespace to your php file ### Basic usage [](#basic-usage) ``` use TNkemdilim\MoneyToWords\Converter; // Nigerian currency : naira & kobo $converter = new Converter("naira", "kobo"); echo ($converter->convert(374)); echo ($converter->convert(23.45)); echo ($converter->convert(748247284782)); echo ($converter->convert(748247284782.34)); echo ($converter->convert('34')); echo ($converter->convert('2345.34')); echo ($converter->convert('3453345')); ``` ### Other Languages [](#other-languages) To convert money value to other languages, you'll need to import the `Languages` namespace ``` use TNkemdilim\MoneyToWords\Converter; use TNkemdilim\MoneyToWords\Languages as Language; $converter = new Converter("naira", "kobo", Language::FRENCH); echo ($converter->convert(23.45)); echo ($converter->convert("748247284782")); ``` Convertion From Other Numeric System ------------------------------------ [](#convertion-from-other-numeric-system) Conversion from other numeric systems are supported in-built, and by default needs no extra configuration to convert into words. > Read more about [Numeric systems](https://en.wikipedia.org/wiki/List_of_numeral_systems). ``` // Chinese numeric system $money = "八百七十二万七千八百二十四"; // Example 1 $converter = new Converter("yen", "sen"); echo ($converter->convert($money)); // Example 2: but convert money value to french $frenchConverter = new Converter("yen", "sen", Language::FRENCH); echo ($frenchConverter->convert("八百七十二万七千八百二十四")); ``` Change Currency --------------- [](#change-currency) To change the currency of the money to convert ``` // Dollars & Cents $converter->setCurrency("dollar", "cents"); echo ($converter->convert(234.34)); // two hundred and thirty-four dollars, thirty-four cents only. // Pounds & Pence $converter->setCurrency("pounds", "pence"); echo ($converter->convert('23.3')); // twenty three pounds, 3 pence only. ``` Change Language Translation --------------------------- [](#change-language-translation) Language for translation can be easily changed as follows. All available languages can be accessed via the `TNkemdilim\MoneyToWords\Languages` class. See all available in [Languages](./src/Languages.php). ``` use TNkemdilim\MoneyToWords\Languages as Language; $converter->setLanguage(Language::LATIN); $converter->setLanguage(Language::SWAHILI); $converter->setLanguage(Language::GREEK); ``` Supported Languages ------------------- [](#supported-languages) For more conversion types Language Name Code Language Name Code Language Name Code Language Name Code Afrikaans af Irish ga Albanian sq Italian it Arabic ar Japanese ja Azerbaijani az Kannada kn Basque eu Korean ko Bengali bn Latin la Belarusian be Latvian lv Bulgarian bg Lithuanian lt Catalan ca Macedonian mk Chinese Simplified zh-CN Malay ms Chinese Traditional zh-TW Maltese mt Croatian hr Norwegian no Czech cs Persian fa Danish da Polish pl Dutch nl Portuguese pt English en Romanian ro Esperanto eo Russian ru Estonian et Serbian sr Filipino tl Slovak sk Finnish fi Slovenian sl French fr Spanish es Galician gl Swahili sw Georgian ka Swedish sv German de Tamil ta Greek el Telugu te Gujarati gu Thai th Haitian Creole ht Turkish tr Hebrew iw Ukrainian uk Hindi hi Urdu ur Hungarian hu Vietnamese vi Icelandic is Welsh cy Indonesian id Yiddish yi Contribution ------------ [](#contribution) 1. Fork it! 2. Create your feature branch: `git checkout -b feature-name` 3. Commit your changes: `git commit -am 'Some commit message'` 4. Push to the branch: `git push origin feature-name` 5. Submit a pull request 😉😉 License ------- [](#license) MIT © Tochukwu Nkemdilim ### Health Score 40 — FairBetter than 88% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity43 Moderate usage in the ecosystem Community20 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 85.5% 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 ~488 days Total 4 Last Release 1792d ago Major Versions 1.0.1 → 2.0.02018-11-28 PHP version history (3 changes)1.0.1PHP >=5.3.0 2.0.0PHP ^7.1 2.1.0PHP ^7.2 || ^8 ### Community Maintainers ![](https://www.gravatar.com/avatar/040e1ab40a939087fc5512f1c52d88a78dc832de7b3679a8fe54a3e1b76333b0?d=identicon)[TNkemdilim](/maintainers/TNkemdilim) --- Top Contributors [![toksdotdev](https://avatars.githubusercontent.com/u/11903253?v=4)](https://github.com/toksdotdev "toksdotdev (65 commits)")[![nagato23](https://avatars.githubusercontent.com/u/124118461?v=4)](https://github.com/nagato23 "nagato23 (5 commits)")[![bgeree](https://avatars.githubusercontent.com/u/11974900?v=4)](https://github.com/bgeree "bgeree (2 commits)")[![oza75](https://avatars.githubusercontent.com/u/29458652?v=4)](https://github.com/oza75 "oza75 (2 commits)")[![over-engineer](https://avatars.githubusercontent.com/u/6157348?v=4)](https://github.com/over-engineer "over-engineer (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/tnkemdilim-money-to-words-converter/health.svg) ``` [![Health](https://phpackages.com/badges/tnkemdilim-money-to-words-converter/health.svg)](https://phpackages.com/packages/tnkemdilim-money-to-words-converter) ``` ### Alternatives [web64/laravel-nlp Laravel package for accessing NLP tools 5711.2k](/packages/web64-laravel-nlp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)