Using an enum as a criteria value reached PDO as an object and failed with
"Object of class X could not be converted to string". Filtering by a state
column - the most natural thing to do with an enum-mapped property - was
impossible.
CriteriaCompiler now unwraps \BackedEnum both for a plain value and inside an
an IN list.
Covered by CriteriaCompilerEnumTest.
Repository::castDatabaseValue() called TypeCaster::cast() with the enum's
class name as the "type", so any row of a model declaring #[Enum] threw
"Cannot assign string to property X of type Y" the moment it was read.
Writes worked, which is why this survived 1.0.0: the select path is only
exercised on read.
castDatabaseValue() now delegates to TypeCaster::castEnum() when the
property declares one, and keeps the null passthrough. Covered by
EnumHydrationTest with a scalar value and a null.
Attribute-mapped Active Record ORM for MariaDB/MySQL over PDO.
- Attribute-driven metadata: TableName, PrimaryKey, AutoIncrement, Column,
Guarded, Ignore, Required, Enum, Nullable, Length, Precision, Unique,
UniqueGroup, Index, MaxLength.
- Relationship mapping: BelongsTo, HasOne, HasMany, BelongsToMany with
batched eager loading and a 3-level depth limit.
- Orm entry point with fromArray, fromPdo, fromEnv and nested transactions.
- Immutable Query with Cond operators and GroupCond grouping.
- Repository read and write API, pagination, and typed exception hierarchy.
- Declares PHP >=8.3; Mago and PHPStan pin the parser to 8.3.
- MIT license.