Skip to main content
Laravel Brick Money can be installed in any Laravel 10, 11, or 12 application using Composer. The package includes automatic service provider registration for a seamless installation experience.

​
Requirements

Before installing Laravel Brick Money, ensure your system meets these requirements:
1

PHP Version

PHP 8.2 or higher is required. Verify your PHP version:
php --version
2

Laravel Version

Laravel 10.x, 11.x, or 12.x. Check your Laravel version in composer.json:
"require": {
    "laravel/framework": "^10.0||^11.0||^12.0"
}
3

Optional Extensions

The ext-intl PHP extension is optional but recommended for locale-based formatting:
php -m | grep intl
Without ext-intl, you can still use the format() method, but formatLocale() will not be available.

​
Install via Composer

Install Laravel Brick Money using Composer: 
composer require devhammed/laravel-brick-money
The package will automatically register its service provider and publish necessary assets thanks to Laravel’s package auto-discovery feature.

​
What Gets Installed

When you install the package, the following components are automatically registered:
The Devhammed\LaravelBrickMoney\Provider class is automatically registered and provides:
  • Configuration file registration
  • Blade directive registration (@money, @currency)
  • Blade component registration (<x-money>, <x-currency>)
  • Request macro registration (request()->money(), request()->currency())
  • Livewire synthesizer registration (if Livewire is installed)
Two global helper functions become available:
// Create Money instance
money(100, 'USD');        // Money::of(100, 'USD')
money(100, minor: true);  // Money::ofMinor(100)

// Create Currency instance
currency('USD');          // Currency::of('USD')
currency();               // Uses default from config
Model casts for storing money in databases:
  • AsIntegerMoney - Stores minor units (recommended)
  • AsDecimalMoney - Stores major units
  • AsCurrency - Stores currency codes
Custom validation rules:
  • MoneyRule - Validates monetary amounts
  • CurrencyRule - Validates currency codes

​
Verify Installation

Verify the package is installed correctly by running: 
composer show devhammed/laravel-brick-money
You should see output similar to: 
name     : devhammed/laravel-brick-money
descrip. : Laravel Brick Money Integration
versions : * 1.0.2

​
Testing the Installation

Create a test route to verify everything works:
1

Add Test Route

Add this to your routes/web.php:
routes/web.php
use Devhammed\LaravelBrickMoney\Money;

Route::get('/test-money', function () {
    $price = Money::of(99.99, 'USD');
    return $price->format(); // "$99.99"
});
2

Visit the Route

Start your development server and visit the route:
php artisan serve
Navigate to http://localhost:8000/test-money
3

Verify Output

You should see: $99.99
If you see this output, Laravel Brick Money is installed and working correctly!

​
Install Optional Dependencies

​
PHP Intl Extension

For locale-based formatting, install the Intl extension: 
sudo apt-get install php8.2-intl
sudo systemctl restart php8.2-fpm
Verify installation: 
use Devhammed\LaravelBrickMoney\Money;

$money = Money::of(1234.56, 'USD');
echo $money->formatLocale('en_US');  // "$1,234.56"
echo $money->formatLocale('de_DE');  // "1.234,56 $"

​
Livewire (Optional)

If you’re using Livewire, the package automatically registers synthesizers for Money and Currency objects: 
composer require livewire/livewire
Now you can use Money objects directly in Livewire components: 
use Livewire\Component;
use Devhammed\LaravelBrickMoney\Money;

class ProductPrice extends Component
{
    public Money $price;
    
    public function mount()
    {
        $this->price = Money::of(99.99, 'USD');
    }
    
    public function incrementPrice()
    {
        $this->price = $this->price->plus(10);
    }
}

​
Updating the Package

To update to the latest version: 
composer update devhammed/laravel-brick-money
Always check the changelog before updating to see if there are any breaking changes.

​
Troubleshooting

If you see “Class ‘Devhammed\LaravelBrickMoney\Money’ not found”:
composer dump-autoload
php artisan clear-compiled
php artisan config:clear
If the service provider isn’t auto-registered, manually add it to config/app.php:
config/app.php
'providers' => [
    // Other providers...
    Devhammed\LaravelBrickMoney\Provider::class,
],
Ensure Composer’s autoload files are being loaded in your composer.json:
composer.json
"autoload": {
    "files": [
        "vendor/devhammed/laravel-brick-money/src/helpers.php"
    ]
}
Then run:
composer dump-autoload

​
Next Steps

Now that Laravel Brick Money is installed, learn how to configure it:

Configuration

Configure default currency, minor unit handling, and customize currency definitions.

Build docs developers (and LLMs) love

Get started for freeTalk to us