PHPackages                             byjg/wordnumber - 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. byjg/wordnumber

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

byjg/wordnumber
===============

Convert numeric values into their word representations in multiple languages.

6.0.0(5mo ago)119MITPHPPHP >=8.3 <8.6CI passing

Since Apr 21Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/byjg/php-wordnumber)[ Packagist](https://packagist.org/packages/byjg/wordnumber)[ GitHub Sponsors](https://github.com/byjg)[ RSS](/packages/byjg-wordnumber/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (9)Used By (0)

   sidebar\_key wordnumber   tags    php

 text-manipulation

    WordNumber
==========

[](#wordnumber)

Convert numeric values into their word representations in multiple languages.

[![Sponsor](https://camo.githubusercontent.com/fab14b7f7f475072ada0473f193d6f322561fd4a2958e0cc89910d053347cf27/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53706f6e736f722d2532336561346161613f6c6f676f3d67697468756273706f6e736f7273266c6f676f436f6c6f723d7768697465266c6162656c436f6c6f723d306431313137)](https://github.com/sponsors/byjg)[![Build Status](https://github.com/byjg/php-wordnumber/actions/workflows/phpunit.yml/badge.svg?branch=master)](https://github.com/byjg/php-wordnumber/actions/workflows/phpunit.yml)[![Opensource ByJG](https://camo.githubusercontent.com/425c1bbccc0f292bf4d20569ae74a6b2e384fd648f1af8911bc61de9a8dcfc0b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e736f757263652d62796a672d737563636573732e737667)](http://opensource.byjg.com)[![GitHub source](https://camo.githubusercontent.com/88e61eb211719144efdd570290a0456b6e13099c2df8d973f1bb43fe33bf0039/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4769746875622d736f757263652d696e666f726d6174696f6e616c3f6c6f676f3d676974687562)](https://github.com/byjg/php-wordnumber/)[![GitHub license](https://camo.githubusercontent.com/31758002b53cf1148aca6805f9acfa577951c9c7b53e4a3960314e4b0cb5539b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f62796a672f7068702d776f72646e756d6265722e737667)](https://opensource.byjg.com/opensource/licensing.html)[![GitHub release](https://camo.githubusercontent.com/5c88e0edddac2568a8d8389abc94c289314dd6b3aaf383067f257b6ef5cbe7e3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f62796a672f7068702d776f72646e756d6265722e737667)](https://github.com/byjg/php-wordnumber/releases/)

Features
--------

[](#features)

- Convert integers and floats to word numbers
- Support for multiple languages:
    - English
    - Portuguese
    - Italian (Thanks to [willypuzzle](https://github.com/willypuzzle))
- Currency formatting with singular/plural forms
- Extensible architecture for adding new languages

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

[](#installation)

```
composer require byjg/wordnumber
```

Quick Start
-----------

[](#quick-start)

### English

[](#english)

```
use ByJG\WordNumber\EnglishWordNumber;

$wordNumber = new EnglishWordNumber();
echo $wordNumber->write(12.34);
// Output: twelve dollars and thirty four cents
```

### Portuguese

[](#portuguese)

```
use ByJG\WordNumber\PortugueseWordNumber;

$wordNumber = new PortugueseWordNumber();
echo $wordNumber->write(12.34);
// Output: doze reais e trinta e quatro centavos
```

### Italian

[](#italian)

```
use ByJG\WordNumber\ItalianWordNumber;

$wordNumber = new ItalianWordNumber();
echo $wordNumber->write(12.34);
// Output: dodici euro e trenta quattro centesimi
```

Documentation
-------------

[](#documentation)

- [Getting Started](docs/getting-started.md)
- [Usage Examples](docs/usage.md)
- [Creating Custom Languages](docs/creating-languages.md)

Dependencies
------------

[](#dependencies)

 ```
flowchart TD
    byjg/wordnumber
```

      Loading ---

[Open source ByJG](http://opensource.byjg.com)

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance79

Regular maintenance activity

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 95.2% 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 ~552 days

Recently: every ~172 days

Total

8

Last Release

178d ago

Major Versions

1.0.2 → 4.9.02024-01-03

4.9.0 → 5.0.x-dev2024-10-29

5.0.0 → 6.0.02025-11-22

PHP version history (3 changes)4.9.0PHP >=7.4.0

5.0.x-devPHP >=8.1 <8.4

6.0.0PHP >=8.3 <8.6

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/981924?v=4)[Joao Gilberto Magalhaes](/maintainers/byjg)[@byjg](https://github.com/byjg)

---

Top Contributors

[![byjg](https://avatars.githubusercontent.com/u/981924?v=4)](https://github.com/byjg "byjg (40 commits)")[![devidsign](https://avatars.githubusercontent.com/u/37834441?v=4)](https://github.com/devidsign "devidsign (2 commits)")

---

Tags

languagenumbersnumbers-to-textphp

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/byjg-wordnumber/health.svg)

```
[![Health](https://phpackages.com/badges/byjg-wordnumber/health.svg)](https://phpackages.com/packages/byjg-wordnumber)
```

###  Alternatives

[beyondcode/laravel-comments

Add comments to your Laravel application

605414.2k2](/packages/beyondcode-laravel-comments)[graphp/graph

GraPHP is the mathematical graph/network library written in PHP.

711292.6k3](/packages/graphp-graph)[kucrut/vite-for-wp

Vite integration for WordPress plugins and themes development.

321127.6k6](/packages/kucrut-vite-for-wp)[cijic/phpmorphy

phpMorphy - morphological analyzer library for Russian, English, German and Ukrainian languages.

115339.9k7](/packages/cijic-phpmorphy)[alrik11es/cowsayphp

Cowsay port in PHP

72516.3k1](/packages/alrik11es-cowsayphp)[glhd/conveyor-belt

14797.0k](/packages/glhd-conveyor-belt)

PHPackages © 2026

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