PHP download

Download the PHP package fezz/money-magic without Composer

On this page you can find all versions of the php package fezz/money-magic. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download fezz/money-magic
More information about fezz/money-magic
Files in fezz/money-magic

Vendor fezz
Package money-magic
Short Description Generate consistent Brick\Money accessors for Eloquent "money" fields stored as minor units (ints). Define money mappings once, avoid floats, keep currency handling centralized, and optionally scaffold mappings via Artisan for clean, type-safe monetary domain code.
License MIT
Homepage https://github.com/fezz/money-magic

Keywords money currency laravel eloquent accessors value-object casts brick-money

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

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.

Please rate this library. Is it a good library?

Example code of fezz/money-magic

Informations about the package money-magic

Money Magic

Generate consistent Brick\Money accessors for Eloquent "money" fields stored safely as INTEGER minor units (e.g., cents). Define money mappings once, avoid floats, keep currency handling centralized, and get clean, type-safe monetary domain code.

Why Money Magic?

Storing money as floats in databases is a common mistake that leads to precision errors. Money Magic solves this by:

Storing money as integers (minor units like cents) in your database
Never storing floats - all float accessors are derived from the integer storage
Providing type-safe accessors using Brick\Money for calculations
Auto-hiding internal fields in JSON output (configurable)
Centralized currency handling through a simple configuration

Requirements

PHP ^8.3
Laravel ^11.0, ^12.0, or ^13.0

Installation

You can install the package via composer:

Publishing Configuration

You can publish the config file with:

This will publish the configuration file to config/money-magic.php where you can customize suffixes, auto-hide behavior, and enabled toggles.

Usage

Basic Example

Use the HasMoneyAttributes trait in your model and define a $money mapping:

Available Attributes

Based on the default configuration, the following attributes are automatically available:

$product->price - Float accessor (major units) if float is enabled and suffix is empty
$product->price_minor - Integer accessor (minor units, e.g., cents)
$product->price_money - Brick\Money\Money instance (nullable)
$product->price_formatted - Formatted string accessor (read-only)

Auto-Hide Behavior

By default, internal fields (price_minor and price_money) are automatically hidden from JSON output. This behavior is configurable via the autohide configuration.

Example Usage

Configuration

The configuration file (config/money-magic.php) allows you to customize:

currency-column - The database column name that stores the ISO currency code (default: 'currency')
float.enabled - Enable/disable the float accessor (default: true)
float.suffix - Suffix for float accessor (empty string uses base field name, default: '')
minor.suffix - Suffix for minor units column (default: '_minor')
money.enabled - Enable/disable the Money accessor (default: true)
money.suffix - Suffix for Money accessor (default: '_money')
formatted.enabled - Enable/disable the formatted accessor (default: true)
formatted.suffix - Suffix for formatted accessor (default: '_formatted')
formatted.format - Locale for formatting (default: 'it-IT')
autohide - Array controlling which fields are hidden in JSON output:
- minor (default: true)
- money (default: true)
- formatted (default: false)
- float (default: false)

Testing

Run the test suite:

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

fezz02
All Contributors

License

The MIT License (MIT). Please see LICENSE for more information.

All versions of money-magic with dependencies

PHP Build Version

Package Version

Version v0.1.2 Release 01. May 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of money-magic from vendor fezz

Requires php Version ^8.3
brick/money Version ^0.11.0
illuminate/contracts Version ^11.0||^12.0||^13.0
spatie/laravel-package-tools Version ^1.16

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package fezz/money-magic contains the following files

Loading the files please wait ...