Forms and validation

Request values normally arrive as strings. CakePHP validates those values before the plugin converts them to Decimal objects during marshalling.

php

$orders = $this->fetchTable('Orders');
$order = $orders->patchEntity($order, $this->request->getData());

if (!$order->hasErrors()) {
    $orders->saveOrFail($order);
}

Keep your application's decimal, required-field and range validation. Conversion does not replace validation: invalid unlocalized input becomes null, and empty input also becomes null. A required database column can reject that value later.

If passing a Decimal object into validated entity data, cast it first so validators receive their usual input:

php

$data['total'] = (string)$total;
$order = $orders->patchEntity($order, $data);

Locale parsing is optional; see Configuration. Your validators must accept the input notation too. Enabling conversion does not make a canonical-decimal validator accept commas or grouping separators. With locale parsing enabled, canonical strings can be rejected or misinterpreted: 19.90 is invalid German grouping and returns null, while 1.234 means 1234 under de_DE. The object-to-string example above is for the default parser; use separate conversion paths for canonical and localized data.

With locale parsing enabled, use text fields and display editable values in the active locale. HTML number inputs submit canonical dot decimals, so use the default parser for those fields.

Changing the type does not add entity property annotations. If you use IdeHelper, add a type map to your application configuration:

php

return [
    'IdeHelper' => [
        'typeMap' => [
            'decimal' => '\\PhpCollective\\DecimalObject\\Decimal',
        ],
    ],
];

Use decimal_object as the key when mapping selected columns under that alias.

Forms and validation ​

Forms and validation