PHPackages                             blackjew/number-to-words - 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. blackjew/number-to-words

ActiveLibrary[Utility & Helpers](/categories/utility)

blackjew/number-to-words
========================

Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages.

v1.2.1(5y ago)1845MITPHPPHP >=5.6|>=7.1

Since Apr 29Pushed 4y ago1 watchersCompare

[ Source](https://github.com/blackajew/number-to-words)[ Packagist](https://packagist.org/packages/blackjew/number-to-words)[ RSS](/packages/blackjew-number-to-words/feed)WikiDiscussions main Synced yesterday

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

PHP Number to words converter
=============================

[](#php-number-to-words-converter)

[![Travis](https://camo.githubusercontent.com/0fe35facd1d808477b37b09f5f2561b6c6b350e88888265af5efe3dab595173a/68747470733a2f2f7472617669732d63692e6f72672f6b776e2f6e756d6265722d746f2d776f7264732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/github/blackajew/number-to-words)[![Code Climate](https://camo.githubusercontent.com/37f42466de97afafa1ff8a9cad754c8cba0d1529197c20d295948643bfa296af/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6b776e2f6e756d6265722d746f2d776f7264732f6261646765732f6770612e737667)](https://codeclimate.com/github/blackajew/number-to-words)[![Test Coverage](https://camo.githubusercontent.com/bf15f32acd151cb8c42d212671fa5f7aefe4efe5f1f1b278d4e9969c46c92643/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6b776e2f6e756d6265722d746f2d776f7264732f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/blackajew/number-to-words/coverage)[![Latest Stable Version](https://camo.githubusercontent.com/906524ac428c9b0c1a0077b8d17e18aab057d0692ed6d88f360187c192a84e08/68747470733a2f2f706f7365722e707567782e6f72672f6b776e2f6e756d6265722d746f2d776f7264732f762f737461626c65)](https://packagist.org/packages/blackjew/number-to-words)

This library allows you to convert a number to words.

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

[](#installation)

Add package to your composer.json by running:

```
$ composer require blackjew/number-to-words

```

Usage
-----

[](#usage)

This library currently has two types of number-to-words transformations: number and currency. In order to use a specific transformer for certain language you need to create an instance of `NumberToWords` class and then call a method which creates a new instance of a transformer;

### Number Transformer

[](#number-transformer)

Before using a transformer, it must be created:

```
use BlackJew\NumberToWords\NumberToWords;

// create the number to words "manager" class
$numberToWords = new NumberToWords();

// build a new number transformer using the RFC 3066 language identifier
$numberTransformer = $numberToWords->getNumberTransformer('en');
```

Then it can be used passing in numeric values to the `toWords()` method:

```
$numberTransformer->toWords(5120); // outputs "five thousand one hundred twenty"
```

### Currency Transformer

[](#currency-transformer)

Creating a currency transformer works just like a number transformer.

```
use BlackJew\NumberToWords\NumberToWords;

// create the number to words "manager" class
$numberToWords = new NumberToWords();

// build a new currency transformer using the RFC 3066 language identifier
$currencyTransformer = $numberToWords->getCurrencyTransformer('en');
```

Then it can be used passing in numeric values for amount and ISO 4217 currency identifier to the `toWords()` method:

```
$currencyTransformer->toWords(25000, 'UGX'); // outputs "twenty-five thousand ugandan shillings"
```

Bare in mind, the currency transformer accepts integers as the amount to transform. It means that if you store amounts as floats (e.g. 4.99) you need to multiply them by 100 and pass the integer (499) as an argument.

Available locale
----------------

[](#available-locale)

LanguageIdentifierNumberCurrencyEnglishen++

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

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 ~0 days

Total

2

Last Release

1839d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/be03e4cbeedfabb6039b4754f4069fcfbcbbe2460adb60faadc508ab9d27c53c?d=identicon)[blackjew](/maintainers/blackjew)

---

Top Contributors

[![EmmanuelObua](https://avatars.githubusercontent.com/u/45915845?v=4)](https://github.com/EmmanuelObua "EmmanuelObua (11 commits)")

---

Tags

moneycurrencystringwordsnumbersnumberto

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/blackjew-number-to-words/health.svg)

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

###  Alternatives

[kwn/number-to-words

Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages.

4235.0M21](/packages/kwn-number-to-words)[brick/money

Money and currency library

1.9k37.9M102](/packages/brick-money)[florianv/swap

Exchange rates library for PHP

1.3k6.4M16](/packages/florianv-swap)[cknow/laravel-money

Laravel Money

1.0k4.3M22](/packages/cknow-laravel-money)[akaunting/laravel-money

Currency formatting and conversion package for Laravel

7825.3M18](/packages/akaunting-laravel-money)[coduo/php-to-string

Simple library that converts PHP value into strings

27112.7M10](/packages/coduo-php-to-string)

PHPackages © 2026

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