Download the PHP package sirix/money without Composer
On this page you can find all versions of the php package sirix/money. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package money
Short Description A PHP library for handling monetary values with support for both traditional (fiat) and cryptocurrencies
License MIT
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 money
Sirix Money
A PHP library for handling monetary values with support for both traditional (fiat) and cryptocurrencies. Built on top of brick/money with additional features and safeguards.
Features
- Safe and accurate monetary value handling
- Support for both traditional and cryptocurrency values
- Configurable caching system
- Custom currency registration
- Proper handling of minor currency units (cents, satoshi, etc.)
- Strict type checking and comprehensive error handling
Requirements
- PHP 8.1 or higher
- brick/money
- psr/cache (for caching support)
Installation
Install via Composer:
Basic Usage
Creating Monetary Values
Currency Registry Configuration
Error Handling
The library uses specific exceptions for different error cases:
UnknownCurrencyException- When using an unsupported currencyInvalidAmountException- When providing invalid monetary amountsUnsupportedCurrencyException- When attempting to use an unsupported currencyCacheException- When cache operations failSirixMoneyException- Base exception class for general errors
Features in Detail
Default Rounding Mode
The library uses RoundingMode::HALF_UP as the default rounding mode. This can be overridden by passing a different rounding mode to the of() or ofMinor() methods.
Context Support
Both of() and ofMinor() methods support an optional Context parameter, allowing you to specify custom decimal places and other context-specific settings.
Cache Integration
The library supports PSR-6 compatible cache implementations:
Currency Code Enums and Utilities
Two enum classes that define standardized currency codes for fiat currencies and cryptocurrencies, plus a utility class for creating currency code enum objects from numeric codes.
Special Naming Conventions
Separate Enums for Fiat and Crypto Currencies
To handle cases where a cryptocurrency code conflicts with an existing fiat currency code (like MNT, SOS, ERN), we use separate enums:
FiatCurrencyCode::Mnt- The fiat currency Mongolian Tugrik (MNT)CryptoCurrencyCode::Mnt- The cryptocurrency version of MNTFiatCurrencyCode::Sos- The fiat currency Somali Shilling (SOS)CryptoCurrencyCode::Sos- The cryptocurrency version of SOSFiatCurrencyCode::Ern- The fiat currency Eritrean Nakfa (ERN)CryptoCurrencyCode::Ern- The cryptocurrency version of ERN
Numeric Prefix Handling
For cryptocurrency codes that begin with numbers (like 1INCH), the enum case name uses a descriptive word format instead of the number for PHP compatibility:
- Case name:
OneInch - Actual value:
'1INCH'
This is because PHP enum cases cannot start with a number, so we use a readable word representation while preserving the actual cryptocurrency code value.
CurrencyCode Utility Class
The CurrencyCode class provides a utility method for creating currency code enum objects from numeric codes:
The class automatically determines whether to create a FiatCurrencyCode or CryptoCurrencyCode based on the numeric code:
- Numeric codes < 1000 are treated as fiat currencies
- Numeric codes >= 1000 are treated as cryptocurrencies
Documentation
For complete information about working with currencies in the Sirix Money library, including how to handle both cryptocurrency and fiat currency values, please refer to the currency code documentation in the docs directory.
Related Resources
- README.md - Main library documentation and usage examples
- FiatCurrencyCode.md - Detailed documentation about fiat currency codes
- CryptoCurrencyCode.md - Detailed documentation about cryptocurrency codes
- CurrencyCode.md - Detailed documentation about the CurrencyCode utility class
- FullCryptoCurrencyList.md - Complete List of Available Cryptocurrency Codes
- FullFiatCurrencyList.md - Complete List of Available Fiat Currency Codes
License
MIT License
