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

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

codemarkt/laravel-number-to-words
=================================

Multi-language and multi-currency number to words converter for Laravel

v1.0.0(5mo ago)05MITPHPPHP ^8.2

Since Nov 18Pushed 5mo agoCompare

[ Source](https://github.com/codemarkt/laravel-number-to-words)[ Packagist](https://packagist.org/packages/codemarkt/laravel-number-to-words)[ RSS](/packages/codemarkt-laravel-number-to-words/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

Laravel Number to Words
=======================

[](#laravel-number-to-words)

[![Latest Version on Packagist](https://camo.githubusercontent.com/6e8ae75e76cec3a78b19ced361aae9f25ca02367f88ad6581a6e92e9cc298d23/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64656d61726b742f6c61726176656c2d6e756d6265722d746f2d776f7264732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codemarkt/laravel-number-to-words)[![Tests](https://camo.githubusercontent.com/1b364d60e68b542118793fd6b73d5e994739dd7c30d3e8a2f36768e39a965dc6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f64656d61726b742f6c61726176656c2d6e756d6265722d746f2d776f7264732f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/codemarkt/laravel-number-to-words/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/f7ecc973a21345c4d437cd5bc8bedcd223312dbd3148f3ab6c915f924dff3eba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f64656d61726b742f6c61726176656c2d6e756d6265722d746f2d776f7264732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codemarkt/laravel-number-to-words)

Multi-language and multi-currency number to words converter for Laravel.

Features
--------

[](#features)

- Convert numbers to words in multiple languages (Turkish, English)
- Convert currency amounts to words with proper formatting
- **Smart pluralization support** (e.g., "1 dollar" vs "2 dollars")
- Flexible input parsing (handles various number formats)
- Customizable output (uppercase, lowercase, custom separators)
- Fail-safe (never throws exceptions)
- Easy to extend with new languages and currencies

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

[](#installation)

```
composer require codemarkt/laravel-number-to-words
```

Configuration
-------------

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=number-to-words-config
```

Publish the language files (optional):

```
php artisan vendor:publish --tag=number-to-words-lang
```

Configuration options in `config/number-to-words.php`:

```
return [
    'locale' => 'tr',
    'fallback_locale' => 'en',
    'case' => 'lowercase',
    'separator' => ' ',
];
```

Usage
-----

[](#usage)

### Recommended: Using Helper Functions (Shorter Syntax)

[](#recommended-using-helper-functions-shorter-syntax)

```
// Convert numbers to words
number_to_words(154); // Uses default locale from config
number_to_words(154, 'tr'); // "yüz elli dört"
number_to_words(154, 'en'); // "one hundred fifty four"

// Convert currency amounts
number_to_currency_words(8097.21, 'TRY', 'tr'); // "sekiz bin doksan yedi türk lirası yirmi bir kuruş"
number_to_currency_words(150.50, 'USD', 'en'); // "one hundred fifty us dollar fifty cent"

// With custom formatting
number_to_words(123, 'tr', 'uppercase', '-'); // "YÜZ-YİRMİ-ÜÇ"
```

### Using Facade (Alternative)

[](#using-facade-alternative)

```
use CodeMarkt\NumberToWords\Facades\NumberToWords;

// Or use the global alias (automatically registered)
use NumberToWords;

NumberToWords::toWords(154, 'tr'); // "yüz elli dört"
NumberToWords::toCurrency(8097.21, 'TRY', 'tr'); // "sekiz bin doksan yedi türk lirası yirmi bir kuruş"
```

### Using Service Container

[](#using-service-container)

```
$service = app(\CodeMarkt\NumberToWords\NumberToWordsService::class);
$service->toWords(154, 'tr');
```

### Input Formats

[](#input-formats)

The package handles various number formats automatically:

```
NumberToWords::toWords('8.097,21'); // Turkish format → 8097.21
NumberToWords::toWords('1,200.56'); // English format → 1200.56
NumberToWords::toWords('18 500,90'); // With spaces → 18500.90
NumberToWords::toWords(1200.0); // Float
NumberToWords::toWords(1200); // Integer
```

Supported Languages
-------------------

[](#supported-languages)

- Turkish (tr)
- English (en)

Supported Currencies
--------------------

[](#supported-currencies)

- TRY (Turkish Lira)
- USD (US Dollar)
- EUR (Euro)
- GBP (British Pound)

Adding Custom Languages and Currencies
--------------------------------------

[](#adding-custom-languages-and-currencies)

### Adding a New Currency

[](#adding-a-new-currency)

Simply add the currency to your language files. The package supports both simple strings and pluralization:

**Simple format (backward compatible):**

```
'currencies' => [
    'JPY' => [
        'major' => 'Japanese yen',
        'minor' => '', // Leave empty if no minor unit
    ],
],
```

**With pluralization (recommended for proper grammar):**

```
'currencies' => [
    'USD' => [
        'major' => [
            'singular' => 'US dollar',
            'plural' => 'US dollars',
        ],
        'minor' => [
            'singular' => 'cent',
            'plural' => 'cents',
        ],
    ],
],
```

The package automatically uses the correct form based on the amount:

- `1.50 USD` → "one US dollar fifty cents"
- `2.00 USD` → "two US dollars"

### Creating a New Language File

[](#creating-a-new-language-file)

Create a new language file in `resources/lang/vendor/number-to-words/{locale}/number.php`:

```
return [
    'digits' => [
        '0' => 'zero',
        '1' => 'one',
        // ...
    ],
    'tens' => [
        '10' => 'ten',
        '20' => 'twenty',
        // ...
    ],
    'hundred' => 'hundred',
    'exponents' => [
        0 => '',
        1 => 'thousand',
        2 => 'million',
        // ...
    ],
    'currencies' => [
        'USD' => [
            'major' => 'dollar',
            'minor' => 'cent',
        ],
        // ...
    ],
];
```

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance70

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Unknown

Total

1

Last Release

175d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/471287e8a45bcbb40792e94a315f4380f51ad9288c5675ecde69f5a7609201ce?d=identicon)[codemarkt](/maintainers/codemarkt)

---

Top Contributors

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

---

Tags

laravelcurrencyconverterenglishmulti-languagepluralizationnumber to wordsTurkish

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[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)[torann/currency

This provides Laravel with currency functions such as currency formatting and conversion using up-to-date exchange rates.

4081.1M6](/packages/torann-currency)[danielme85/laravel-cconverter

Laravel 5 plug-in for currency conversion

42101.1k](/packages/danielme85-laravel-cconverter)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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