PHPackages neolinks/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. neolinks/number-to-words ActiveLibrary[Utility & Helpers](/categories/utility) neolinks/number-to-words ======================== Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages. v1.12.3(3y ago)027MITPHPPHP >=7.4 Since Dec 8Pushed 3y agoCompare [ Source](https://github.com/neolinks/number-to-words)[ Packagist](https://packagist.org/packages/neolinks/number-to-words)[ RSS](/packages/neolinks-number-to-words/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (2)Versions (49)Used By (0) PHP Number to words converter ============================= [](#php-number-to-words-converter) [![Travis](https://camo.githubusercontent.com/37c631d1b3fbfcc189da29585d015b196b18798147c35f27aec024fc78a999ac/68747470733a2f2f7472617669732d63692e636f6d2f6b776e2f6e756d6265722d746f2d776f7264732e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/kwn/number-to-words)[![Code Climate](https://camo.githubusercontent.com/37f42466de97afafa1ff8a9cad754c8cba0d1529197c20d295948643bfa296af/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6b776e2f6e756d6265722d746f2d776f7264732f6261646765732f6770612e737667)](https://codeclimate.com/github/kwn/number-to-words)[![Test Coverage](https://camo.githubusercontent.com/bf15f32acd151cb8c42d212671fa5f7aefe4efe5f1f1b278d4e9969c46c92643/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6b776e2f6e756d6265722d746f2d776f7264732f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/kwn/number-to-words/coverage)[![Latest Stable Version](https://camo.githubusercontent.com/906524ac428c9b0c1a0077b8d17e18aab057d0692ed6d88f360187c192a84e08/68747470733a2f2f706f7365722e707567782e6f72672f6b776e2f6e756d6265722d746f2d776f7264732f762f737461626c65)](https://packagist.org/packages/kwn/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 kwn/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 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" ``` You can also use a static method: ``` NumberToWords::transformNumber('en', 5120); // outputs "five thousand one hundred twenty" ``` ### Currency Transformer [](#currency-transformer) Creating a currency transformer works just like a number transformer. ``` use 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(5099, 'USD'); // outputs "fifty dollars ninety nine cents" ``` You can also use a static method: ``` NumberToWords::transformCurrency('en', 5099, 'USD'); // outputs "fifty dollars ninety nine cents" ``` Please bear 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) LanguageIdentifierNumberCurrencyAlbanianal++Arabicar++Azerbaijaniaz++Belgian Frenchfr\_BE+-Brazilian Portuguesept\_BR++Bulgarianbg+-Czechcs+-Danishdk++Dutchnl+-Englishen++Estonianet+-Georgianka++Germande++Frenchfr++Hungarianhu++Indonesianid++Italianit+-Kurdishku+-Lithuanianlt++Latvianlv++Macedonianmk+-Malayms++Persianfa+-Polishpl++Romanianro++Slovaksk++Spanishes++Russianru++Swedishsv+-Turkishtr++Turkmentk++Ukrainianua++Yorubayo++Contributors ------------ [](#contributors) Many transformers were ported from the `pear/Numbers_Words` library. Some of them were created from scratch by [contributors](https://github.com/kwn/number-to-words/graphs/contributors). Thank you! Version 2.x - BC and major changes ---------------------------------- [](#version-2x---bc-and-major-changes) - Dropped support for PHP <7.4. - Added typehints for `NumberTransformer` and `CurrencyTransformer` interfaces. Now both accept integer numbers only (Albanian language might be affected). - Added support for PSR12. Questions and answers --------------------- [](#questions-and-answers) **Q: I found a bug. What should I do?** A: Please report an issue on GitHub. Also feel free to fix it and open a pull request. I don't know most of those languages that the library supports, so your help and contribution would be much appreciated. Thanks! **Q: My language is missing. Could you add it, please?** A: Unfortunately, there's a high chance I don't know your language. Feel free to implement the missing transformer and open a pull request. You can take a look at the existing transformers, and follow the same pattern as other languages do. ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community19 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor1 Top contributor holds 74.9% 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 ~58 days Recently: every ~224 days Total 46 Last Release 1189d ago Major Versions 0.0.4 → 1.0.02016-09-29 PHP version history (5 changes)0.0.1PHP >=5.4 1.3.1PHP >=5.5 1.5.3PHP >=5.6 1.6.4PHP >=5.6|>=7.1 1.12.0PHP >=7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/c7762ca43aedecda62b5a889a8599b61a511ab05ac5f3503bb3bae9ae35eb6df?d=identicon)[neolinks](/maintainers/neolinks) --- Top Contributors [![kwn](https://avatars.githubusercontent.com/u/3968616?v=4)](https://github.com/kwn "kwn (215 commits)")[![Zehir](https://avatars.githubusercontent.com/u/845225?v=4)](https://github.com/Zehir "Zehir (14 commits)")[![janhartigan](https://avatars.githubusercontent.com/u/580052?v=4)](https://github.com/janhartigan "janhartigan (7 commits)")[![popovserhii](https://avatars.githubusercontent.com/u/1991183?v=4)](https://github.com/popovserhii "popovserhii (5 commits)")[![IgorZavaleev](https://avatars.githubusercontent.com/u/25030672?v=4)](https://github.com/IgorZavaleev "IgorZavaleev (4 commits)")[![ickbinhier](https://avatars.githubusercontent.com/u/2810904?v=4)](https://github.com/ickbinhier "ickbinhier (3 commits)")[![cristiangomeze](https://avatars.githubusercontent.com/u/19762300?v=4)](https://github.com/cristiangomeze "cristiangomeze (3 commits)")[![veguss](https://avatars.githubusercontent.com/u/35691298?v=4)](https://github.com/veguss "veguss (3 commits)")[![shahonseven](https://avatars.githubusercontent.com/u/372461?v=4)](https://github.com/shahonseven "shahonseven (3 commits)")[![goodot](https://avatars.githubusercontent.com/u/10999902?v=4)](https://github.com/goodot "goodot (3 commits)")[![leonardjke](https://avatars.githubusercontent.com/u/22217360?v=4)](https://github.com/leonardjke "leonardjke (2 commits)")[![CreepPork](https://avatars.githubusercontent.com/u/1590711?v=4)](https://github.com/CreepPork "CreepPork (2 commits)")[![iamdual](https://avatars.githubusercontent.com/u/3048763?v=4)](https://github.com/iamdual "iamdual (2 commits)")[![kongulov](https://avatars.githubusercontent.com/u/33090344?v=4)](https://github.com/kongulov "kongulov (2 commits)")[![andreybolonin](https://avatars.githubusercontent.com/u/2576509?v=4)](https://github.com/andreybolonin "andreybolonin (2 commits)")[![pudovmaxim](https://avatars.githubusercontent.com/u/5713098?v=4)](https://github.com/pudovmaxim "pudovmaxim (2 commits)")[![samnela](https://avatars.githubusercontent.com/u/1852108?v=4)](https://github.com/samnela "samnela (2 commits)")[![mojtabaahn](https://avatars.githubusercontent.com/u/9845317?v=4)](https://github.com/mojtabaahn "mojtabaahn (1 commits)")[![neolinks](https://avatars.githubusercontent.com/u/8432141?v=4)](https://github.com/neolinks "neolinks (1 commits)")[![olivermbs](https://avatars.githubusercontent.com/u/37539998?v=4)](https://github.com/olivermbs "olivermbs (1 commits)") --- Tags moneycurrencystringwordsnumbersnumberto ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/neolinks-number-to-words/health.svg) ``` [![Health](https://phpackages.com/badges/neolinks-number-to-words/health.svg)](https://phpackages.com/packages/neolinks-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)