Download the PHP package muvon/kiss-money without Composer
On this page you can find all versions of the php package muvon/kiss-money. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package kiss-money
php-kiss-money
KISS implementation of Money manipulation with configuring currencies byself
Simple usage
Methods
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:
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.
Mathematic operations
Available operations with 2 objects of money - add and sub.
Example:
You also can multiply or divide using methods mul and div.
Example:
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:
To make conversions easier you can also create your rate using 2 same currency objects.
Example:
Comparing operations
All comparing operations are named as bash-like style.
| Method | Description |
|---|---|
| eq | Equals |
| ne | Not equals |
| gt | Greater than |
| ge | Greater or equal |
| lt | Less than |
| le | Less than or equal |
All methods has only 1 arg should be passed – another object of Money to compare with current one.
Example:
Self checking methods
You can check current value with methods – isPositive, isNegative, isZero.
Example:
Getting information about current object
You can use next method to get current state of object and its value. All methods have no arguments
| Method | Arguments | Return | Description |
|---|---|---|---|
| getAmount | - | string | Return current amount presentation of value with configured fraction as a string |
| getValue | - | string | Return current minor amount (called value) of current object |
| getCurrency | - | string | Return current currency of of this object |
Use as string
You can use object as string. By default it returns Money::getAmount() method call.
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
- [x] Can create single
- [x] Can create multiple
- [x] Can create zero
- [x] Cannot create no config
- [x] Add sub operations
- [x] Mul div operations
- [x] Rate calculation
- [x] Convert to another currency
- [x] Cannot convert same currency
- [x] Result is immutable
- [x] Cmp operations
- [x] Cannot add sub different currency
- [x] Cannot compare different currency
- [x] Is positive
- [x] Is negative
- [x] Is zero
- [x] Has currency
- [x] Can use as string
