Dev News Daily ENDE

Symfony 8.2: Callback-Regeln als Closure und BcMath-Vergleiche ohne Präzisionsverlust

Symfony 8.2 bringt eine Reihe von Änderungen an der Validator-Komponente, die Javier Eguiluz am 13. November im Symfony-Blog beschrieben hat, in derselben Woche, in der die zweite Beta von 8.2 erschien.

Die sichtbarste Änderung betrifft die Callback-Regel, den üblichen Weg für eigene Prüfungen. Sie erhält eine Option message. Ist sie gesetzt, muss der Callback nur einen Wahrheitswert zurückgeben, und Symfony erzeugt den Verstoß, wenn er false liefert. Zusammen mit PHP 8.5, das statische Closures in konstanten Ausdrücken erlaubt, passt die ganze Regel ins Attribut, etwa eine Closure, die prüft, ob ein Lieferdatum in der Zukunft liegt. Die Closure erhält dieselben Argumente wie bisher und erreicht das geprüfte Objekt weiterhin über den Ausführungskontext.

Die Option fields der Regel Unique, die Eindeutigkeit nur über einige Felder einer Sammlung prüft, funktionierte bisher nur bei Sammlungen von Arrays. In 8.2 geht das auch mit Objekten: Öffentliche Eigenschaften werden direkt gelesen, andere Werte über die PropertyAccess-Komponente, sodass auch Getter und Eigenschaftspfade funktionieren.

Auch Finanzcode wird bedacht. PHP 8.4 führte BcMath\Number für Arithmetik mit beliebiger Genauigkeit ein, und Range sowie die Vergleichsregeln (EqualTo, NotEqualTo, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual) akzeptieren nun solche Werte. Der Beitrag erklärt die Falle, die das vermeidet: Vergleicht man in PHP ein BcMath\Number mit einer Gleitkommazahl, wird diese auf eine ganze Zahl gekürzt, sodass new Number('10.2') > 10.5 wahr ist. Symfony wandelt die Grenzen deshalb vor dem Vergleich in BcMath\Number um.

In eigenen Validatoren akzeptierte setParameter() bisher nur Strings, setParameters() dagegen alles. Jetzt nimmt es Strings, Ganzzahlen, Gleitkommazahlen, \Stringable und \DateTimeInterface, was zählt, wenn Übersetzungen Zahlen und Daten im ICU-Format formatieren. Gruppensequenzen können die eigene Gruppe der Klasse über ::class statt über einen Klassennamen als String angeben, und eine neue Option cascadeCurrentGroup lässt mit Valid markierte Objekte gegen die aktuelle Gruppe der Sequenz prüfen, nicht nur gegen Default. Auch die Option groups von Valid wird umgebaut, um zu trennen, wann ein verschachteltes Objekt geprüft wird und welche seiner Regeln laufen.

Symfony 8.2: Callback-Regeln als Closure und BcMath-Vergleiche ohne Präzisionsverlust
Symfony 8.2: Callback-Regeln als Closure und BcMath-Vergleiche ohne Präzisionsverlust — Dev News Daily

Warum es wichtig ist

Die Änderung bei BcMath\Number verhindert stille Fehler. Ein Validator, der eine exakte Dezimalzahl mit einer Gleitkommagrenze vergleicht, könnte einen Betrag knapp über dem Maximum akzeptieren, ohne dass es jemand merkt. Anwendungen, die Geldbeträge mit dem Präzisionstyp von PHP 8.4 prüfen, erhalten korrekte Vergleiche, ohne die Kürzungsregel kennen zu müssen.