PHPackages                             sfadless/number-to-string-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. [Utility & Helpers](/categories/utility)
4. /
5. sfadless/number-to-string-converter

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

sfadless/number-to-string-converter
===================================

Converts numbers to text

2.0.2(5y ago)0206proprietaryPHPPHP ^5.6 || ^7.0 || ^8.0CI failing

Since Oct 2Pushed 5y ago1 watchersCompare

[ Source](https://github.com/sfadless/number-to-string-converter)[ Packagist](https://packagist.org/packages/sfadless/number-to-string-converter)[ RSS](/packages/sfadless-number-to-string-converter/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

NumberToStringConverter
=======================

[](#numbertostringconverter)

Converts numbers to strings

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

[](#documentation)

### Basic usage

[](#basic-usage)

```
use Sfadless\NumberToStringConverter\Language\Russian\RussianLanguageFactory;
use Sfadless\NumberToStringConverter\NumberToStringConverter;

$factory = new RussianLanguageFactory();
$russianLanguage = $factory->create();

$converter = new NumberToStringConverter($russianLanguage);

$converter->convert(33.27); //тридцать три рубля двадцать семь копеек
```

### Output templates

[](#output-templates)

You can control output with templates. Default template is "%i\_string% %i\_currency% %f\_string% %f\_currency%". It means, that for number 11.12 default output will be "одиннадцать рублей двенадцать копеек". Available variables in template by default are %i\_string%, %i\_value%, %i\_currency%, %f\_string%, %f\_value%, %f\_currency%.

```
$template = '%i_value% %i_currency% %f_value% %f_currency%';
$converter->convert(12.22, ['template' => $template]); // 12 рублей 22 копейки
```

### Adding variables in templates

[](#adding-variables-in-templates)

If you need, you can add your own variables in template, where you have full control of output.

```
use Sfadless\NumberToStringConverter\Language\Russian\Output\Output;
use Sfadless\NumberToStringConverter\Language\Russian\Output\OutputVariable;

$variable = new OutputVariable('i_short_curency', function (Output $output) {
    return mb_substr($output->getInteger()->getCurrency(), 0, 3);
});

$template = '%i_value% %i_short_curency%';

$converter->convert(12, ['template' => $template, 'variables' => [$variable]]); // 12 руб
```

### Change currency

[](#change-currency)

By default, currency is rubles. You can create any currency you like.

```
use Sfadless\NumberToStringConverter\Language\Russian\Currency;
use Sfadless\NumberToStringConverter\Language\Russian\Declension\Declension;

$currency = new Currency(
    new Declension('доллар', 'доллара', 'долларов', Declension::GENDER_M),
    new Declension('цент', 'цента', 'центов', Declension::GENDER_M)
);

$converter->convert(3.05, ['currency' => $currency]); //три доллара пять центов
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity71

Established project with proven stability

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

Total

4

Last Release

1910d ago

Major Versions

1.0 → 2.02019-01-10

PHP version history (3 changes)1.0PHP ^5.4 || ^7.0

2.0PHP ^5.6 || ^7.0

2.0.2PHP ^5.6 || ^7.0 || ^8.0

### Community

Maintainers

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

---

Top Contributors

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

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sfadless-number-to-string-converter/health.svg)

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

###  Alternatives

[mmanos/laravel-casset

An asset management package for Laravel 4.

112.6k](/packages/mmanos-laravel-casset)

PHPackages © 2026

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