Osumi Framework
es en eu v9.12.1 GitHub

Migrazio-gida: 9.10.2 → 9.11.0

Osumi Framework 9.11.0 bertsioak SQL DECIMAL(p,s) zutabeentzako ORM euskarri natiboa gehitzen du.

Eguneraketa atzerantz bateragarria da eta dauden modelo-definizioek ez dute aldaketarik behar.

DECIMAL euskarria

DECIMAL eremuek OField::DECIMAL eta PHP ?string propietateak erabiltzen dituzte.

#[OField(
	type: OField::DECIMAL,
	precision: 12,
	scale: 2,
	nullable: false
)]
public ?string $amount = null;

string erabiltzeak bitarteko puntu mugikorreko bihurketak saihesten ditu eta balio hamartar zehatza mantentzen du.

float eta int balioak ez dira baliozkoak DECIMAL eremuetarako.

Lehenetsitako precision 10 da eta lehenetsitako scale 2. Gehieneko precision 65 da eta gehieneko scale 30.

. eta , onartzen dira sarrerako bereizle hamartar gisa. ORM-ak beti . eta scale finkoa erabiliz normalizatzen ditu balioak:

"12"   → "12.00"
"12.5" → "12.50"
"12,5" → "12.50"

ORM-ak ez du biribiltze automatikorik egiten. Konfiguratutako precision edo scale gainditzen duten balioak baztertzen dira.

OField::DECIMAL ezin da #[OPK] eremuetan erabili.

Kontsultak

where() eta count() metodoei emandako baldintzak modeloaren eskemaren arabera balidatu eta normalizatzen dira orain.

Adibidez, DECIMAL(12,2) eremu baterako:

Payment::where([
	'amount' => '12,5'
]);

barnean "12.50" balioa erabiltzen da.

Eremu bererako puntu mugikorreko balioa baztertzen da:

Payment::where([
	'amount' => 12.5
]);

Modeloan existitzen ez diren eremuak aipatzen dituzten baldintzak ere baztertzen dira.

Sortzaileak

generateModel, generateModelFrom eta generateModelFromDB tresnek DECIMAL eremuak onartzen dituzte.

generateModelFromDB tresnak precision, scale eta balio lehenetsi hamartarrak kate zehatz gisa mantentzen ditu.

PHP 8.5 bateragarritasuna

ORM eskemaren hasieratzeak ReflectionProperty::hasDefaultValue() egiaztatzen du orain ReflectionProperty::getDefaultValue() deitu aurretik, balio lehenetsi espliziturik gabeko propietateen PHP 8.5 deprecation abisua saihesteko.

Migrazioa

Bertsio honek ez du migrazio automatikoko urratsik.

OField::DECIMAL erabiltzen ez duten proiektu existenteek ez dute modelorik aldatu behar.

DECIMAL erabiltzen hasten diren aplikazioek balio horiek kate zehatz gisa irudikatu behar dituzte eta float motara bihurtzea saihestu.