PHPackages                             laravel-ready/readable-numbers - 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. laravel-ready/readable-numbers

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

laravel-ready/readable-numbers
==============================

Human readable numbers for Laravel

v3.0.0(1y ago)613.1k↓37.5%23MITPHPPHP ^8.2 || ^8.1 || ^8.0

Since Apr 23Pushed 1y ago1 watchersCompare

[ Source](https://github.com/laravel-ready/readable-numbers)[ Packagist](https://packagist.org/packages/laravel-ready/readable-numbers)[ RSS](/packages/laravel-ready-readable-numbers/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (4)Versions (5)Used By (3)

Readable Numbers
================

[](#readable-numbers)

[![relliv Readable Numbers](https://camo.githubusercontent.com/5d56a0360da4f72de1c0ff32974f3c19acc15f4a14272670d66f28fdea665340/68747470733a2f2f707265766965772e647261676f6e2d636f64652e70726f2f72656c6c69762f5265616461626c652d4e756d626572732e7376673f6272616e643d6c61726176656c)](https://github.com/laravel-ready/readable-numbers)

[![Stable Version](https://camo.githubusercontent.com/684f704e03f8755efbe8496ece50e130f7b58e4542ab2f9ee830c3aa94cb2c01/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c61726176656c2d72656164792f7265616461626c652d6e756d626572733f6c6162656c3d737461626c65267374796c653d666c61742d737175617265)](https://packagist.org/packages/laravel-ready/readable-numbers)[![Unstable Version](https://camo.githubusercontent.com/85afbac0745eb275d863cee4b1701a70c0e30315d27990b00f1abd553b8761e8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f756e737461626c652d6465762d2d6d61696e2d6f72616e67653f7374796c653d666c61742d737175617265)](https://packagist.org/packages/laravel-ready/readable-numbers)[![Total Downloads](https://camo.githubusercontent.com/e2d97b9355388f262af04d61ca35ac7751801ae9bbcf87f2f6028de6c05d5139/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c61726176656c2d72656164792f7265616461626c652d6e756d626572732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/laravel-ready/readable-numbers)[![License](https://camo.githubusercontent.com/cfce1c932e62a5e8c0fd93cfb7a718f184f48c0bbf08f89e19bc045dbfce3da0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c61726176656c2d72656164792f7265616461626c652d6e756d626572732e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Human readable numbers for Laravel. In some cases, you may need to format numbers in a way that is easier to read. Especially when you are dealing with numbers that are very large, for example we want to show page views and we have `100000000` views. So we can show it in the `100M` format.

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

[](#installation)

```
composer require laravel-ready/readable-numbers
```

Thresholds
----------

[](#thresholds)

ThresholdSuffixResult900900900.000k0.9 K900.000.000m0.9 M900.000.000.000b9 T90.000.000.000.000t900 TUsages
------

[](#usages)

`make` method takes 3 aguments: `make(float $value, int $decimals = 1, $lang = null)`

### Service Example

[](#service-example)

```
use LaravelReady\ReadableNumbers\Services\ReadableNumbers;

...

$readableNumber = ReadableNumbers::make(123456789); // 123.5 M
$readableNumber = ReadableNumbers::make(-123456789); // -123.5 M

// with more decimals
$readableNumber = ReadableNumbers::make(123456789, 2); // 123.46 M

// with target language (default is english)
$readableNumber = ReadableNumbers::make(123456789, 2, 'tr'); // 123.46 Mn
$readableNumber = ReadableNumbers::make(123456789, 3, 'ja'); // 123.457 億
$readableNumber = ReadableNumbers::make(123456789, 4, 'de'); // 123.4568 Mio.
```

### Directive Example

[](#directive-example)

There is only one directive: `@readableNumber()`, again takes three arguments: `@readableNumber(float $value, int $decimals = 1, $lang = null)`. If you use a multi-language system, you should remember to directives are cached. So, you should pass decimal count and language.

```
...

    @readableNumber(123456789, 1, app()->getLocale())

...

    Viewed @readableNumber($blogPost->views, 1, app()->getLocale()) times

```

Languages
---------

[](#languages)

Supported languages are listed [here](lang/) and reference are used in [unicode.org](https://www.unicode.org/cldr/cldr-aux/charts/28/verify/numbers/). If you want to add your own language and send PR.

Don't forget to these shortings are depends on a mathematical view.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance47

Moderate activity, may be stable

Popularity31

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% 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 ~365 days

Total

4

Last Release

390d ago

Major Versions

v1.0.3 → v2.0.02024-05-27

v2.0.0 → v3.0.02025-04-24

PHP version history (3 changes)1.0.1PHP ^8.0.2

v1.0.3PHP ^8.1 || ^8.0

v2.0.0PHP ^8.2 || ^8.1 || ^8.0

### Community

Maintainers

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

---

Top Contributors

[![relliv](https://avatars.githubusercontent.com/u/17010054?v=4)](https://github.com/relliv "relliv (12 commits)")[![ishado](https://avatars.githubusercontent.com/u/5298531?v=4)](https://github.com/ishado "ishado (1 commits)")

---

Tags

laravelnumbersreadablereadable-nularavelreadable numbershuman readable numbers

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/laravel-ready-readable-numbers/health.svg)

```
[![Health](https://phpackages.com/badges/laravel-ready-readable-numbers/health.svg)](https://phpackages.com/packages/laravel-ready-readable-numbers)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[nedwors/navigator

A Laravel package to ease defining navigation menus

433.1k](/packages/nedwors-navigator)[xefi/faker-php-laravel

Faker php integration with laravel

1915.1k](/packages/xefi-faker-php-laravel)[dcblogdev/laravel-junie

Install pre-configured guides for Jetbrains Junie

392.5k](/packages/dcblogdev-laravel-junie)

PHPackages © 2026

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