Money Plugin


The Money Plugin for Pest provides expectations for working with popular PHP money libraries. Currently, this plugin provides support for the following money libraries:

Source code:


Install the Money Plugin via the Composer package manager:

1composer require lukeraymonddowning/pest-plugin-money --dev



To simply assert that an object is a monetary value, use the toBeMoney method:

1expect(Money::of(100, "GBP"))->toBeMoney();
2expect("Hello World")->not->toBeMoney();


To check that a monetary value is equal to a certain amount, use the toCost method:

1expect(Money::of(150, "GBP"))->toCost(150, 'GBP');
2expect(Money::of(150, "GBP"))->toCost($anotherMoneyObject);
3expect(Money::of(150, "GBP"))->not->toCost(100, 'GBP');


To check that a monetary value is less than a certain amount, use the toCostLessThan method:

1expect(Money::of(150, "GBP"))->toCostLessThan(160, 'GBP');
2expect(Money::of(150, "GBP"))->toCostLessThan($anotherMoneyObject);
3expect(Money::of(150, "GBP"))->not->toCostLessThan(140, 'GBP');


To check that a monetary value is more than a certain amount, use the toCostMoreThan method:

1expect(Money::of(150, "GBP"))->toCostMoreThan(140, 'GBP');
2expect(Money::of(150, "GBP"))->toCostMoreThan($anotherMoneyObject);
3expect(Money::of(150, "GBP"))->not->toCostMoreThan(160, 'GBP');

Choosing a money library

This package will attempt to autodetect which of the supported money libraries you have installed. If you want to enforce which library to use, you can call the useMoneyLibrary function. Pass the class name of the relevant money package:

1useMoneyLibrary(\Money\Money::class); // Use the MoneyPHP library
2useMoneyLibrary(\Brick\Money\Money::class); // Use the Brick Money library

Setting a default currency

If your application primarily uses a single currency, it can be annoying having to declare it as the second argument for each expectation. By setting a default, you can omit the currency and just provide the amount:

2expect($money)->toCost('100'); // Uses Great British Pounds
5expect($money)->toCost('100'); // Uses US Dollars

Next section: Mutation Testing Plugin →