Download the PHP package macmotp/money without Composer
On this page you can find all versions of the php package macmotp/money. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download macmotp/money
More information about macmotp/money
Files in macmotp/money
Package money
Short Description Light PHP Library to handle Money and Currencies
License MIT
Homepage https://github.com/macmotp/money
Informations about the package money
Light Money Handler
Library to Handle Money and Currencies in PHP, simple and light
Useful for any ecommerce, fintech, or any app that requires 💰.
Requirements
- PHP >= 8.2
Installation
Install the package via composer:
Usage
Create Money objects
List of basic methods
getAmount()
: return the amount in cents;getAmountForHumans()
: return the amount in decimals;getCurrencyCode()
: return the currency code;getCurrencySymbol()
: return the currency symbol;getCurrency()
: return the currency object (as Currency implementation, not as string);clone()
: clone the entire object;zero()
: set the amount to zero;
If you want to print any of the currency properties, check the Format class.
For example: if you want to get the currency code, you can run $money->getCurrencyCode()
Print Money (on the screen, not for real)
List of methods for printing
toArray()
: convert the object into array;getCurrency()->toArray()
: convert the currency object into array;withSymbol()
: print the symbol and not the currency code;withoutSymbol()
: do not print neither symbol nor currency code;withCode()
: print the currency code and not the code;withoutCode()
: do not print neither symbol nor currency code;withSymbolOnLeft()
: print symbol on the left;withSymbolOnRight()
: print symbol on the right;withCodeOnLeft()
: print currency code on the left;withCodeOnRight()
: print currency code on the right;withSpace()
: print a space between the amount and the currency;withoutSpace()
: do not print a space between the amount and the currency;withoutDecimals()
: do not print decimals of the amount;withDecimalSeparator(string $decimalSeparator)
: override default decimal separator character;withThousandsSeparator(string $thousandsSeparator)
: override default thousands separator character;withNumberOfDecimals(int $numberOfDecimals)
: set the precision of the decimals;
Calculate with Money
List of calculation methods
add(Money $money)
;subtract(Money $money)
;multiply(float $factor, string $flat = '')
;divide(float $factor, string $flat = '')
;inPercentage(float $percentage, string $flat = '')
;absolute()
;
Aggregate Money
List of aggregation methods
min(Money ...$money)
: return the minimum amount;max(Money ...$money)
: return the maximum amount;avg(Money ...$money)
: return the average amount;sum(Money ...$money)
: return the sum of all amounts;
Compare Money
List of comparison methods
isSameCurrency(Money ...$money)
;isEqualTo(Money $money)
;isGreaterThan(Money $money)
;isGreaterThanOrEqualTo(Money $money)
;isLessThan(Money $money)
;isLessThanOrEqualTo(Money $money)
;isPositive()
;isNegative()
;isZero()
;isZeroOrPositive()
;isZeroOrNegative()
;
List of Currencies in the package
These are the implemented currencies:
AED
: United Arab Emirates DirhamAFN
: Afghan AfghaniALL
: Albanian LekAMD
: Armenian DramANG
: Netherlands Antillean GuilderAOA
: Angolan KwanzaARS
: Argentine PesoAUD
: Australian DollarAWG
: Aruban FlorinAZN
: Azerbaijani ManatBAM
: Bosnia and Herzegovina Convertible MarkBBD
: Barbados DollarBDT
: Bangladeshi TakaBGN
: Bulgarian LevBHD
: Bahraini DinarBIF
: Burundian FrancBMD
: Bermudian DollarBND
: Brunei DollarBOB
: Bolivian BolivianoBRL
: Brazilian RealBSD
: Bahamian DollarBTC
: BitcoinBTN
: Bhutanese NgultrumBWP
: Botswana PulaBYN
: Belarusian RubleBZD
: Belize DollarCAD
: Canadian DollarCDF
: Congolese FrancCHF
: Swiss FrancCLP
: Chilean PesoCNY
: Chinese Yuan - RenminbiCOP
: Colombian PesoCRC
: Costa Rican ColónCUP
: Cuban PesoCVE
: Cape Verdean EscudoCZK
: Czech KorunaDJF
: Djiboutian FrancDKK
: Danish KroneDOP
: Dominican PesoDZD
: Algerian DinarEGP
: Egyptian PoundERN
: Eritrean NakfaETB
: Ethiopian BirrEUR
: EuroFJD
: Fijian DollarFKP
: Falkland Islands PoundGBP
: British PoundGEL
: Georgian LariGHS
: Ghanaian CediGIP
: Gibraltar PoundGMD
: Gambian DalasiGNF
: Guinean FrancGTQ
: Guatemalan QuetzalGYD
: Guyanese DollarHKD
: Hong Kong DollarHNL
: Honduran LempiraHTG
: Haitian GourdeHUF
: Hungarian ForintIDR
: Indonesian RupiahILS
: Israeli New ShekelINR
: Indian RupeeIQD
: Iraqi DinarIRR
: Iranian RialISK
: Icelandic KrónaJMD
: Jamaican DollarJOD
: Jordanian DinarJPY
: Japanese YenKES
: Kenyan ShillingKGS
: Kyrgyz SomKHR
: Cambodian RielKMF
: Comorian FrancKPW
: North Korean WonKRW
: South Korean WonKWD
: Kuwaiti DinarKYD
: Cayman Islands DollarKZT
: Kazakhstani TengeLAK
: Lao KipLBP
: Lebanese PoundLKR
: Sri Lankan RupeeLRD
: Liberian DollarLSL
: Lesotho LotiLYD
: Libyan DinarMAD
: Moroccan DirhamMDL
: Moldovan LeuMGA
: Malagasy AriaryMKD
: Macedonian DenarMMK
: Burmese KyatMNT
: Mongolian TögrögMOP
: Macanese PatacaMRU
: Mauritanian OuguiyaMUR
: Mauritian RupeeMVR
: Maldivian RufiyaaMWK
: Malawian KwachaMXN
: Mexican PesoMYR
: Malaysian RinggitMZN
: Mozambican MeticalNAD
: Namibian DollarNGN
: Nigerian NairaNIO
: Nicaraguan CórdobaNOK
: Norwegian KroneNPR
: Nepalese RupeeNZD
: New Zealand DollarOMR
: Omani RialPAB
: Panamanian BalboaPEN
: Peruvian SolPGK
: Papua New Guinean KinaPHP
: Philippine PesoPKR
: Pakistani RupeePLN
: Polish ZłotyPYG
: Paraguayan GuaraníQAR
: Qatari RiyalRON
: Romanian LeuRSD
: Serbian DinarRUB
: Russian RubleRWF
: Rwandan FrancSAR
: Saudi RiyalSBD
: Solomon Islands DollarSCR
: Seychellois RupeeSDG
: Sudanese PoundSEK
: Swedish KronaSGD
: Singapore DollarSHP
: Saint Helena PoundSLE
: Sierra Leonean LeoneSOS
: Somali ShillingSRD
: Surinamese DollarSSP
: South Sudanese PoundSTN
: São Tomé and Príncipe DobraSYP
: Syrian PoundSZL
: Swazi LilangeniTHB
: Thai BahtTJS
: Tajikistani SomoniTMT
: Turkmenistani ManatTND
: Tunisian DinarTOP
: Tongan PaʻangaTRY
: Turkish LiraTTD
: Trinidad and Tobago DollarTWD
: New Taiwan DollarTZS
: Tanzanian ShillingUAH
: Ukrainian HryvniaUGX
: Ugandan ShillingUSD
: United States DollarUYU
: Uruguayan PesoUZS
: Uzbekistani SumVES
: Venezuelan Sovereign BolívarVND
: Vietnamese ĐồngVUV
: Vanuatu VatuWST
: Samoan TālāXAF
: Central African CFA FrancXCD
: Eastern Caribbean DollarXOF
: West African CFA FrancXPF
: CFP FrancYER
: Yemeni RialZAR
: South African RandZMW
: Zambian KwachaZWG
: Zimbabwe Gold
If you want to add another currency, please open an issue.
Testing
Changelog
Please see changelog for more information on what has changed recently.
Contributing
Please see contributing for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.