PHPackages                             msaied/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. msaied/money-to-words-converter

ActiveLibrary

msaied/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.0.3(4y ago)025MITPHPPHP ^8.0

Since Jun 19Pushed 4y agoCompare

[ Source](https://github.com/msaied/Money-To-Words-Converter)[ Packagist](https://packagist.org/packages/msaied/money-to-words-converter)[ RSS](/packages/msaied-money-to-words-converter/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (2)Dependencies (2)Versions (8)Used By (0)

Money To Words Converter
========================

[](#money-to-words-converter)

[![Packagist](https://camo.githubusercontent.com/f8b070832b1617d608326c81141a1ebbfd2aef069e285c542f44ad327e7761e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d73616965642f6d6f6e65792d746f2d776f7264732d636f6e7665727465722e737667)](https://packagist.org/packages/msaied/money-to-words-converter)[![Build Status](https://camo.githubusercontent.com/e76c442fddcac526a4aedc8482219f0ace0ab6f67452045e9c46194a4ff61a49/68747470733a2f2f7472617669732d63692e636f6d2f6d73616965642f4d6f6e65792d546f2d576f7264732d436f6e7665727465722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/msaied/Money-To-Words-Converter)[![PHP from Packagist](https://camo.githubusercontent.com/eaa615397937dba2c6272b4ba36e89a3933d2f23a01a372e1919d7bfb5844520/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6d73616965642f6d6f6e65792d746f2d776f7264732d636f6e7665727465722e737667)](https://packagist.org/packages/msaied/money-to-words-converter)[![Packagist](https://camo.githubusercontent.com/78f5b222c2d7714e7475112b4f307dddd733a54181d3c57a1ce258fa70b66cc8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d73616965642f6d6f6e65792d746f2d776f7264732d636f6e7665727465722e737667)](https://packagist.org/packages/msaied/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

Installation
------------

[](#installation)

- Install this package via [Composer](https://getcomposer.org).

```
composer require msaied/money-to-words-converter
```

- Or edit your project's `composer.json` to require `msaied/money-to-words-converter` and then run `composer update`.

```
"require": {
    "msaied/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  Thanks To
---------

[](#thanks-to)

Tochukwu Nkemdilim

License
-------

[](#license)

MIT © Tochukwu Nkemdilim

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 64.3% 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 ~364 days

Total

5

Last Release

1794d ago

Major Versions

1.0.1 → 2.0.02018-11-28

PHP version history (3 changes)1.0.1PHP &gt;=5.3.0

2.0.0PHP ^7.1

2.0.3PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/f844d8c6c9c5741cdbde42405be14ddffae9f53a1a6abcfc05ae638b3302eb63?d=identicon)[m.saied](/maintainers/m.saied)

---

Top Contributors

[![toksdotdev](https://avatars.githubusercontent.com/u/11903253?v=4)](https://github.com/toksdotdev "toksdotdev (45 commits)")[![msaied](https://avatars.githubusercontent.com/u/4285830?v=4)](https://github.com/msaied "msaied (14 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/msaied-money-to-words-converter/health.svg)

```
[![Health](https://phpackages.com/badges/msaied-money-to-words-converter/health.svg)](https://phpackages.com/packages/msaied-money-to-words-converter)
```

###  Alternatives

[tanmuhittin/laravel-google-translate

Translate translation files to other languages using google translate api

4312.2M11](/packages/tanmuhittin-laravel-google-translate)[devaslanphp/auto-translate

Auto generate translation JSON files

6623.1k](/packages/devaslanphp-auto-translate)[web64/laravel-nlp

Laravel package for accessing NLP tools

5711.2k](/packages/web64-laravel-nlp)[hpolthof/laravel-translations-db

A database translations implementation for Laravel 5.

545.8k](/packages/hpolthof-laravel-translations-db)[enupal/translate

Translate your website templates and plugins into multiple languages. Bulk translation with Google Translate or Yandex.

1172.1k](/packages/enupal-translate)[mmoreram/translation-server

PHP translation server

233.7k2](/packages/mmoreram-translation-server)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
