PHPackages                             kodeas/currency - 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. kodeas/currency

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

kodeas/currency
===============

A simple currency cast for Laravel

1.0.5(3y ago)26.8k↓74.7%[2 PRs](https://github.com/Kodeas/currency/pulls)MITPHPPHP ^8.0

Since May 21Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Kodeas/currency)[ Packagist](https://packagist.org/packages/kodeas/currency)[ Docs](https://github.com/kodeas/currency)[ RSS](/packages/kodeas-currency/feed)WikiDiscussions main Synced yesterday

READMEChangelog (6)Dependencies (11)Versions (9)Used By (0)

[![currency](https://user-images.githubusercontent.com/56773461/169656521-7f61df41-aaf6-4252-a18b-427fce6688a3.png)](https://user-images.githubusercontent.com/56773461/169656521-7f61df41-aaf6-4252-a18b-427fce6688a3.png)

A simple currency cast for Laravel
==================================

[](#a-simple-currency-cast-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/ec911fbf629662a1d5dc6dbe1082acc41249aade0c8a6705a6ea8c14c52c6c81/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6f646561732f63757272656e63792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kodeas/currency)[![GitHub Tests Action Status](https://camo.githubusercontent.com/a19058d48d42f59f5afb422d8a32c6a0a7b4e957241ab8c7d16f17f19d541ee1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6b6f646561732f63757272656e63792f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/kodeas/currency/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/4f79b6525478b4c2ac21d59b91612a51c9ce38f8b35e1ee6f494effe10d68680/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6b6f646561732f63757272656e63792f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/kodeas/currency/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9dfb99cbd84ff18ec2ee639c4f4034f2feb19d282c3ac92da67c921d6fda7c09/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b6f646561732f63757272656e63792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kodeas/currency)

This package is created to eliminate the ambiguity involved in storing and retrieving currencies. Currently, for simplicity the terminology surrounding the package is in US currency, however there is nothing stopping anyone from using this for any other 2 decimal currencies.

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

[](#installation)

You can install the package via composer:

```
composer require kodeas/currency
```

Usage
-----

[](#usage)

```
MyModel extends Model
{
    protected $casts = [
        'amount' => Kodeas\Currency\Casts\Currency::class
    ];
}
```

```
$currency = Kodeas\Currency\Currency::fromUsd(1);

$model = MyModel::create([
    'amount' => $currency //100(cents) in database
]);

$model->amount //Currency::class
```

Initialize
----------

[](#initialize)

```
$currency = Kodeas\Currency\Currency::fromUsd(1);
$currency = Kodeas\Currency\Currency::fromCents(100);
```

Methods
-------

[](#methods)

```
echo $currency; // "1.00"
$currency->toUsd(); // "1"
$currency->toCents(); // "100"
$currency->toReadable(); // "1.00"
$currency->toReadable('$'); // "$1.00"
return response()->json(['currency' => $currency->toUsd()]); // {"currency": "1.00"}
```

Credits
-------

[](#credits)

- [Salih Borucu](https://github.com/Kodeas)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 72% 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 ~50 days

Recently: every ~63 days

Total

6

Last Release

1252d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/34669c21c80712dca2f3ec3d8a09754533994e81c875a74b8982dcd0cb9113a9?d=identicon)[kodeas](/maintainers/kodeas)

---

Top Contributors

[![SalihBorucu](https://avatars.githubusercontent.com/u/56773461?v=4)](https://github.com/SalihBorucu "SalihBorucu (36 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")

---

Tags

laravelcurrencyKodeas

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/kodeas-currency/health.svg)

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

###  Alternatives

[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

329530.5k29](/packages/codewithdennis-filament-select-tree)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

122177.8k1](/packages/stephenjude-filament-feature-flags)[worksome/exchange

Check Exchange Rates for any currency in Laravel.

124603.0k](/packages/worksome-exchange)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

94135.4k5](/packages/marcelweidum-filament-expiration-notice)[awcodes/richer-editor

A collection of extensions and tools to enhance the Filament Rich Editor field.

3912.8k9](/packages/awcodes-richer-editor)

PHPackages © 2026

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