README

Decimal\Decimal type mapper for marekskopal/orm, powered by the ext-decimal PHP extension. Handles precise decimal arithmetic without floating-point rounding errors — ideal for monetary values and other exact numeric data.

Requirements

• PHP >= 8.4
• ext-decimal PHP extension
• marekskopal/orm ^1.0

Installation

composer require marekskopal/orm-decimal

The ext-decimal extension must be installed separately. See php-decimal.io for installation instructions.

Usage

Apply the #[ColumnDecimal] attribute to a Decimal property on your ORM entity. The precision and scale parameters map directly to the SQL DECIMAL(precision, scale) column type.

use Decimal\Decimal;
use MarekSkopal\ORM\Attribute\Entity;
use MarekSkopal\ORM\Decimal\Attribute\ColumnDecimal;

#[Entity]
class Product
{
    #[ColumnDecimal(precision: 8, scale: 2)]
    public Decimal $price;

    #[ColumnDecimal(precision: 10, scale: 4, nullable: true)]
    public ?Decimal $discount;
}

Parameters

How It Works

• ColumnDecimal — a PHP attribute that extends the ORM's Column attribute with Type::Decimal and registers DecimalMapper as its value handler.
• DecimalMapper — implements MapperInterface, converting database strings to Decimal\Decimal objects on read (mapToProperty) and back to strings on write (mapToColumn).

License

MIT — see LICENSE.