PHPackages                             muvon/kiss-money - 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. muvon/kiss-money

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

muvon/kiss-money
================

KISS implementation of Money manipuliation logic

0.4.3(4y ago)133MITPHP

Since Mar 14Pushed 4y ago1 watchersCompare

[ Source](https://github.com/Muvon/php-kiss-money)[ Packagist](https://packagist.org/packages/muvon/kiss-money)[ RSS](/packages/muvon-kiss-money/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (1)Versions (8)Used By (0)

php-kiss-money
==============

[](#php-kiss-money)

KISS implementation of Money manipulation with configuring currencies byself

Simple usage
------------

[](#simple-usage)

```
use Muvon\KISS\Money;
Money::init([
  'USD' => [
    'fraction' => 2
  ]
]);

$Money = Money::fromAmount('0.01', 'USD');

// If we want to create from minor amount
// $Money = Money::fromMinor('1', 'USD');
// Get amount
var_dump($Money->getAmount());

// Get minor amount aka Value
var_dump($Money->getValue());
```

Methods
-------

[](#methods)

### Initialize

[](#initialize)

Before usage of Money object you need to configure it with your currencies.

To do this just invoke Money::init() method with passed config to it before startup of your application.

Example of initializing the object:

```
use Muvon\KISS\Money;
$config = [
  'USD' => [
    'fraction' => 2
  ],
  'EUR' => [
    'fraction' => 2
  ]
];
Money::init($config);
```

### Create from amount of currency

[](#create-from-amount-of-currency)

You can create object using amount or value (aka minor amount) as single instance and also as from list of instances (array);

Look at example usage below to understand how you can create objects.

```
$list = Money::fromAmounts(['1.01', '2.03'], 'USD');
// Dumps array of Money objects created from amounts
var_dump($list);

// Dumps single object from amount
var_dump(Money::fromAmount('1.01', 'USD'));

// You can do almost the same just from minor amount
// Using method fromValue and fromValues
// But passing minor amounts to them
```

### Mathematic operations

[](#mathematic-operations)

Available operations with 2 objects of money - add and sub.

Example:

```
$one = Money::fromAmount('1.5', 'USD');
$two = Money::fromAmount('2.0', 'USD');

// Dumps "3.50"
var_dump($one->add($two));

// Dumps "0.50"
var_dump($two->sub($one));
```

You also can multiply or divide using methods mul and div.

Example:

```
$usd = Money::fromAmount('1.5', 'USD');

// Dumps "3.00"
var_dump($usd->mul('2'));

// Dumps "0.75"
var_dump($usd->div('2'));
```

### Convert to another country

[](#convert-to-another-country)

The library supports conversion from one to another country in rate of presented by another country.

To convert just call cnv methods as follows in example.

Example:

```
$xrp = Money::fromAmount('23.00243', 'XRP');
$rate = Money::fromAmount('0.51', 'USD'); // How much for 1 XRP

// Dumps "11.73"
var_dump($xrp->cnv($rate));
```

To make conversions easier you can also create your rate using 2 same currency objects.

Example:

```
$Source = Money::fromAmount('0.5', 'USD');
$Target = Money::fromAount('10', 'USD');

// Dumps object with rate "20"
var_dump(Money::rate($Source, $Target, 'XRP'));
```

### Comparing operations

[](#comparing-operations)

All comparing operations are named as bash-like style.

MethodDescriptioneqEqualsneNot equalsgtGreater thangeGreater or equalltLess thanleLess than or equalAll methods has only 1 arg should be passed – another object of Money to compare with current one.

Example:

```
$one = Money::fromAmount('1.5', 'USD');
$two = Money::fromAmount('2', 'USD');

// Dumps false
var_dump($one->ge($two));

// Dumps true
var_dump($one->lt($two));
```

### Self checking methods

[](#self-checking-methods)

You can check current value with methods – isPositive, isNegative, isZero.

Example:

```
$usd = Money::fromAmount('1.5', 'USD');

// Dumps true
var_dump($usd->isPositive());

// Dumps false
var_dump($usd->isNegative());

// Dump false
var_dump($usd->isZero());
```

### Getting information about current object

[](#getting-information-about-current-object)

You can use next method to get current state of object and its value. All methods have no arguments

MethodArgumentsReturnDescriptiongetAmount-stringReturn current amount presentation of value with configured fraction as a stringgetValue-stringReturn current minor amount (called value) of current objectgetCurrency-stringReturn current currency of of this object### Use as string

[](#use-as-string)

You can use object as string. By default it returns Money::getAmount() method call.

Dependecies
-----------

[](#dependecies)

This library requires you to have bcmath and gmp extension and PHP 8+ version.

This library has no other code dependencies and kept as simple as possible.

Test coverage
-------------

[](#test-coverage)

- Can create single
- Can create multiple
- Can create zero
- Cannot create no config
- Add sub operations
- Mul div operations
- Rate calculation
- Convert to another currency
- Cannot convert same currency
- Result is immutable
- Cmp operations
- Cannot add sub different currency
- Cannot compare different currency
- Is positive
- Is negative
- Is zero
- Has currency
- Can use as string

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

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

Every ~20 days

Recently: every ~29 days

Total

7

Last Release

1767d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/63024506f19e213d456eab6179ffa1e95d5f2b4ee19aa06063f754a4cb3f113d?d=identicon)[muvon](/maintainers/muvon)

---

Top Contributors

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

---

Tags

moneycurrencylightweightvalueamountkiss

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/muvon-kiss-money/health.svg)

```
[![Health](https://phpackages.com/badges/muvon-kiss-money/health.svg)](https://phpackages.com/packages/muvon-kiss-money)
```

###  Alternatives

[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)[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)[florianv/laravel-swap

Currency exchange rates library for Laravel and Lumen

3342.0M2](/packages/florianv-laravel-swap)

PHPackages © 2026

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